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

Функция HitTestThemeBackground (uxtheme.h)

  • Статья

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

Синтаксис

HRESULT HitTestThemeBackground(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  DWORD   dwOptions,
  [in]  LPCRECT pRect,
  [in]  HRGN    hrgn,
  [in]  POINT   ptTest,
  [out] WORD    *pwHitTestCode
);

Параметры

[in] hTheme

Тип: HTHEME

Обработка данных указанной темы окна. Используйте OpenThemeData для создания HTHEME.

[in] hdc

Тип: HDC

HDC для использования при рисовании. Для этого параметра может быть задано значение NULL.

[in] iPartId

Тип: int

Значение типа int , указывающее часть. См . раздел Части и состояния.

[in] iStateId

Тип: int

Значение типа int , указывающее состояние части. См . раздел Части и состояния.

[in] dwOptions

Тип: DWORD

DWORD , указывающий параметры проверки нажатия. Список параметров см. в разделе Параметры проверки нажатия .

[in] pRect

Тип: LPCRECT

Указатель на структуру RECT , содержащую в логических координатах прямоугольник, ограничивающий фон.

[in] hrgn

Тип: HRGN

Дескриптор области, которую можно использовать для указания границ области проверки попадания. Для этого параметра может быть задано значение NULL.

[in] ptTest

Тип: POINT

Структура POINT , содержащая координаты точки.

[out] pwHitTestCode

Тип: WORD*

WORD , получающий код проверки нажатия, указывающий, находится ли точка в ptTest в фоновой области, ограниченной pRect или hrgn. Список возвращаемых значений см. в разделе Возвращаемые значения проверки нажатия .

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Значения в ptTest и pRect должны находиться в одной системе координат, например клиент или экран. Если используется параметр hrgn , он должен быть указан в той же координате, что и pRect и ptTest.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header uxtheme.h
Библиотека UxTheme.lib
DLL UxTheme.dll

См. также раздел

Идентификаторы свойств