Tablet.IsPacketPropertySupported (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve un valor que indica si un campo PacketProperty, reconocido mediante un identificador único global (GUID), es admitido por este objeto Tablet.

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

Sintaxis

'Declaración
Public Function IsPacketPropertySupported ( _
    id As Guid _
) As Boolean
'Uso
Dim instance As Tablet
Dim id As Guid
Dim returnValue As Boolean

returnValue = instance.IsPacketPropertySupported(id)

public bool IsPacketPropertySupported(
    Guid id
)

public:
bool IsPacketPropertySupported(
    Guid id
)

public boolean IsPacketPropertySupported(
    Guid id
)

public function IsPacketPropertySupported(
    id : Guid
) : boolean

Parámetros

id
Tipo: System.Guid
El identificador Guid del objeto PacketProperty que está comprobando.

Valor devuelto

Tipo: System.Boolean
Devuelve un valor que indica si un campo PacketProperty, reconocido mediante un identificador único global (GUID), es admitido por este objeto Tablet.

Valor	Significado
true	Este objeto Tablet admite el campo PacketProperty.
false	Este objeto Tablet no admite el campo PacketProperty.

Comentarios

Este método determina si un objeto Tablet admite varios campos de la clase PacketProperty.

Nota

Esta función puede introducirse de nuevo si se llama en determinados controladores de mensajes, lo cual causa resultados inesperados. Procure evitar que se produzca una llamada reentrante al controlar alguno de los siguientes mensajes WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam se establece en SC_HOTKEY o SC_TASKLIST y WM_SYSKEYDOWN (al procesar las combinaciones de teclas Alt-Tab o Alt-Esc). Este problema se produce con las aplicaciones del modelo de subprocesamiento controlado simple.

Ejemplos

Este ejemplo notifica qué campos PacketProperty están disponibles para el objeto Tablet el predeterminado de la colección Tablets.

Private Function Report_Properties_DefaultTablet() As String

    Dim SB As StringBuilder = New StringBuilder(1024)
    Dim defTablet As Tablet = New Tablets().DefaultTablet

    ' Generate a report on which PacketProperties are supported by the default tablet.
    SB.AppendLine("Packet Properties supported by the default tablet: " + defTablet.Name)

    If defTablet.IsPacketPropertySupported(PacketProperty.AltitudeOrientation) Then
        SB.AppendLine("AltitudeOrientation: YES")
    Else
        SB.AppendLine("AltitudeOrientation: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.AzimuthOrientation) Then
        SB.AppendLine("AzimuthOrientation: YES")
    Else
        SB.AppendLine("AzimuthOrientation: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.ButtonPressure) Then
        SB.AppendLine("ButtonPressure: YES")
    Else
        SB.AppendLine("ButtonPressure: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.NormalPressure) Then
        SB.AppendLine("NormalPressure: YES")
    Else
        SB.AppendLine("NormalPressure: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.PacketStatus) Then
        SB.AppendLine("PacketStatus: YES")
    Else
        SB.AppendLine("PacketStatus: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.PitchRotation) Then
        SB.AppendLine("PitchRotation: YES")
    Else
        SB.AppendLine("PitchRotation: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.RollRotation) Then
        SB.AppendLine("RollRotation: YES")
    Else
        SB.AppendLine("RollRotation: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.SerialNumber) Then
        SB.AppendLine("SerialNumber: YES")
    Else
        SB.AppendLine("SerialNumber: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.TangentPressure) Then
        SB.AppendLine("TangentPressure: YES")
    Else
        SB.AppendLine("TangentPressure: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.TimerTick) Then
        SB.AppendLine("TimerTick: YES")
    Else
        SB.AppendLine("TimerTick: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.TwistOrientation) Then
        SB.AppendLine("TwistOrientation: YES")
    Else
        SB.AppendLine("TwistOrientation: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.X) Then
        SB.AppendLine("X: YES")
    Else
        SB.AppendLine("X: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.XTiltOrientation) Then
        SB.AppendLine("XTiltOrientation: YES")
    Else
        SB.AppendLine("XTiltOrientation: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.Y) Then
        SB.AppendLine("Y: YES")
    Else
        SB.AppendLine("Y: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.YawRotation) Then
        SB.AppendLine("YawRotation: YES")
    Else
        SB.AppendLine("YawRotation: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.YTiltOrientation) Then
        SB.AppendLine("YTiltOrientation: YES")
    Else
        SB.AppendLine("YTiltOrientation: NO")
    End If

    If defTablet.IsPacketPropertySupported(PacketProperty.Z) Then
        SB.AppendLine("Z: YES")
    Else
        SB.AppendLine("Z: NO")
    End If

    Return SB.ToString

End Function

public string Report_Properties_DefaultTablet()
{
    StringBuilder SB = new StringBuilder(1024);

    Tablet defTablet = new Tablets().DefaultTablet;
    // Generate a report on which PacketProperties are supported by the default tablet.
    SB.AppendLine("Packet Properties supported by the default tablet: " + defTablet.Name);
    SB.AppendLine("AltitudeOrientation: " + ((defTablet.IsPacketPropertySupported(PacketProperty.AltitudeOrientation)) ? "YES" : "NO"));
    SB.AppendLine("AzimuthOrientation: " + ((defTablet.IsPacketPropertySupported(PacketProperty.AzimuthOrientation)) ? "YES" : "NO"));
    SB.AppendLine("ButtonPressure: " + ((defTablet.IsPacketPropertySupported(PacketProperty.ButtonPressure)) ? "YES" : "NO"));
    SB.AppendLine("NormalPressure: " + ((defTablet.IsPacketPropertySupported(PacketProperty.NormalPressure)) ? "YES" : "NO"));
    SB.AppendLine("PacketStatus: " + ((defTablet.IsPacketPropertySupported(PacketProperty.PacketStatus)) ? "YES" : "NO"));
    SB.AppendLine("PitchRotation: " + ((defTablet.IsPacketPropertySupported(PacketProperty.PitchRotation)) ? "YES" : "NO"));
    SB.AppendLine("RollRotation: " + ((defTablet.IsPacketPropertySupported(PacketProperty.RollRotation)) ? "YES" : "NO"));
    SB.AppendLine("SerialNumber: " + ((defTablet.IsPacketPropertySupported(PacketProperty.SerialNumber)) ? "YES" : "NO"));
    SB.AppendLine("TangentPressure: " + ((defTablet.IsPacketPropertySupported(PacketProperty.TangentPressure)) ? "YES" : "NO"));
    SB.AppendLine("TimerTick: " + ((defTablet.IsPacketPropertySupported(PacketProperty.TimerTick)) ? "YES" : "NO"));
    SB.AppendLine("TwistOrientation: " + ((defTablet.IsPacketPropertySupported(PacketProperty.TwistOrientation)) ? "YES" : "NO"));
    SB.AppendLine("X: " + ((defTablet.IsPacketPropertySupported(PacketProperty.X)) ? "YES" : "NO"));
    SB.AppendLine("XTiltOrientation: " + ((defTablet.IsPacketPropertySupported(PacketProperty.XTiltOrientation)) ? "YES" : "NO"));
    SB.AppendLine("Y: " + ((defTablet.IsPacketPropertySupported(PacketProperty.Y)) ? "YES" : "NO"));
    SB.AppendLine("YawRotation: " + ((defTablet.IsPacketPropertySupported(PacketProperty.YawRotation)) ? "YES" : "NO"));
    SB.AppendLine("YTiltOrientation: " + ((defTablet.IsPacketPropertySupported(PacketProperty.YTiltOrientation)) ? "YES" : "NO"));
    SB.AppendLine("Z: " + ((defTablet.IsPacketPropertySupported(PacketProperty.Z)) ? "YES" : "NO"));
    return SB.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.