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