InkOverlay.Tablet-Eigenschaft

Artikel
10/28/2008

Ruft das Tablettgerät ab, mit dem das InkOverlay-Objekt aktuell Eingaben erfasst.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
<BrowsableAttribute(False)> _
Public ReadOnly Property Tablet As Tablet
'Usage
Dim instance As InkOverlay
Dim value As Tablet

value = instance.Tablet

[BrowsableAttribute(false)]
public Tablet Tablet { get; }

[BrowsableAttribute(false)]
public:
property Tablet^ Tablet {
    Tablet^ get ();
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Tablet get_Tablet()

public function get Tablet () : Tablet

Eigenschaftenwert

Typ: Microsoft.Ink.Tablet
Das Tablettgerät, mit dem das InkOverlay-Objekt aktuell Eingaben erfasst.

Hinweise

Hinweis

Diese Eigenschaft ist nur gültig, wenn das InkOverlay-Objekt Freihandeingaben von nur einem Tablett erfasst. Wird auf diese Eigenschaft bei einem InkOverlay-Objekt zugegriffen, das Freihandeingaben von mehr als einem Tablett erfasst, wird eine Ausnahme generiert.

Beispiele

In diesem Beispiel wird ein Bericht über die Eigenschaften des Tablet-Objekts zurückgegeben, auf die das InkOverlay-Objekt mInkObject verweist.

Public Function InkObjectTabletReport() As String
    Dim Result As StringBuilder = New StringBuilder(512)
    ' Wrap access to the Tablet object in a try/catch block. 
    ' If mInkObject is in All Tablets mode, an exception will be 
    ' thrown when accessing the Tablet property.
    Try
        Result.AppendLine("The tablet associated mInkObject has the following properties:")
        ' accessing mInkObject.Tablet will throw an exception if in All Tablets mode
        ' mInkObject can be InkCollector, InkOverlay, or InkPicture
        Dim mTablet As Tablet = mInkObject.Tablet
        Result.AppendLine("Tablet Name: " + mTablet.Name)
        Result.AppendLine("Tablet PNP ID: " + mTablet.PlugAndPlayId)
        Result.AppendLine("Tablet Max Rect: " + mTablet.MaximumInputRectangle.ToString())
        Result.AppendLine("Tablet Capabilities: " + mTablet.HardwareCapabilities)

    Catch ex As System.Exception
        Result.AppendLine("mInkObject is in all tablets mode.")
        Result.AppendLine("The tablet report cannot be generated.")
    End Try

    Return Result.ToString()
End Function

public string InkObjectTabletReport()
{
    StringBuilder Result = new StringBuilder(512);

    // Wrap access to the Tablet object in a try/catch block. 
    // If mInkObject is in All Tablets mode, an exception will be 
    // thrown when accessing the Tablet property.
    try
    {
        Result.AppendLine("The  tablet associated with mInkObject has the following properties:");
        // accessing mInkObject.Tablet will throw an exception if in All Tablets mode
        // mInkObject can be InkCollector, InkOverlay, or InkPicture
        Tablet mTablet = mInkObject.Tablet;
        Result.AppendLine("Tablet Name: " + mTablet.Name);
        Result.AppendLine("Tablet PNP ID: " + mTablet.PlugAndPlayId);
        Result.AppendLine("Tablet Max Rect: " + mTablet.MaximumInputRectangle.ToString());
        Result.AppendLine("Tablet Capabilities: " + mTablet.HardwareCapabilities);
    }
    catch (System.Exception)
    {
        Result.AppendLine("mInkObject is in all tablets mode.");
        Result.AppendLine("The tablet report cannot be generated.");
    }

    return Result.ToString();
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.