DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS enumeration

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_SCALING_BEHAVIOR { 
  DCDC_DEFAULT              = 0x0000,
  DCDC_DISABLE_FONT_UPDATE  = 0x0001,
  DCDC_DISABLE_RELAYOUT     = 0x0002
} DIALOG_SCALING_BEHAVIOR;

Constants

DCDC_DEFAULT

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

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

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

Minimum supported client

Windows 10, version 1703 [desktop apps only]

Minimum supported server

Windows Server 2016 [desktop apps only]

Header

Winuser.h

See also

SetDialogControlDpiChangeBehavior
GetDialogControlDpiChangeBehavior
DIALOG_DPI_CHANGE_BEHAVIORS

 

 

Show: