HasUsage | hasUsage メソッド

PointerPointProperties.HasUsage | hasUsage Method

ポインター デバイスからの入力データに、指定したヒューマン インターフェイス デバイス (HID) の使用情報が含まれているかどうかを示す値を取得します。

構文


var boolean = pointerPointProperties.hasUsage(usagePage, usageId);

パラメーター

usagePage

型: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

ポインター デバイスの HID 使用状況ページ。

利用状況ページはデバイス クラスを指定します。たとえば、タッチ デジタイザー (0x0D) や一般的な入力 (0x01) です。

usageId

型: Number [JavaScript] | System.UInt32 [.NET] | uint32 [C++]

利用状況ページの使用方法を示します。

利用状況 ID は usagePage のデバイスまたはプロパティを指定します。たとえば、タッチ デジタイザーの場合は、指接触を示すチップ スイッチ (0x42) や先端圧力 (0x30) が含まれます。

戻り値

型: Boolean [JavaScript] | System.Boolean [.NET] | Platform::Boolean [C++]

入力データが使用状況情報を含む場合は true。それ以外の場合は false。

解説

Microsoft の対話型入力デバイスのコアは、USB Implementers Forum, Inc. によって定義されている HID のユニバーサル シリアル バス (USB: Universal Serial Bus) 規格のデバイス クラスの定義に基づいています。

USB HID 規格は、キーボード、マウス デバイス、ジョイスティック、仮想現実デバイスなど、人間がコンピューターに直接データを入力するために使用する HID の構成および通信プロトコルを定義します。(USB HID 規格の詳細については、USB 実装フォーラムの Web サイトを参照してください。)

Windows の入力アーキテクチャのコアは USB HID 規格に基づいていますが、アーキテクチャは USB デバイスに制限されません。入力アーキテクチャは、シリアル ポート デバイス、i8042 ポート デバイス、および独自の入力デバイスもサポートします。

PointerPointPointerPointProperties は、共通の HID 使用状況を直接公開します。

追加のカスタム、デバイス固有の使用方法を照会するか、デバイスが実際にプロパティをサポートしていることを確認する必要がある場合 (PointerPointPointerPointProperties が既定値を返す場合) は、HasUsage を使用します。

PointerPoint および PointerPointProperties によって直接公開される HID 使用方法を次の表に一覧します。

プロパティ利用状況ページ使用法
Position (X) 0x010x30
Position (Y) 0x010x31
RawPosition (X) 0x010x30
RawPosition (Y) 0x010x31
IsInContact 0x0D0x42 (ヒント) または 0x45 (消しゴムのヒント)
Pressure 0x0D0x30
IsInverted 0x0D0x3C
IsEraser 0x0D0x45
Orientation 0x0D0x3F
XTilt 0x0D0x3D
YTilt 0x0D0x3E
Twist 0x0D0x41
ContactRect (Width) 0x0D0x48
ContactRect (Height) 0x0D0x49
ContactRectRaw (Width) 0x0D0x48
ContactRectRaw (Height) 0x0D0x49
TouchConfidence 0x0D0x47
IsInRange 0x0D0x32

 

Windows Phone 8

この API は実装されていません。呼び出された場合は、例外をスローします。「Windows Phone ランタイム API」を参照してください。

要件

最小限サポートされるクライアント

Windows 8

最小限サポートされるサーバー

Windows Server 2012

最小限サポートされる携帯電話

Windows Phone 8 [実装されていません。"解説" を参照してください]

名前空間

Windows.UI.Input
Windows::UI::Input [C++]

メタデータ

Windows.winmd

参照

PointerPointProperties
GetUsageValue
HID 情報

 

 

表示:
© 2017 Microsoft