IDirectManipulationViewport::SetInputMode メソッド (directmanipulation.h)

  • [アーティクル]

UI スレッドに入力を表示するかどうかを指定します。

構文

HRESULT SetInputMode(
  [in] DIRECTMANIPULATION_INPUT_MODE mode
);

パラメーター

[in] mode

DIRECTMANIPULATION_INPUT_MODEの値の 1 つ。

戻り値

メソッドが成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

DIRECTMANIPULATION_INPUT_MODE_AUTOMATICは、 直接操作の既定のモードです。

直接操作では、操作 を駆動するすべての入力が使用され、アプリケーションはWM_POINTERCAPTURECHANGEDメッセージを受信します。

状況によっては、アプリケーションが操作を推進している入力を受け取る必要がある場合があります。 この場合DIRECTMANIPULATION_INPUT_MODE_MANUALを設定します。 アプリケーションは、 直接操作によって操作 を実行するために使用される入力であっても、すべての入力メッセージを受信します。

メモ アプリケーションは、WM_POINTERCAPTURECHANGEDメッセージを受信しません。
 
set でこのメソッドDIRECTMANIPULATION_INPUT_MODE_MANUAL呼び出すことは、SetViewportOptions(DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT) の呼び出しと似ています。 ただし、 SetViewportOptions を 呼び出すと、他のすべての設定もオーバーライドされます。

例

次の例は、このメソッドの使用方法を示しています。

HRESULT hr = pViewport->SetInputMode(DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC);

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー directmanipulation.h

こちらもご覧ください

IDirectManipulationViewport