Функция SetDialogControlDpiChangeBehavior (winuser.h)

  • Статья

Переопределяет поведение масштабирования по умолчанию для каждого монитора для дочернего окна в диалоговом окне.

Синтаксис

BOOL SetDialogControlDpiChangeBehavior(
  HWND                                hWnd,
  DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS mask,
  DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS values
);

Параметры

hWnd

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

mask

Маска, указывающая подмножество флагов, которые необходимо изменить.

values

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

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

Эта функция возвращает значение TRUE, если операция была успешной, и false в противном случае. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Возможные ошибки ERROR_INVALID_HANDLE , если передан недопустимый HWND, и ERROR_ACCESS_DENIED , если окна принадлежат другому процессу.

Комментарии

Поведение указывается в виде значений из перечисления DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS . Эта функция использует типичный двухпараметрный подход к установке флагов, где маска указывает подмножество флагов, которые необходимо изменить.

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

Этот API влияет на отдельные элементы управления в диалоговых окнах. Поведением масштабирования DPI на уровне диалогового окна для каждого монитора управляет SetDialogDpiChangeBehavior.

Требования

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

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

DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS

GetDialogControlDpiChangeBehavior