InkCollector.Tablet, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient le périphérique de tablette que l'objet InkCollector utilise actuellement pour collecter les saisies.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property Tablet As Tablet
'Utilisation
Dim instance As InkCollector
Dim value As Tablet

value = instance.Tablet

public Tablet Tablet { get; }

public:
property Tablet^ Tablet {
    Tablet^ get ();
}

/** @property */
public Tablet get_Tablet()

public function get Tablet () : Tablet

Valeur de propriété

Type : Microsoft.Ink.Tablet
Périphérique de tablette que l'objet InkCollector utilise actuellement pour collecter les saisies.

Notes

Remarque :
Cette propriété est valide uniquement lorsque le InkCollector collecte l'entrée manuscrite d'une seule tablette. L'accès à cette propriété pour un InkCollector qui collecte l'entrée manuscrite de plusieurs tablettes génère une exception.

Exemples

Cet exemple retourne un rapport sur les propriétés de l'objet Tablet référencé par l'objet InkCollector, mInkObject.

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();
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.