InkPicture.Tablet (Propiedad)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene el dispositivo de Tablet PC que el control InkPicture está utilizando actualmente para recopilar la entrada.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
<BrowsableAttribute(False)> _
Public ReadOnly Property Tablet As Tablet
'Uso
Dim instance As InkPicture
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

Valor de propiedad

Tipo: Microsoft.Ink.Tablet
Dispositivo de Tablet PC que está utilizando actualmente el control InkPicture para recopilar la entrada.

Comentarios

Nota

Esta propiedad sólo es válida cuando el control InkPicture está recopilando entrada manuscrita sólo de un Tablet PC. Si se tiene acceso a esta propiedad de un control InkPicture que está recopilando entrada manuscrita de todos los Tablet PC se genera una excepción.

Ejemplos

En este ejemplo se devuelve un informe sobre las propiedades del objeto Tablet al que hace referencia el objeto InkPicture, 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();
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.