Função SetLayeredWindowAttributes (winuser.h)

Artigo
03/13/2024

Define a chave de cor de opacidade e transparência de uma janela em camadas.

Sintaxe

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

Parâmetros

[in] hwnd

Digite: HWND

Um identificador para a janela em camadas. Uma janela em camadas é criada especificando WS_EX_LAYERED ao criar a janela com a função CreateWindowEx ou definindo WS_EX_LAYERED por meio de SetWindowLong após a criação da janela.

Windows 8: o estilo de WS_EX_LAYERED tem suporte para janelas de nível superior e janelas filho. As versões anteriores do Windows dão suporte apenas a WS_EX_LAYERED para janelas de nível superior.

[in] crKey

Tipo: COLORREF

Uma estrutura COLORREF que especifica a chave de cor de transparência a ser usada ao redigir a janela em camadas. Todos os pixels pintados pela janela nessa cor serão transparentes. Para gerar um COLORREF, use a macro RGB .

[in] bAlpha

Tipo: BYTE

Valor alfa usado para descrever a opacidade da janela em camadas. Semelhante ao membro SourceConstantAlpha da estrutura BLENDFUNCTION . Quando bAlpha é 0, a janela é completamente transparente. Quando bAlpha é 255, a janela é opaca.

[in] dwFlags

Tipo: DWORD

Uma ação a ser tomada. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
LWA_ALPHA 0x00000002	Use bAlpha para determinar a opacidade da janela em camadas.
LWA_COLORKEY 0x00000001	Use crKey como a cor de transparência.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Observe que depois que SetLayeredWindowAttributes for chamado para uma janela em camadas, as chamadas updateLayeredWindow subsequentes falharão até que o bit de estilo de camada seja limpo e definido novamente.

Para obter mais informações, consulte Usando Janelas em camadas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-window-l1-1-1 (introduzido no Windows 8.1)