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

入力イベント中ではなく、ビューポートがコンテンツを手動で更新するかどうかを指定します。

構文

HRESULT SetUpdateMode(
  [in] DIRECTMANIPULATION_INPUT_MODE mode
);

パラメーター

[in] mode

DIRECTMANIPULATION_INPUT_MODEの値の 1 つ。

戻り値

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

解説

DIRECTMANIPULATION_INPUT_MODE_AUTOMATICは、 直接操作の既定のモードです。 このモードでは、ビジュアルの更新が入力によって駆動されるコンポジターにプッシュされます。 これは、アプリケーションが IDirectManipulationCompositor のシステム提供の実装を使用している場合に想定される操作モードです。

アプリケーションが IDirectManipulationCompositor の独自の実装を提供する場合は、DIRECTMANIPULATION_INPUT_MODE_MANUALを設定してビューポートの更新モードを手動に切り替える必要があります。 手動モードの場合、コンポジターは、直接操作時に Update を呼び出すたびにビジュアル更新をプルします。

set でこのメソッド DIRECTMANIPULATION_INPUT_MODE_MANUAL 呼び出すことは 、SetViewportOptions(DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT) の呼び出しに似ています。 ただし、 SetViewportOptions を呼び出すと、他のすべての設定もオーバーライドされます。

要件

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

関連項目

IDirectManipulationViewport