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 |
程式庫 | User32.lib |
Dll | User32.dll |