Tablet.HardwareCapabilities プロパティ

[アーティクル]
10/28/2008

Tablet オブジェクトのハードウェア機能を定義する値を、TabletHardwareCapabilities 列挙体から取得します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public ReadOnly Property HardwareCapabilities As TabletHardwareCapabilities
'使用
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

プロパティ値

型 : Microsoft.Ink.TabletHardwareCapabilities
Tablet オブジェクトのハードウェア機能。

解説

Tablet オブジェクトのハードウェア機能には、カーソルの位置が認識されるためにカーソルがタブレットと物理的に接触する必要があるかどうかと、デジタイザがディスプレイと統合されているかどうかが含まれます。特定の Tablet オブジェクトに対して使用可能なハードウェア機能がどれかを調べるには、ビット単位の比較を使用します。ハードウェア機能の値の完全な一覧については、TabletHardwareCapabilities 列挙体を参照してください。

メモ :
この関数は、特定のメッセージハンドラ内で呼び出された場合に再入力されることがあり、予期しない結果が生じる可能性があります。WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT、wParam が SC_HOTKEY または SC_TASKLIST に設定されている場合のWM_SYSCOMMAND および WM_SYSKEYDOWN (Alt-Tab キーまたは Alt-Esc キーの組み合わせで処理される場合) のいずれかのメッセージを処理するときは、再入呼び出しを回避するように注意してください。これはシングルスレッドアパートメントモデルアプリケーションに関する問題です。

この関数は、特定のメッセージハンドラ内で呼び出された場合に再入力されることがあり、予期しない結果が生じる可能性があります。WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT、wParam が SC_HOTKEY または SC_TASKLIST に設定されている場合のWM_SYSCOMMAND および WM_SYSKEYDOWN (Alt-Tab キーまたは Alt-Esc キーの組み合わせで処理される場合) のいずれかのメッセージを処理するときは、再入呼び出しを回避するように注意してください。これはシングルスレッドアパートメントモデルアプリケーションに関する問題です。

例

この例では、Tablets コレクションの既定の Tablet オブジェクトのプラグアンドプレイ ID、ハードウェア機能および最大の入力四角形について報告します。

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