Função SetDialogControlDpiChangeBehavior (winuser.h)

Substitui o comportamento de dimensionamento de DPI por monitor padrão de uma janela filho em uma caixa de diálogo.

Sintaxe

BOOL SetDialogControlDpiChangeBehavior(
  HWND                                hWnd,
  DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS mask,
  DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS values
);

Parâmetros

hWnd

Um identificador para a janela cujo comportamento será modificado.

mask

Uma máscara que especifica o subconjunto de sinalizadores a ser alterado.

values

O valor desejado a ser definido para o subconjunto de sinalizadores especificado.

Retornar valor

Essa função retornará TRUE se a operação tiver sido bem-sucedida e, caso contrário, FALSE. Para obter informações de erro estendidas, chame GetLastError.

Erros possíveis serão ERROR_INVALID_HANDLE se forem passados um HWND inválido e ERROR_ACCESS_DENIED se as janelas pertencerem a outro processo.

Comentários

Os comportamentos são especificados como valores da enumeração DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS . Essa função segue a abordagem típica de dois parâmetros para definir sinalizadores, em que uma máscara especifica o subconjunto dos sinalizadores a serem alterados.

É válido definir esses comportamentos em qualquer janela. Não importa se a janela é atualmente filho de uma caixa de diálogo no momento em que SetDialogControlDpiChangeBehavior é chamado. Os comportamentos são retidos e entrarão em vigor somente quando a janela for um filho imediato de uma caixa de diálogo que tenha o dimensionamento de DPI por monitor habilitado.

Essa API influencia os controles individuais nas caixas de diálogo. O comportamento de dimensionamento de DPI por monitor em toda a caixa de diálogo é controlado por SetDialogDpiChangeBehavior.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h
Biblioteca	User32.lib
DLL	User32.dll

Confira também

DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS

GetDialogControlDpiChangeBehavior