Función DwmSetWindowAttribute (dwmapi.h)

  • Artículo

Establece el valor de los atributos de representación que no son del Administrador de ventanas de escritorio (DWM) para una ventana. Para obtener instrucciones de programación y ejemplos de código, consulte Control de la representación de regiones que no son de cliente.

Sintaxis

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

Parámetros

hwnd

Identificador de la ventana para la que se va a establecer el valor del atributo.

dwAttribute

Marca que describe qué valor se va a establecer, especificado como un valor de la enumeración DWMWINDOWATTRIBUTE . Este parámetro especifica qué atributo se va a establecer y el parámetro pvAttribute apunta a un objeto que contiene el valor del atributo.

[in] pvAttribute

Puntero a un objeto que contiene el valor de atributo que se va a establecer. El tipo del conjunto de valores depende del valor del parámetro dwAttribute . El tema de enumeración DWMWINDOWATTRIBUTE indica, en la fila de cada marca, qué tipo de valor debe pasar un puntero a en el parámetro pvAttribute .

cbAttribute

Tamaño, en bytes, del valor del atributo que se establece a través del parámetro pvAttribute . El tipo del valor establecido y, por tanto, su tamaño en bytes, depende del valor del parámetro dwAttribute .

Valor devuelto

Tipo: HRESULT

Si la función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de errorHRESULT.

Si La composición del escritorio se ha deshabilitado (Windows 7 y versiones anteriores), esta función devuelve DWM_E_COMPOSITIONDISABLED.

Comentarios

No es válido llamar a esta función con el parámetro dwAttribute establecido en DWMWA_NCRENDERING_ENABLED. Para habilitar o deshabilitar la representación que no es de cliente, debe usar el atributo DWMWA_NCRENDERING_POLICY y establecer el valor deseado. Para obtener más información y un ejemplo de código, consulte Control de la representación de regiones que no son de cliente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dwmapi.h
Library Dwmapi.lib
Archivo DLL Dwmapi.dll; Uxtheme.dll

Consulte también