Estrutura UPDATELAYEREDWINDOWINFO (winuser.h)

Artigo
03/13/2024

Usado por UpdateLayeredWindowIndirect para fornecer informações de posição, tamanho, forma, conteúdo e translucência para uma janela em camadas.

Sintaxe

typedef struct tagUPDATELAYEREDWINDOWINFO {
  DWORD               cbSize;
  HDC                 hdcDst;
  const POINT         *pptDst;
  const SIZE          *psize;
  HDC                 hdcSrc;
  const POINT         *pptSrc;
  COLORREF            crKey;
  const BLENDFUNCTION *pblend;
  DWORD               dwFlags;
  const RECT          *prcDirty;
} UPDATELAYEREDWINDOWINFO, *PUPDATELAYEREDWINDOWINFO;

Membros

cbSize

Tipo: DWORD

O tamanho, em bytes, dessa estrutura.

hdcDst

Tipo: HDC

Um identificador para um controlador de domínio para a tela. Esse identificador é obtido especificando NULL neste membro ao chamar UpdateLayeredWindowIndirect. O identificador é usado para correspondência de cores de paleta quando o conteúdo da janela é atualizado. Se hdcDst for NULL, a paleta padrão será usada.

Se hdcSrc for NULL, hdcDst deverá ser NULL.

pptDst

Tipo: const POINT*

A nova posição da tela da janela em camadas. Se a nova posição não for alterada da posição atual, pptDst poderá ser NULL.

psize

Tipo: const SIZE*

O novo tamanho da janela em camadas. Se o tamanho da janela não for alterado, esse parâmetro poderá ser NULL. Se hdcSrc for NULL, psize deverá ser NULL.

hdcSrc

Tipo: HDC

Um identificador para o CONTROLADOR de domínio para a superfície que define a janela em camadas. Esse identificador pode ser obtido chamando a função CreateCompatibleDC . Se a forma e o contexto visual da janela não forem alterados, hdcSrc poderá ser NULL.

pptSrc

Tipo: const POINT*

O local da camada no contexto do dispositivo. Se hdcSrc for NULL, pptSrc deverá ser NULL.

crKey

Tipo: COLORREF

A tecla de cor a ser usada ao redigir a janela em camadas. Para gerar um COLORREF, use a macro RGB .

pblend

Tipo: const BLENDFUNCTION*

O valor de transparência a ser usado ao redigir a janela em camadas.

dwFlags

Tipo: DWORD

Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
ULW_ALPHA 0x00000002	Use pblend como a função blend. Se o modo de exibição for de 256 cores ou menos, o efeito desse valor será o mesmo que o efeito de ULW_OPAQUE.
ULW_COLORKEY 0x00000001	Use crKey como a cor de transparência.
ULW_OPAQUE 0x00000004	Desenhe uma janela opaca em camadas.
ULW_EX_NORESIZE 0x00000008	Force a função UpdateLayeredWindowIndirect a falhar se o tamanho da janela atual não corresponder ao tamanho especificado no psize.

Se hdcSrc for NULL, dwFlags deverá ser zero.

prcDirty

Tipo: const RECT*

A área a ser atualizada. Este parâmetro pode ser NULL. Se não for NULL, somente a área nesse retângulo será atualizada do CONTROLADOR de domínio de origem.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	winuser.h (inclua Windows.h)

Confira também

Conceitual

Referência

UpdateLayeredWindow

Recursos de janela

Share via