Enumerazione DWMWINDOWATTRIBUTE (dwmapi.h)

  • Articolo

Opzioni usate dalle funzioni DwmGetWindowAttribute e DwmSetWindowAttribute .

Sintassi

typedef enum DWMWINDOWATTRIBUTE {
  DWMWA_NCRENDERING_ENABLED,
  DWMWA_NCRENDERING_POLICY,
  DWMWA_TRANSITIONS_FORCEDISABLED,
  DWMWA_ALLOW_NCPAINT,
  DWMWA_CAPTION_BUTTON_BOUNDS,
  DWMWA_NONCLIENT_RTL_LAYOUT,
  DWMWA_FORCE_ICONIC_REPRESENTATION,
  DWMWA_FLIP3D_POLICY,
  DWMWA_EXTENDED_FRAME_BOUNDS,
  DWMWA_HAS_ICONIC_BITMAP,
  DWMWA_DISALLOW_PEEK,
  DWMWA_EXCLUDED_FROM_PEEK,
  DWMWA_CLOAK,
  DWMWA_CLOAKED,
  DWMWA_FREEZE_REPRESENTATION,
  DWMWA_PASSIVE_UPDATE_MODE,
  DWMWA_USE_HOSTBACKDROPBRUSH,
  DWMWA_USE_IMMERSIVE_DARK_MODE = 20,
  DWMWA_WINDOW_CORNER_PREFERENCE = 33,
  DWMWA_BORDER_COLOR,
  DWMWA_CAPTION_COLOR,
  DWMWA_TEXT_COLOR,
  DWMWA_VISIBLE_FRAME_BORDER_THICKNESS,
  DWMWA_SYSTEMBACKDROP_TYPE,
  DWMWA_LAST
} ;

Costanti

 
DWMWA_NCRENDERING_ENABLED
Usare con DwmGetWindowAttribute. Individua se il rendering non client è abilitato. Il valore recuperato è di tipo BOOL. TRUE se il rendering non client è abilitato; in caso contrario, FALSE.
DWMWA_NCRENDERING_POLICY
Usare con DwmSetWindowAttribute. Imposta i criteri di rendering non client. Il parametro pvAttribute punta a un valore dell'enumerazione DWMNCRENDERINGPOLICY .
DWMWA_TRANSITIONS_FORCEDISABLED
Usare con DwmSetWindowAttribute. Abilita o disabilita forzatamente le transizioni DWM. Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per disabilitare le transizioni o FALSE per abilitare le transizioni.
DWMWA_ALLOW_NCPAINT
Usare con DwmSetWindowAttribute. Consente il rendering del contenuto nell'area non client per essere visibile sul frame disegnato da DWM. Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per consentire il rendering del contenuto nell'area non client per essere visibile nel frame; in caso contrario, FALSE.
DWMWA_CAPTION_BUTTON_BOUNDS
Usare con DwmGetWindowAttribute. Recupera i limiti dell'area del pulsante didascalia nello spazio relativo alla finestra. Il valore recuperato è di tipo RECT. Se la finestra è ridotta a icona o non è visibile all'utente, il valore del RECT recuperato non è definito. È consigliabile verificare se il RECT recuperato contiene un limite che è possibile utilizzare e, in caso contrario, è possibile concludere che la finestra è ridotta a icona o altrimenti non visibile.
DWMWA_NONCLIENT_RTL_LAYOUT
Usare con DwmSetWindowAttribute. Specifica se il contenuto non client è con mirroring da destra a sinistra (RTL). Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE se il contenuto non client è con mirroring da destra a sinistra (RTL); in caso contrario, FALSE.
DWMWA_FORCE_ICONIC_REPRESENTATION
Usare con DwmSetWindowAttribute. Forza la finestra a visualizzare una rappresentazione di anteprima o anteprima iconica (bitmap statica), anche se è disponibile una rappresentazione dinamica o snapshot della finestra. Questo valore viene in genere impostato durante la creazione di una finestra e non viene modificato per tutta la durata della finestra. Alcuni scenari, tuttavia, potrebbero richiedere la modifica del valore nel tempo. Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per richiedere una rappresentazione iconica di anteprima o anteprima; in caso contrario, FALSE.
DWMWA_FLIP3D_POLICY
Usare con DwmSetWindowAttribute. Imposta il modo in cui Flip3D gestisce la finestra. Il parametro pvAttribute punta a un valore dell'enumerazione DWMFLIP3DWINDOWPOLICY .
DWMWA_EXTENDED_FRAME_BOUNDS
Usare con DwmGetWindowAttribute. Recupera il rettangolo dei limiti di fotogrammi estesi nello spazio dello schermo. Il valore recuperato è di tipo RECT.
DWMWA_HAS_ICONIC_BITMAP
Usare con DwmSetWindowAttribute. La finestra fornirà una bitmap da usare da DWM come anteprima iconica o rappresentazione in anteprima (bitmap statica) per la finestra. DWMWA_HAS_ICONIC_BITMAP può essere specificato con DWMWA_FORCE_ICONIC_REPRESENTATION. DWMWA_HAS_ICONIC_BITMAP in genere viene impostato durante la creazione di una finestra e non modificato per tutta la durata della finestra. Alcuni scenari, tuttavia, potrebbero richiedere la modifica del valore nel tempo. Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per informare DWM che la finestra fornirà una rappresentazione iconica di anteprima o anteprima; in caso contrario, FALSE.

