Funzione DwmSetWindowAttribute (dwmapi.h)

Articolo
08/23/2023

Imposta il valore degli attributi di rendering non client di Desktop Window Manager (DWM) per una finestra. Per indicazioni sulla programmazione ed esempi di codice, vedere Controllo del rendering dell'area non client.

Sintassi

HRESULT DwmSetWindowAttribute(
       HWND    hwnd,
       DWORD   dwAttribute,
  [in] LPCVOID pvAttribute,
       DWORD   cbAttribute
);

Parametri

hwnd

Handle della finestra per cui deve essere impostato il valore dell'attributo.

dwAttribute

Flag che descrive quale valore impostare, specificato come valore dell'enumerazione DWMWINDOWATTRIBUTE . Questo parametro specifica l'attributo da impostare e il parametro pvAttribute punta a un oggetto contenente il valore dell'attributo.

[in] pvAttribute

Puntatore a un oggetto contenente il valore dell'attributo da impostare. Il tipo del set di valori dipende dal valore del parametro dwAttribute . L'argomento di enumerazione DWMWINDOWATTRIBUTE indica, nella riga per ogni flag, quale tipo di valore è necessario passare un puntatore a nel parametro pvAttribute .

cbAttribute

Dimensioni, in byte, del valore dell'attributo impostato tramite il parametro pvAttribute . Il tipo del set di valori e quindi la relativa dimensione in byte dipende dal valore del parametro dwAttribute .

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Se La composizione desktop è stata disabilitata (Windows 7 e versioni precedenti), questa funzione restituisce DWM_E_COMPOSITIONDISABLED.

Commenti

Non è valido chiamare questa funzione con il parametro dwAttribute impostato su DWMWA_NCRENDERING_ENABLED. Per abilitare o disabilitare il rendering non client, è necessario usare l'attributo DWMWA_NCRENDERING_POLICY e impostare il valore desiderato. Per altre informazioni e un esempio di codice, vedere Controllo del rendering dell'area non client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dwmapi.h
Libreria	Dwmapi.lib
DLL	Dwmapi.dll; Uxtheme.dll

Condividi tramite