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

另請參閱

DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS

GetDialogControlDpiChangeBehavior