DwmShowContact, fonction (dwmapi.h)

Article
08/14/2024

Appelé par une application ou une infrastructure pour spécifier le type de commentaires visuels à dessiner en réponse à un contact tactile ou de stylet particulier.

Syntaxe

HRESULT DwmShowContact(
  [in] DWORD           dwPointerID,
  [in] DWM_SHOWCONTACT eShowContact
);

Paramètres

[in] dwPointerID

ID de pointeur du contact. Chaque contact tactile ou stylet reçoit un ID unique lorsqu’il est détecté.

[in] eShowContact

Une ou plusieurs des visualisations suivantes DWM_SHOWCONTACT que DWM doit afficher pour ce contact.

DWMSC_NONE (0x00000000)

Aucun retour visuel ne doit être affiché en réponse au contact.

DWMSC_DOWN (0x00000001)

Affichez l’animation « contact vers le bas », telle qu’elle serait utilisée dans une pression de bouton.

DWMSC_UP (0x00000002)

Affichez l’animation « contact vers le haut », telle qu’elle serait utilisée dans une mise en production de bouton.

DWMSC_DRAG (0x00000004)

Affichez l’animation « glisser contact » lorsque l’élément d’interface utilisateur sélectionné par le stylet tactile ou le stylet est déplacé.

DWMSC_HOLD (0x00000008)

Affichez un visuel pendant que le contact est enfoncé, par exemple en maintenant un bouton enfoncé.

DWMSC_PENBARREL (0x00000010)

Affichez le visuel du baril de stylet lorsque le bouton de baril de stylet est enfoncé.

DWMSC_ALL (0xFFFFFFFF)

Afficher l’une des animations si elle est appelée.

Valeur de retour

Si dwPointerID ne correspond pas à celui d’un contact actuellement présent à l’écran, cette fonction retourne E_INVALIDARG ; sinon, elle retourne S_OK.

Remarques

Il est sûr d’appeler cette fonction sur le thread d’interface utilisateur.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8 [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2012 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	dwmapi.h
bibliothèque	Dwmapi.lib
DLL	Dwmapi.dll

Partager via