DwmSetWindowAttribute, fonction (dwmapi.h)

  • Article

Définit la valeur des attributs de rendu non client (DWM) du Gestionnaire de fenêtres de bureau pour une fenêtre. Pour obtenir des conseils de programmation et des exemples de code, consultez Contrôle du rendu de région non cliente.

Syntaxe

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

Paramètres

[in] hwnd

Handle vers la fenêtre pour laquelle la valeur d’attribut doit être définie.

[in] dwAttribute

Indicateur décrivant la valeur à définir, spécifiée comme valeur de l’énumération DWMWINDOWATTRIBUTE. Ce paramètre spécifie l’attribut à définir et le paramètre pvAttribute pointe vers un objet contenant la valeur d’attribut.

[in] pvAttribute

Pointeur vers un objet contenant la valeur d’attribut à définir. Le type du jeu de valeurs dépend de la valeur du paramètre dwAttribute. La rubrique d’énumération DWMWINDOWATTRIBU TE indique, dans la ligne de chaque indicateur, quel type de valeur vous devez passer un pointeur dans le paramètre pvAttribute.

[in] cbAttribute

Taille, en octets, de la valeur d’attribut définie via le paramètre pvAttribute. Le type du jeu de valeurs, et par conséquent sa taille en octets, dépend de la valeur du paramètre dwAttribute.

Valeur de retour

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Si la composition du bureau a été désactivée (Windows 7 et versions antérieures), cette fonction retourne DWM_E_COMPOSITIONDISABLED.

Remarques

Il n’est pas valide d’appeler cette fonction avec le paramètre dwAttribute défini sur DWMWA_NCRENDERING_ENABLED. Pour activer ou désactiver le rendu non client, vous devez utiliser l’attribut DWMWA_NCRENDERING_POLICY et définir la valeur souhaitée. Pour plus d’informations et un exemple de code, consultez Contrôle du rendu de région non cliente.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête dwmapi.h
bibliothèque Dwmapi.lib
DLL Dwmapi.dll; Uxtheme.dll

Voir aussi