Funzione SetDialogControlDpiChangeBehavior (winuser.h)

Esegue l'override del comportamento di ridimensionamento DPI predefinito per monitor di una finestra figlio in una finestra di dialogo.

Sintassi

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

Parametri

hWnd

Handle per la finestra il cui comportamento verrà modificato.

mask

Maschera che specifica il subset di flag da modificare.

values

Valore desiderato da impostare per il subset specificato di flag.

Valore restituito

Questa funzione restituisce TRUE se l'operazione ha avuto esito positivo e FALSE in caso contrario. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Gli errori possibili sono ERROR_INVALID_HANDLE se è stato passato un HWND non valido e ERROR_ACCESS_DENIED se le finestre appartengono a un altro processo.

Commenti

I comportamenti vengono specificati come valori dell'enumerazione DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS . Questa funzione segue l'approccio tipico a due parametri per impostare i flag, in cui una maschera specifica il subset dei flag da modificare.

È valido impostare questi comportamenti in qualsiasi finestra. Non importa se la finestra è attualmente un elemento figlio di un dialogo nel momento in cui viene chiamato SetDialogControlDpiChangeBehavior. I comportamenti vengono mantenuti e avranno effetto solo quando la finestra è un figlio immediato di una finestra di dialogo con scalabilità DPI per monitor abilitata.

Questa API influenza i singoli controlli all'interno dei dialoghi. Il comportamento di ridimensionamento DPI a livello di finestra di dialogo è controllato da SetDialogDpiChangeBehavior.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1703 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione Winuser
Libreria User32.lib
DLL User32.dll

Vedi anche

DIALOG_CONTROL_DPI_CHANGE_BEHAVIORS

GetDialogControlDpiChangeBehavior