Proprietà InkCollector.Tablet

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene il dispositivo del Tablet PC che l'oggetto InkCollector utilizza attualmente per raccogliere l'input.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public ReadOnly Property Tablet As Tablet
'Utilizzo
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

Valore proprietà

Tipo: Microsoft.Ink.Tablet
Dispositivo del Tablet PC che l'oggetto InkCollector utilizza attualmente per raccogliere l'input.

Note

Nota

Questa proprietà è valida solo quando l'oggetto InkCollector raccoglie l'input penna da una sola tavoletta. L'accesso a questa proprietà per un oggetto InkCollector che sta raccogliendo l'input penna da più di una tavoletta genera un'eccezione.

Esempi

In questo esempio viene restituito un report sulle proprietà dell'oggetto Tablet a cui fa riferimento l'oggetto 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();
}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.