DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS enumeration (winuser.h)

  • Article

Describes per-monitor DPI scaling behavior overrides for child windows within dialogs. The values in this enumeration are bitfields and can be combined.

Syntax

typedef enum DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS {
  DCDC_DEFAULT = 0x0000,
  DCDC_DISABLE_FONT_UPDATE = 0x0001,
  DCDC_DISABLE_RELAYOUT = 0x0002
} ;

Constants

 
DCDC_DEFAULT
Value: 0x0000
The default behavior of the dialog manager. The dialog managed will update the font, size, and position of the child window on DPI changes.
DCDC_DISABLE_FONT_UPDATE
Value: 0x0001
Prevents the dialog manager from sending an updated font to the child window via WM_SETFONT in response to a DPI change.
DCDC_DISABLE_RELAYOUT
Value: 0x0002
Prevents the dialog manager from resizing and repositioning the child window in response to a DPI change.

Remarks

This enum is used with SetDialogControlDpiChangeBehavior in order to override the default per-monitor DPI scaling behavior for a child window within a dialog.

These settings only apply to individual controls within dialogs. The dialog-wide per-monitor DPI scaling behavior of a dialog is controlled by DIALOG_DPI_CHANGE_BEHAVIORS.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1703 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Header winuser.h

See also

DIALOG_DPI_CHANGE_BEHAVIORS

GetDialogControlDpiChangeBehavior

SetDialogControlDpiChangeBehavior