Estructura UPDATELAYEREDWINDOWINFO (winuser.h)

Artículo
08/28/2023

Usado por UpdateLayeredWindowIndirect para proporcionar información de posición, tamaño, forma, contenido y translucencia para una ventana superpuesta.

Sintaxis

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;

Miembros

cbSize

Tipo: DWORD

Tamaño, en bytes, de esta estructura.

hdcDst

Tipo: HDC

Identificador de un controlador de dominio para la pantalla. Este identificador se obtiene especificando NULL en este miembro al llamar a UpdateLayeredWindowIndirect. El identificador se usa para la coincidencia de colores de paleta cuando se actualiza el contenido de la ventana. Si hdcDst es NULL, se usa la paleta predeterminada.

Si hdcSrc es NULL, hdcDst debe ser NULL.

pptDst

Tipo: const POINT*

Nueva posición de pantalla de la ventana superpuesta. Si la nueva posición no cambia de la posición actual, pptDst puede ser NULL.

psize

Tipo: const SIZE*

Nuevo tamaño de la ventana superpuesta. Si el tamaño de la ventana no cambiará, este parámetro puede ser NULL. Si hdcSrc es NULL, psize debe ser NULL.

hdcSrc

Tipo: HDC

Identificador del controlador de dominio para la superficie que define la ventana superpuesta. Este identificador se puede obtener llamando a la función CreateCompatibleDC . Si la forma y el contexto visual de la ventana no cambiarán, hdcSrc puede ser NULL.

pptSrc

Tipo: const POINT*

Ubicación de la capa en el contexto del dispositivo. Si hdcSrc es NULL, pptSrc debe ser NULL.

crKey

Tipo: COLORREF

Tecla de color que se va a usar al componer la ventana superpuesta. Para generar un COLORREF, use la macro RGB .

pblend

Tipo: const BLENDFUNCTION*

Valor de transparencia que se va a usar al componer la ventana superpuesta.

dwFlags

Tipo: DWORD

Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
ULW_ALPHA 0x00000002	Use pblend como función blend. Si el modo de visualización es de 256 colores o menos, el efecto de este valor es el mismo que el efecto de ULW_OPAQUE.
ULW_COLORKEY 0x00000001	Use crKey como color de transparencia.
ULW_OPAQUE 0x00000004	Dibuje una ventana superpuesta opaca.
ULW_EX_NORESIZE 0x00000008	Forzar que se produzca un error en la función UpdateLayeredWindowIndirect si el tamaño de la ventana actual no coincide con el tamaño especificado en psize.

Si hdcSrc es NULL, dwFlags debe ser cero.

prcDirty

Tipo: const RECT*

Área que se va a actualizar. Este parámetro puede ser NULL. Si no es NULL, solo se actualiza el área de este rectángulo desde el controlador de dominio de origen.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluya Windows.h)

Consulte también

Conceptual

Referencia

UpdateLayeredWindow

Características de las ventanas