SetDialogControlDpiChangeBehavior 函数 (winuser.h)

  • 项目

替代对话框中子窗口的默认每监视器 DPI 缩放行为。

语法

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

参数

hWnd

将修改其行为的窗口的句柄。

mask

一个掩码，指定要更改的标志的子集。

values

要为指定的标志子集设置的所需值。

返回值

如果操作成功，此函数返回 TRUE，否则返回 FALSE。 要获得更多的错误信息，请调用 GetLastError。

如果传递了无效的 HWND，则 ERROR_INVALID_HANDLE 可能的错误;如果窗口属于另一个进程， 则ERROR_ACCESS_DENIED 。

注解

行为指定为 DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS 枚举中的值。 此函数遵循典型的双参数方法来设置标志，其中掩码指定要更改的标志的子集。

在任何 窗口上 设置这些行为都是有效的。 在 SetDialogControlDpiChangeBehavior 调用的时间点，窗口当前是否是对话的子级并不重要。 仅当窗口是启用了按监视器 DPI 缩放的对话的直接子级时，行为才会生效。

此 API 影响对话中的单个控件。 对话框范围的每个监视器 DPI 缩放行为由 SetDialogDpiChangeBehavior 控制。

要求

要求 值
最低受支持的客户端 Windows 10版本 1703 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 winuser.h
Library User32.lib
DLL User32.dll

另请参阅

DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS

GetDialogControlDpiChangeBehavior