IDirectManipulationViewport::SetInputMode-Methode (directmanipulation.h)

Gibt an, ob die Eingabe für den UI-Thread sichtbar ist.

Syntax

HRESULT SetInputMode(
  [in] DIRECTMANIPULATION_INPUT_MODE mode
);

Parameter

[in] mode

Einer der Werte aus DIRECTMANIPULATION_INPUT_MODE.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC ist der Standardmodus für direkte Bearbeitung.

Die direkte Bearbeitung verbraucht die gesamte Eingabe, die die Bearbeitung antreibt, und die Anwendung empfängt WM_POINTERCAPTURECHANGED Nachrichten.

In einigen Situationen möchte eine Anwendung möglicherweise Eingaben empfangen, die eine Manipulation antreibt. Legen Sie in diesem Fall DIRECTMANIPULATION_INPUT_MODE_MANUAL fest. Die Anwendung empfängt alle Eingabenachrichten, auch eingaben, die von direct manipulation verwendet werden, um eine Manipulation zu steuern.

Hinweis Die Anwendung empfängt keine WM_POINTERCAPTURECHANGED Nachrichten.

 

Das Aufrufen dieser Methode mit DIRECTMANIPULATION_INPUT_MODE_MANUAL Set ähnelt dem Aufrufen von SetViewportOptions(DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT). Durch das Aufrufen von SetViewportOptions werden jedoch auch alle anderen Einstellungen außer Kraft gesetzt.

Beispiele

Im folgenden Beispiel wird gezeigt, wie diese Methode verwendet wird.

HRESULT hr = pViewport->SetInputMode(DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC);

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	directmanipulation.h

Weitere Informationen

IDirectManipulationViewport