DwmShowContact function
Called by an app or framework to specify the visual feedback type to draw in response to a particular touch or pen contact.
Syntax
DWMAPI DwmShowContact( DWORD dwPointerID, DWM_SHOWCONTACT eShowContact );
Parameters
- dwPointerID
-
The pointer ID of the contact. Each touch or pen contact is given a unique ID when it is detected.
- eShowContact
-
One or more of the following DWM_SHOWCONTACT visualizations that DWM should show for this contact.
-
No visual feedback should be shown in reponse to the contact.
-
Show the "contact down" animation, such as would be used in a button press.
-
Show the "contact up" animation, such as would be used in a button release.
-
Show the "contact drag" animation when the UI element that was selected by the touch or pen is dragged.
-
Show a visual while the contact is held down, such as holding down a button.
-
Show the pen barrel visual when the pen barrel button is pressed.
-
Show any of the animations if called for.
Return value
If dwPointerID does not match that of a contact currently present on the screen, this function returns E_INVALIDARG; otherwise, it returns S_OK.
Remarks
It is safe to call this function on the UI thread.
Requirements
|
Minimum supported client |
Windows 8 [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2012 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|