Tablet.HardwareCapabilities-Eigenschaft

Artikel
10/28/2008

Ruft einen Wert aus der TabletHardwareCapabilities-Enumeration ab, die die Hardwarefunktionen des Tablet-Objekts definiert.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public ReadOnly Property HardwareCapabilities As TabletHardwareCapabilities
'Usage
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

Eigenschaftenwert

Typ: Microsoft.Ink.TabletHardwareCapabilities
Die Hardwarefunktionen des Tablet-Objekts.

Hinweise

Zu den Hardwarefunktionen eines Tablet-Objekts gehören Informationen darüber, ob ein Cursor in physischem Kontakt mit dem Tablett sein muss, um seine Position zu melden, und ob das Digitalisierungsgerät in die Anzeige integriert ist. Verwenden Sie einen bitweisen Vergleich, um festzustellen, welche Hardwarefunktionen für ein bestimmtes Tablet-Objekt verfügbar sind. Eine vollständige Liste der Werte für Hardwarefunktionen finden Sie in den Informationen zum TabletHardwareCapabilities-Enumerationstyp.

Hinweis

Diese Funktion kann rekursiv ausgeführt werden, wenn sie in bestimmten Meldungshandlern aufgerufen wird, und unerwartete Ergebnisse verursachen. Vermeiden Sie unbedingt den wieder eintretenden Aufruf, wenn Sie eine der folgenden Meldungen behandeln: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT sowie WM_SYSCOMMAND, wenn wParam auf SC_HOTKEY oder SC_TASKLIST festgelegt ist, und WM_SYSKEYDOWN (wenn die Tastenkombinationen ALT+TAB oder ALT+ESC verarbeitet werden). Dieses Problem tritt bei Anwendungen des Singlethread-Apartment-Modells auf.

Beispiele

In diesem Beispiel wird ein Bericht über die Plug & Play-ID, die Hardwarefunktionen und das maximale Eingaberechteck des Tablet-Objekts in der Tablets-Auflistung erstellt.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.