Méthode IDirectManipulationViewport ::SetInputMode (directmanipulation.h)

Article
03/02/2024

Spécifie si l’entrée est visible par le thread d’interface utilisateur.

Syntaxe

HRESULT SetInputMode(
  [in] DIRECTMANIPULATION_INPUT_MODE mode
);

Paramètres

[in] mode

Une des valeurs de DIRECTMANIPULATION_INPUT_MODE.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC est le mode par défaut pour la manipulation directe.

La manipulation directe consomme toutes les entrées qui pilotent la manipulation et l’application reçoit WM_POINTERCAPTURECHANGED messages.

Dans certaines situations, une application peut souhaiter recevoir une entrée qui entraîne une manipulation. Définissez DIRECTMANIPULATION_INPUT_MODE_MANUAL dans ce cas. L’application recevra tous les messages d’entrée, même les entrées utilisées par La manipulation directe pour piloter une manipulation.

Note L’application ne recevra pas de messages WM_POINTERCAPTURECHANGED.

L’appel de cette méthode avec DIRECTMANIPULATION_INPUT_MODE_MANUAL set est similaire à l’appel de SetViewportOptions(DIRECTMANIPULATION_VIEWPORT_OPTIONS_INPUT). Toutefois, l’appel de SetViewportOptions remplace également tous les autres paramètres.

Exemples

L’exemple suivant montre comment utiliser cette méthode.

HRESULT hr = pViewport->SetInputMode(DIRECTMANIPULATION_INPUT_MODE_AUTOMATIC);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	directmanipulation.h

Voir aussi

IDirectManipulationViewport

Partager via