IDirectManipulationViewport：：SetInputMode 方法 (directmanipulation.h)

指定UI線程是否可以看到輸入。

語法

HRESULT SetInputMode(
  [in] DIRECTMANIPULATION_INPUT_MODE mode
);

[in] mode

DIRECTMANIPULATION_INPUT_MODE的其中一個值。

如果方法成功，則會傳回 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);