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

Spécifie une association entre un contact et la fenêtre d’affichage.

Syntaxe

HRESULT SetContact(
  [in] UINT32 pointerId
);

Paramètres

[in] pointerId

ID du pointeur.

Valeur retournée

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

Notes

Appelez cette méthode lorsqu’un message WM_POINTERDOWN est reçu. Lors de la réception d’un WM_POINTERDOWN, l’application peut utiliser les coordonnées de l’entrée pour tester et déterminer les fenêtres d’affichage auxquelles le contact est associé.

DeferContact doit être appelé avant SetContact.

Après l’initialisation, La manipulation directe n’est pas consciente des relations entre les fenêtres d’affichage ou les relations parent-enfant entre les fenêtres d’affichage. L’ordre des appels SetContact définit l’arborescence de la fenêtre d’affichage. Pour établir la hiérarchie de la fenêtre d’affichage correcte, SetContact doit être appelé en premier sur la fenêtre d’affichage la plus enfant, suivie du parent, du grand-parent, etc.

Utilisez GET_POINTERID_WPARAM pour obtenir l’identificateur de pointeur à partir d’un message de pointeur. Le contact est supprimé automatiquement lorsque WM_POINTERUP est reçu.

Si un contact est associé à une ou plusieurs fenêtres d’affichage à l’aide de la méthode SetContact , Direct Manipulation examine d’autres entrées de ce contact et tente d’identifier une manipulation appropriée en fonction de la configuration des fenêtres d’affichage associées. Si une manipulation est reconnue, l’application reçoit alors un message WM_POINTERCAPTURECHANGED pour ce contact. Dans ce contexte, le message WM_POINTERCAPTURECHANGED indique que La manipulation directe a capturé le contact et que l’application ne recevra pas d’entrée de ce contact consommée pour cette manipulation.

Spécifications

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

Messages et notifications d’entrée utilisateur