如何设置 SetDialogDpiChangeBehavior 的掩码和值参数

Question

我需要在我的应用中使用这个 API 调用：https://docs.microsoft.com/en-us/windows/desktop/api/winuser/nf-winuser-setdialogdpichangebehavior

BOOL SetDialogDpiChangeBehavior(
  HWND                        hDlg,
  DIALOG_DPI_CHANGE_BEHAVIORS mask,
  DIALOG_DPI_CHANGE_BEHAVIORS values
);

typedef enum DIALOG_DPI_CHANGE_BEHAVIORS {
  DDC_DEFAULT                   ,
  DDC_DISABLE_ALL               ,
  DDC_DISABLE_RESIZE            ,
  DDC_DISABLE_CONTROL_RELAYOUT
} ;

文档说mask 是“指定要更改的标志子集的掩码”。 values 是“为指定的标志子集设置的期望值”。在评论中它说“为了可扩展性，DIALOG_DPI_CHANGE_BEHAVIORS 被建模为一组表示单独行为的位标志。这个函数遵循典型的两参数设置标志的方法，其中掩码指定要更改的标志的子集。”

我找不到任何显示此方法实际调用方式的代码示例。如果函数只有一个 flags 参数，这对我来说很有意义，但我不知道如何使用这两个 mask 和 values 参数来处理它。

Answer 1

文档中存在错误。 DIALOG_DPI_CHANGE_BEHAVIORS 定义来自c:\Program Files (x86)\Windows Kits\10\Include\10.0.17134.0\um\winuser.h：

typedef enum DIALOG_DPI_CHANGE_BEHAVIORS {
    DDC_DEFAULT                     = 0x0000,
    DDC_DISABLE_ALL                 = 0x0001,
    DDC_DISABLE_RESIZE              = 0x0002,
    DDC_DISABLE_CONTROL_RELAYOUT    = 0x0004,
} DIALOG_DPI_CHANGE_BEHAVIORS;

除了DDC_DEFAULT，这些都是简单的位标志，可以用 | 进行运算。

SetDialogDpiChangeBehavior(
    hwnd,
    DDC_DISABLE_RESIZE | DDC_DISABLE_CONTROL_RELAYOUT,
    DDC_DISABLE_CONTROL_RELAYOUT );

基本上这是这样的：

flags = ( flags & ~mask ) | ( values & mask );

如果mask 位等于0，则保留flags 中的旧位值，如果mask 位等于1，则flags 位根据values 中的位进行更改。

要设置flag 位，您可以在mask 和values 中设置位。要清除您在mask 中设置的位，但不要在values 中设置它。

// Sets DDC_DISABLE_RESIZE bit
SetDialogDpiChangeBehavior( hwnd, DDC_DISABLE_RESIZE, DDC_DISABLE_RESIZE );
// Clears DDC_DISABLE_RESIZE bit
SetDialogDpiChangeBehavior( hwnd, DDC_DISABLE_RESIZE, 0 );
// Sets DDC_DISABLE_CONTROL_RELAYOUT and clears DDC_DISABLE_RESIZE
SetDialogDpiChangeBehavior(
    hwnd,
    DDC_DISABLE_RESIZE | DDC_DISABLE_CONTROL_RELAYOUT,
    DDC_DISABLE_CONTROL_RELAYOUT );

Answer 2

掩码：仅设置您想要更改的值，例如：DDC_DISABLE_RESIZE | DDC_DISABLE_CONTROL_RELAYOUT。

values：包含新值。例如，如果 values = 0，DDC_DISABLE_RESIZE 和 DDC_DISABLE_CONTROL_RELAYOUT 将设置为 0，则所有其他值保持不变。如果 values = DDC_DISABLE_RESIZE 具有相同的掩码，DDC_DISABLE_RESIZE 将设置为 1，DDC_DISABLE_CONTROL_RELAYOUT 将设置为 0。

另一个例子。如果要启用DDC_DISABLE_RESIZE，请使用掩码=DDC_DISABLE_RESIZE，值DDC_DISABLE_RESIZE。如果要禁用 DDC_DISABLE_RESIZE，请使用掩码 DDC_DISABLE_RESIZE 和值 0。

如果有帮助，函数伪代码是：

for each flag from enum DIALOG_DPI_CHANGE_BEHAVIORS
{
    if flag is set in mask
    {
       set flag value from values
    }
}