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

  • Статья

Вариант OpenThemeData , который открывает дескриптор темы, связанный с определенным DPI.

Синтаксис

HTHEME OpenThemeDataForDpi(
  HWND    hwnd,
  LPCWSTR pszClassList,
  UINT    dpi
);

Параметры

hwnd

Дескриптор окна, для которого требуются данные темы.

pszClassList

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

dpi

Указанное значение DPI, с которым связывается дескриптор темы. Функция возвращает ошибку, если это значение не соответствует набору подключенных мониторов.

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

См. раздел OpenThemeData.

Комментарии

OpenThemeData создаст дескриптор темы, связанный с разрешением окна при использовании с окнами "На монитор" версии 2. OpenThemeDataForDpi позволяет открыть дескриптор темы для определенного DPI, если у вас нет окна с этим разрешением.

Поведение дескриптора возвращаемой темы будет подорвано, если запрошенное значение DPI не соответствует текущему подключенному отображению. Система тем загружает ресурсы темы только для набора значений DPI, соответствующих текущим подключенным дисплеям.

Дескриптор темы будет недопустим каждый раз, когда система перезагрузит данные темы. Приложения должны отслеживать WM_THEMECHANGED , а также закрывать и повторно открывать все дескрипторы тем в ответ. Это поведение одинаково независимо от того, были ли дескрипторы открыты через OpenThemeData или OpenThemeDataForDpi.

Требования

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

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

OpenThemeData