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 |