Compartilhar via


Função SetLayeredWindowAttributes (winuser.h)

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)

Confira também

Alphablend

COLORREF

Conceitual

Createwindowex

Outros recursos

RGB

Referência

Setwindowlong

Transparentblt

UpdateLayeredWindow

Usando o Windows

Windows