Funzione DwmShowContact (dwmapi.h)

Articolo
08/02/2024

Chiamato da un'app o da un framework per specificare il tipo di feedback visivo da disegnare in risposta a un particolare contatto tocco o penna.

Sintassi

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

Parametri

[in] dwPointerID

ID puntatore del contatto. A ogni contatto tocco o penna viene assegnato un ID univoco quando viene rilevato.

[in] eShowContact

Una o più delle visualizzazioni DWM_SHOWCONTACT seguenti che DWM deve mostrare per questo contatto.

DWMSC_NONE (0x00000000)

Non deve essere visualizzato alcun feedback visivo in risposta al contatto.

DWMSC_DOWN (0x00000001)

Mostra l'animazione "contact down", ad esempio viene usata in una pressione di un pulsante.

DWMSC_UP (0x00000002)

Mostra l'animazione "contact up", ad esempio viene usata in una versione pulsante.

DWMSC_DRAG (0x00000004)

Mostra l'animazione di trascinamento del contatto quando l'elemento dell'interfaccia utente selezionato dal tocco o dalla penna viene trascinato.

DWMSC_HOLD (0x00000008)

Mostra un oggetto visivo mentre il contatto è premuto, ad esempio tenendo premuto un pulsante.

DWMSC_PENBARREL (0x00000010)

Mostra l'oggetto visivo del barile della penna quando viene premuto il pulsante della penna.

DWMSC_ALL (0xFFFFFFFF)

Mostra una qualsiasi delle animazioni se viene chiamato per.

Valore restituito

Se dwPointerID non corrisponde a quello di un contatto attualmente presente sullo schermo, questa funzione restituisce E_INVALIDARG; in caso contrario, restituisce S_OK.

Osservazioni

È sicuro chiamare questa funzione nel thread dell'interfaccia utente.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8 [solo app desktop]
server minimo supportato	Windows Server 2012 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	dwmapi.h
libreria	Dwmapi.lib
dll	Dwmapi.dll

Condividi tramite