Tablet.HardwareCapabilities, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient une valeur de l'énumération TabletHardwareCapabilities qui définit les capacités matérielles de l'objet Tablet.

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

Syntaxe

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

value = instance.HardwareCapabilities

public TabletHardwareCapabilities HardwareCapabilities { get; }

public:
property TabletHardwareCapabilities HardwareCapabilities {
    TabletHardwareCapabilities get ();
}

/** @property */
public TabletHardwareCapabilities get_HardwareCapabilities()

public function get HardwareCapabilities () : TabletHardwareCapabilities

Valeur de propriété

Type : Microsoft.Ink.TabletHardwareCapabilities
Capacités matérielles de l'objet Tablet.

Notes

Les capacités matérielles d'un objet Tablet spécifient si un curseur doit être en contact physique avec la tablette pour signaler sa position et si le digitaliseur est intégré à l'affichage. Utilisez une comparaison de bits pour déterminer quelles capacités matérielles sont disponibles pour un objet Tablet donné. Pour obtenir la liste complète des valeurs de capacités matérielles, consultez le type énumération TabletHardwareCapabilities.

Remarque :
Cette fonction peut être exécutée à nouveau si elle est appelée dans certains gestionnaires de messages et provoquer des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Cette fonction peut être exécutée à nouveau si elle est appelée dans certains gestionnaires de messages et provoquer des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Exemples

Cet exemple génère un rapport sur l'ID Plug and Play, les capacités matérielles et le rectangle de saisie maximal de l'objet Tablet par défaut dans la collection Tablets.

Public Function Report_Hardware_DefaultTablet() As String
    Dim SB As StringBuilder = New StringBuilder(1024)
    Dim defTablet As Tablet = New Tablets().DefaultTablet

    ' report on the hardware capabilities of the default tablet
    SB.AppendLine("Hardware capabilities of the default tablet: " + defTablet.Name)
    SB.AppendLine("PlugAndPlayId: " + defTablet.PlugAndPlayId)

    If (defTablet.HardwareCapabilities And TabletHardwareCapabilities.CursorMustTouch) <> 0 Then
        SB.AppendLine("CursorMustTouch: YES")
    Else
        SB.AppendLine("CursorMustTouch: NO")
    End If

    If (defTablet.HardwareCapabilities And TabletHardwareCapabilities.CursorsHavePhysicalIds) <> 0 Then
        SB.AppendLine("CursorsHavePhysicalIds: YES")
    Else
        SB.AppendLine("CursorsHavePhysicalIds: NO")
    End If

    If (defTablet.HardwareCapabilities And TabletHardwareCapabilities.HardProximity) <> 0 Then
        SB.AppendLine("HardProximity:: YES")
    Else
        SB.AppendLine("HardProximity:: NO")
    End If

    If (defTablet.HardwareCapabilities And TabletHardwareCapabilities.Integrated) <> 0 Then
        SB.AppendLine("Integrated: YES")
    Else
        SB.AppendLine("Integrated: NO")
    End If

    SB.AppendLine("MaximumInputRectangle " + defTablet.MaximumInputRectangle.ToString())

    Return SB.ToString()
End Function

public string Report_Hardware_DefaultTablet()
{
    StringBuilder SB = new StringBuilder(1024);
    Tablet defTablet = new Tablets().DefaultTablet;

    // report on the hardware capabilities of the default tablet
    SB.AppendLine("Hardware capabilities of the default tablet: " + defTablet.Name);
    SB.AppendLine("PlugAndPlayId: " + defTablet.PlugAndPlayId);

    SB.AppendLine("CursorMustTouch: " +
        (((defTablet.HardwareCapabilities & TabletHardwareCapabilities.CursorMustTouch) != 0) ? "YES" : "NO"));

    SB.AppendLine("CursorsHavePhysicalIds: " +
        (((defTablet.HardwareCapabilities & TabletHardwareCapabilities.CursorsHavePhysicalIds) != 0) ? "YES" : "NO"));

    SB.AppendLine("HardProximity: " +
        (((defTablet.HardwareCapabilities & TabletHardwareCapabilities.HardProximity) != 0) ? "YES" : "NO"));

    SB.AppendLine("Integrated: " +
        (((defTablet.HardwareCapabilities & TabletHardwareCapabilities.Integrated) != 0) ? "YES" : "NO"));

    SB.AppendLine("MaximumInputRectangle " + defTablet.MaximumInputRectangle.ToString());

    return SB.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.