Funzione SetDialogDpiChangeBehavior (winuser.h)

Le finestre di dialogo nei contesti per monitoraggio v2 vengono ridimensionate automaticamente con DPI. Questo metodo consente di personalizzare il comportamento di modifica DPI.

Questa funzione funziona insieme all'enumerazione DIALOG_DPI_CHANGE_BEHAVIORS per eseguire l'override del comportamento di ridimensionamento DPI predefinito per le finestre di dialogo. Questa funzione viene chiamata in una finestra di dialogo specificata, per cui i flag specificati vengono salvati singolarmente.

Questa funzione non influisce sul comportamento di ridimensionamento DPI per le finestre figlio della finestra di dialogo in questione, che viene eseguita con SetDialogControlDpiChangeBehavior.

Sintassi

BOOL SetDialogDpiChangeBehavior(
  HWND                        hDlg,
  DIALOG_DPI_CHANGE_BEHAVIORS mask,
  DIALOG_DPI_CHANGE_BEHAVIORS values
);

Parametri

hDlg

Handle per la finestra di dialogo 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.

Eventuali errori sono ERROR_INVALID_HANDLE se è stata passata una finestra di dialogo non valida HWND e ERROR_ACCESS_DENIED se la finestra di dialogo appartiene a un altro processo.

Commenti

Per l'estendibilità, DIALOG_DPI_CHANGE_BEHAVIORS è stato modellato come set di flag di bit che rappresentano comportamenti separati. Questa funzione segue l'approccio tipico a due parametri per impostare i flag, in cui una maschera specifica il subset dei flag da modificare.

Non è un errore chiamare questa API al di fuori dei contesti per Monitoraggio v2, anche se i flag non avranno alcun effetto sul comportamento della finestra di dialogo specificata fino a quando il contesto non viene modificato in Per Monitor v2.

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_DPI_CHANGE_BEHAVIORS

GetDialogDpiChangeBehavior