Condividi tramite

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

IMPORTANTE

Il valore di DWMWA_NCRENDERING_ENABLED è 1.

cpp<br>typedef enum DWMWINDOWATTRIBUTE {<br> DWMWA_NCRENDERING_ENABLED = 1,<br> DWMWA_NCRENDERING_POLICY,<br> ...<br>

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 nel frame disegnato da DWM. Il parametro pvAttribute punta a un valore di tipo BOOL. TRUE per abilitare 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 della 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. È necessario verificare se il RECT recuperato contiene un limite che è possibile utilizzare e, se non lo fa, è 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 un'icona di anteprima o una rappresentazione a comparsa (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 di anteprima o anteprima iconica; 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 a comparsa (bitmap statica) per la finestra. DWMWA_HAS_ICONIC_BITMAP può essere specificato con DWMWA_FORCE_ICONIC_REPRESENTATION. DWMWA_HAS_ICONIC_BITMAP normalmente viene 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 informare DWM che la finestra fornirà una rappresentazione iconica dell'anteprima o della visualizzazione; in caso contrario, FALSE.

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

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 svanisa durante la visualizzazione di un'altra finestra o false per il comportamento normale.

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

Uso con DirectComposition: Usare il flag di DWMWA_CLOAK per nascondere la finestra figlio a più livelli durante l'animazione di una rappresentazione del contenuto della finestra tramite un oggetto visivo DirectComposition associato alla finestra figlio a più livelli. Per altri dettagli 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 in tempo reale ulteriormente 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 pennelli di sfondo host. Se questo flag è impostato, un'app Win32 che chiama 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 dello sfondo host per la finestra o FALSE 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 della modalità scura quando l'impostazione di sistema in modalità scura è abilitata. 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 per l'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 della 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 della didascalia.

Questo valore è supportato a partire da Windows 11 Build 22000.
DWMWA_TEXT_COLOR
Usare con DwmSetWindowAttribute. Specifica il colore del testo della 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 della 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 che il DWM disegnare 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 massimo riconosciuto DWMWINDOWATTRIBUTE, usato a scopo di convalida.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2008 [solo app desktop]
intestazione dwmapi.h

Vedere anche