Windows Vista e versioni precedenti: Questo valore non è supportato.
DWMWA_DISALLOW_PEEK
Usare con DwmSetWindowAttribute. Non visualizzare l'anteprima di anteprima per la finestra. La visualizzazione a comparsa mostra un'anteprima completa della finestra quando il mouse passa sopra l'anteprima della finestra nella barra delle applicazioni. Se questo attributo è impostato, posizionando il puntatore del mouse sull'anteprima della finestra viene chiusa la visualizzazione (nel caso in cui un'altra finestra del gruppo abbia un'anteprima di visualizzazione). Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per impedire la funzionalità di visualizzazione o FALSE per consentirla.

Windows Vista e versioni precedenti: Questo valore non è supportato.
DWMWA_EXCLUDED_FROM_PEEK
Usare con DwmSetWindowAttribute. Impedisce la dissolvenza di una finestra a un foglio di vetro quando viene richiamata la visualizzazione. Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per evitare che la finestra si dissolve durante la visualizzazione di un'altra finestra o FALSE per un comportamento normale.

Windows Vista e versioni precedenti: Questo valore non è supportato.
DWMWA_CLOAK
Usare con DwmSetWindowAttribute. Nasconde la finestra in modo che non sia visibile all'utente. La finestra è ancora composta da DWM.

Uso di con DirectComposition: Usare il flag DWMWA_CLOAK per mascherare la finestra figlio sovrapposta durante l'animazione di una rappresentazione del contenuto della finestra tramite un oggetto visivo DirectComposition associato alla finestra figlio a più livelli. Per altre informazioni su questo caso di utilizzo, vedere Come animare la bitmap di una finestra figlio a più livelli.

Windows 7 e versioni precedenti: Questo valore non è supportato.
DWMWA_CLOAKED
Usare con DwmGetWindowAttribute. Se la finestra è mascherata, fornisce uno dei valori seguenti che spiegano perché.

DWM_CLOAKED_APP (0x00000001 valore). La finestra è stata mascherata dall'applicazione proprietaria.

DWM_CLOAKED_SHELL (0x00000002 valore). La finestra era mascherata dalla Shell.

DWM_CLOAKED_INHERITED (0x00000004 valore). Il valore del mantello è stato ereditato dalla finestra del proprietario.

Windows 7 e versioni precedenti: Questo valore non è supportato.
DWMWA_FREEZE_REPRESENTATION
Usare con DwmSetWindowAttribute. Bloccare l'immagine di anteprima della finestra con gli oggetti visivi correnti. Non aggiornare ulteriormente in tempo reale l'immagine di anteprima in modo che corrisponda al contenuto della finestra.

