Función SetLayeredWindowAttributes (winuser.h)

Artículo
03/04/2024

Establece la clave de color de transparencia y opacidad de una ventana superpuesta.

Sintaxis

BOOL SetLayeredWindowAttributes(
  [in] HWND     hwnd,
  [in] COLORREF crKey,
  [in] BYTE     bAlpha,
  [in] DWORD    dwFlags
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador de la ventana superpuesta. Se crea una ventana superpuesta especificando WS_EX_LAYERED al crear la ventana con la función CreateWindowEx o estableciendo WS_EX_LAYERED a través de SetWindowLong una vez creada la ventana.

Windows 8: el estilo de WS_EX_LAYERED es compatible con ventanas de nivel superior y ventanas secundarias. Las versiones anteriores de Windows solo admiten WS_EX_LAYERED para ventanas de nivel superior.

[in] crKey

Tipo: COLORREF

Estructura COLORREF que especifica la clave de color de transparencia que se usará al componer la ventana superpuesta. Todos los píxeles pintados por la ventana de este color serán transparentes. Para generar un COLORREF, use la macro RGB .

[in] bAlpha

Tipo: BYTE

El valor alfa utilizado para describir la opacidad de la ventana superpuesta. Similar al miembro SourceConstantAlpha de la estructura BLENDFUNCTION . Cuando bAlpha es 0, la ventana es completamente transparente. Cuando bAlpha es 255, la ventana es opaca.

[in] dwFlags

Tipo: DWORD

Acción que se va a realizar. Este parámetro puede ser uno o más de los siguientes valores.

Valor	Significado
LWA_ALPHA 0x00000002	Use bAlpha para determinar la opacidad de la ventana superpuesta.
LWA_COLORKEY 0x00000001	Use crKey como color de transparencia.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Tenga en cuenta que, una vez que se ha llamado a SetLayeredWindowAttributes para una ventana superpuesta, las llamadas posteriores a UpdateLayeredWindow producirán un error hasta que se borre y vuelva a establecer el bit de estilo de capas.

Para obtener más información, vea Uso de Windows en capas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-1 (introducido en Windows 8.1)