Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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_REDIRECTIONBITMAP_ALPHA,
DWMWA_BORDER_MARGINS,
DWMWA_LAST
} ;
Costanti
DWMWA_NCRENDERING_ENABLEDIMPORTANTE. Il valore di DWMWA_NCRENDERING_ENABLED è 1. 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_POLICYUsare con DwmSetWindowAttribute. Imposta i criteri di rendering non client. Il parametro pvAttribute |
DWMWA_TRANSITIONS_FORCEDISABLEDUsare 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_NCPAINTUsare 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_BOUNDSUsare 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_LAYOUTUsare 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_REPRESENTATIONUsare 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_POLICYUsare con DwmSetWindowAttribute. Imposta il modo in cui Flip3D gestisce la finestra. Il parametro pvAttribute |
DWMWA_EXTENDED_FRAME_BOUNDSUsare con DwmGetWindowAttribute. Recupera il rettangolo dei limiti di fotogrammi estesi nello spazio dello schermo. Il valore recuperato è di tipo RECT. |
DWMWA_HAS_ICONIC_BITMAPUsare 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_PEEKUsare 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_PEEKUsare 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_CLOAKUsare 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_CLOAKEDUsare 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_REPRESENTATIONUsare 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_HOSTBACKDROPBRUSHUsare con DwmSetWindowAttribute. Consente a una finestra non UWP di usare pennelli di sfondo host. Se questo flag è impostato, un'app Win32 che chiama Windows::UI::Composition API può creare effetti di trasparenza usando il pennello 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_MODEUsare 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_PREFERENCEUsare 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_COLORUsare con DwmSetWindowAttribute. Specifica il colore del bordo della finestra. Il parametro pvAttribute 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_COLORUsare con DwmSetWindowAttribute. Specifica il colore della didascalia. Il parametro pvAttribute 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_COLORUsare con DwmSetWindowAttribute. Specifica il colore del testo della didascalia. Il parametro pvAttribute 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_THICKNESSUsare 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 Questo valore è supportato a partire da Windows 11 Build 22000. |
DWMWA_SYSTEMBACKDROP_TYPEUsare 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 Questo valore è supportato a partire da Windows 11 Build 22621. |
DWMWA_REDIRECTIONBITMAP_ALPHAUtilizzare con DwmSetWindowAttribute . Abilita o disabilita l'uso del canale alfa nel reindirizzamento della finestra Bitmap. Se questo attributo è impostato su true, la finestra deve contenere premultiplied valori alfa in ogni pixel. Se è false, l'alfa viene ignorato e la bitmap di reindirizzamento viene considerata completamente opaca. Per impostazione predefinita, questo attributo è false. Questo valore è supportato a partire da Windows 11 Build 26100. |
DWMWA_BORDER_MARGINSUsare con DwmSetWindowAttribute . Specifica la posizione di override del bordo della finestra, come distanza da ogni Bordo. Il parametro pvAttribute punta a un valore di tipo FRAME_MARGIN. Un valore di tutti gli zeri disabilita l'override impostato da questo attributo, con conseguente bordi di finestra predefiniti. In caso contrario, tutti i valori devono essere maggiori o uguali a 1. Ogni valore nella FRAME_MARGIN (sinistra, destra, superiore, inferiore) indica una distanza verso l'interno da ogni bordo della finestra. I margini del bordo diverso da zero forzano la finestra per avere un bordo e imposta la posizione del bordo. Contenuto della finestra coperto all'esterno o all'esterno del bordo vengono ritagliati. Questo valore sarà supportato in un prossimo aggiornamento per Windows 11 build 26100. |
DWMWA_LASTValore 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
- funzione DwmGetWindowAttribute
- funzione DwmSetWindowAttribute
- Abilitare e controllare la composizione DWM