Функция DwmShowContact (dwmapi.h)

Статья
08/02/2024

Вызывается приложением или платформой, чтобы указать тип визуальной обратной связи для рисования в ответ на конкретный контакт касания или пера.

Синтаксис

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)

Отображение анимации "перетаскивание контакта" при перетаскивании элемента пользовательского интерфейса, выбранного сенсорным элементом или пером.

DWMSC_HOLD (0x00000008)

Показать визуальный элемент во время удержания контакта, например удерживая кнопку.

DWMSC_PENBARREL (0x00000010)

Отображение визуального элемента пера при нажатии кнопки пера.

DWMSC_ALL (0xFFFFFFFF)

Отображение любой анимации при вызове.

Возвращаемое значение

Если dwPointerID не совпадает с данным контактом, присутствующих на экране, эта функция возвращает E_INVALIDARG; в противном случае возвращается S_OK.

Замечания

Это безопасно для вызова этой функции в потоке пользовательского интерфейса.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2012 [только классические приложения]
целевая платформа	Виндоус
заголовка	dwmapi.h
библиотеки	Dwmapi.lib
DLL	Dwmapi.dll

Поделиться через