Windows 7 e versioni precedenti: Questo valore non è supportato.
DWMWA_USE_HOSTBACKDROPBRUSH
Usare con DwmSetWindowAttribute. Consente a una finestra non UWP di usare i pennelli dello sfondo dell'host. Se questo flag è impostato, un'app Win32 che chiama le API Windows::UI::Composition può creare effetti di trasparenza usando il pennello dello sfondo host (vedere Compositor.CreateHostBackdropBrush). Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per abilitare i pennelli di sfondo dell'host per la finestra o FALSE per disabilitarlo.

Questo valore è supportato a partire da Windows 11 Build 22000.
DWMWA_USE_IMMERSIVE_DARK_MODE
Usare con DwmSetWindowAttribute. Consente di disegnare la cornice della finestra nei colori in modalità scura quando è abilitata l'impostazione del sistema in modalità scura. Per motivi di compatibilità, per impostazione predefinita tutte le finestre vengono impostate sulla modalità light indipendentemente dall'impostazione di sistema. Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per rispettare la modalità scura per la finestra, FALSE per usare sempre la modalità luce.

Questo valore è supportato a partire da Windows 11 Build 22000.
DWMWA_WINDOW_CORNER_PREFERENCE
Usare con DwmSetWindowAttribute. Specifica la preferenza dell'angolo arrotondato per una finestra. Il parametro pvAttribute punta a un valore di tipo DWM_WINDOW_CORNER_PREFERENCE.

Questo valore è supportato a partire da Windows 11 Build 22000.
DWMWA_BORDER_COLOR
Usare con DwmSetWindowAttribute. Specifica il colore del bordo della finestra. Il parametro pvAttribute punta a un valore di tipo COLORREF. L'app è responsabile della modifica del colore del bordo in base alle modifiche dello stato, ad esempio una modifica nell'attivazione della finestra.

Se si specifica DWMWA_COLOR_NONE (valore 0xFFFFFFFE) per il colore, il disegno del bordo della finestra verrà eliminato. In questo modo è possibile avere una finestra arrotondata senza bordo.

Se si specifica DWMWA_COLOR_DEFAULT (valore 0xFFFFFFFF) per il colore, la finestra verrà ripristinata usando il comportamento predefinito del sistema per il colore del bordo.

Questo valore è supportato a partire da Windows 11 Build 22000.
DWMWA_CAPTION_COLOR
Usare con DwmSetWindowAttribute. Specifica il colore del didascalia. Il parametro pvAttribute punta a un valore di tipo COLORREF.

Se si specifica DWMWA_COLOR_DEFAULT (valore 0xFFFFFFFF) per il colore, la finestra verrà ripristinata usando il comportamento predefinito del sistema per il colore didascalia.

Questo valore è supportato a partire da Windows 11 Build 22000.
DWMWA_TEXT_COLOR
Usare con DwmSetWindowAttribute. Specifica il colore del testo didascalia. Il parametro pvAttribute punta a un valore di tipo COLORREF.

Se si specifica DWMWA_COLOR_DEFAULT (valore 0xFFFFFFFF) per il colore, la finestra verrà ripristinata usando il comportamento predefinito del sistema per il colore del testo didascalia.

Questo valore è supportato a partire da Windows 11 Build 22000.
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS
Usare con DwmGetWindowAttribute. Recupera la larghezza del bordo esterno disegnato da DWM intorno a questa finestra. Il valore può variare a seconda del valore DPI della finestra. Il parametro pvAttribute punta a un valore di tipo UINT.

Questo valore è supportato a partire da Windows 11 Build 22000.
DWMWA_SYSTEMBACKDROP_TYPE
Usare con DwmGetWindowAttribute o DwmSetWindowAttribute. Recupera o specifica il materiale di sfondo disegnato dal sistema di una finestra, incluso dietro l'area non client. Il parametro pvAttribute punta a un valore di tipo DWM_SYSTEMBACKDROP_TYPE.

Questo valore è supportato a partire da Windows 11 Build 22621.
DWMWA_LAST
Valore DWMWINDOWATTRIBUTE massimo riconosciuto, usato a scopo di convalida.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione dwmapi.h

Vedi anche