DwmShowContact-Funktion (dwmapi.h)

Wird von einer App oder einem Framework aufgerufen, um den visuellen Feedbacktyp anzugeben, der als Reaktion auf einen bestimmten Touch- oder Stiftkontakt gezeichnet werden soll.

Syntax

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

Parameter

[in] dwPointerID

Die Zeiger-ID des Kontakts. Jeder Touch- oder Stiftkontakt erhält eine eindeutige ID, wenn er erkannt wird.

[in] eShowContact

Mindestens eine der folgenden DWM_SHOWCONTACT Visualisierungen, die DWM für diesen Kontakt anzeigen sollte.

DWMSC_NONE (0x00000000)

Als Reaktion auf den Kontakt sollte kein visuelles Feedback angezeigt werden.

DWMSC_DOWN (0x00000001)

Zeigen Sie die Animation "Kontakt nach unten" an, z. B. in einem Tastendruck.

DWMSC_UP (0x00000002)

Zeigen Sie die Animation "Kontakt nach oben" an, z. B. in einer Schaltflächenfreigabe.

DWMSC_DRAG (0x00000004)

Zeigen Sie die Animation "Kontaktziehen" an, wenn das benutzeroberflächenelement, das durch die Toucheingabe oder den Stift ausgewählt wurde, gezogen wird.

DWMSC_HOLD (0x00000008)

Zeigen Sie ein visuelles Element an, während der Kontakt gedrückt gehalten wird, z. B. eine Schaltfläche gedrückt halten.

DWMSC_PENBARREL (0x00000010)

Zeigen Sie das Zeichenstift barrel visuell an, wenn die Drucktaste des Stifts gedrückt wird.

DWMSC_ALL (0xFFFFFFFF)

Zeigen Sie eine der Animationen an, wenn sie aufgerufen werden.

Rückgabewert

Wenn dwPointerID- nicht mit dem eines Kontakts übereinstimmt, der aktuell auf dem Bildschirm vorhanden ist, gibt diese Funktion E_INVALIDARG zurück; andernfalls wird S_OK zurückgegeben.

Bemerkungen

Es ist sicher, diese Funktion im UI-Thread aufzurufen.

Anforderungen