DwmShowContact 函式 （dwmapi.h）

由應用程式或架構呼叫，以指定要繪製以回應特定觸控或手寫筆聯繫人的視覺意見反應類型。

語法

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

參數

[in] dwPointerID

聯繫人的指標標識碼。 偵測到觸控或手寫筆聯繫人時，會提供唯一標識碼。

[in] eShowContact

下列一或多個DWM_SHOWCONTACT DWM 應該針對此聯繫人顯示的視覺效果。

DWMSC_NONE （0x00000000）

回應聯繫人時，不應顯示任何視覺意見反應。

DWMSC_DOWN （0x00000001）

顯示 「連絡向下」動畫，例如會在按下按鈕時使用。

DWMSC_UP （0x00000002）

顯示「連絡」動畫，例如會在按鈕發行中使用。

DWMSC_DRAG（0x00000004）

當觸控或畫筆選取的UI元素拖曳時，顯示「聯繫人拖曳」動畫。

DWMSC_HOLD （0x00000008）

在聯繫人按住時顯示視覺效果，例如按住按鈕。

DWMSC_PENBARREL （0x00000010）

按下手寫筆桶按鈕時，顯示畫筆桶視覺效果。

DWMSC_ALL （0xFFFFFFFF）

呼叫 時顯示任何動畫。

傳回值

如果 dwPointerID 不符合目前存在於螢幕上的連絡人，則此函式會傳回E_INVALIDARG;否則，它會傳回S_OK。

言論

在UI線程上呼叫此函式是安全的。

要求