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 |