Funzione DwmSetWindowAttribute (dwmapi.h)

  • Articolo

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(
  [in] HWND    hwnd,
  [in] DWORD   dwAttribute,
  [in] LPCVOID pvAttribute,
  [in] DWORD   cbAttribute
);

Parametri

[in] hwnd

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

[in] dwAttribute

Flag che descrive il valore da impostare, specificato come valore dell'enumerazione DWMWINDOWATTRIBUTE . Questo parametro specifica quale attributo 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 valore impostato dipende dal valore del parametro dwAttribute. L'argomento di enumerazione DWMWINDOWATTRIBUTE indica, nella riga per ogni flag, il tipo di valore a cui passare un puntatore nel parametro pvAttribute.

[in] 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 erroreHRESULT .

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

Osservazioni

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.

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2008 [solo app desktop]
piattaforma di destinazione Finestre
intestazione dwmapi.h
libreria Dwmapi.lib
dll Dwmapi.dll; Uxtheme.dll

Vedere anche