STRUCTURE UPDATELAYEREDWINDOWINFO (winuser.h)

Utilisé par UpdateLayeredWindowIndirect pour fournir des informations de position, de taille, de forme, de contenu et de translucidité pour une fenêtre en couches.

Syntaxe

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;

Membres

cbSize

Type : DWORD

Taille, en octets, de cette structure.

hdcDst

Type : HDC

Handle vers un contrôleur de domaine pour l’écran. Ce handle est obtenu en spécifiant NULL dans ce membre lors de l’appel de UpdateLayeredWindowIndirect. Le handle est utilisé pour la correspondance des couleurs de palette lorsque le contenu de la fenêtre est mis à jour. Si hdcDst a la valeur NULL, la palette par défaut est utilisée.

Si hdcSrc a la valeur NULL, hdcDst doit avoir la valeur NULL.

pptDst

Type : const POINT*

Nouvelle position de l’écran de la fenêtre superposée. Si la nouvelle position est inchangée par rapport à la position actuelle, pptDst peut avoir la valeur NULL.

psize

Type : const SIZE*

Nouvelle taille de la fenêtre superposée. Si la taille de la fenêtre ne change pas, ce paramètre peut être NULL. Si hdcSrc a la valeur NULL, psize doit être NULL.

hdcSrc

Type : HDC

Handle vers le contrôleur de domaine pour la surface qui définit la fenêtre en couches. Ce handle peut être obtenu en appelant la fonction CreateCompatibleDC . Si la forme et le contexte visuel de la fenêtre ne changent pas, hdcSrc peut avoir la valeur NULL.

pptSrc

Type : const POINT*

Emplacement de la couche dans le contexte de l’appareil. Si hdcSrc a la valeur NULL, pptSrc doit avoir la valeur NULL.

crKey

Type : COLORREF

Clé de couleur à utiliser lors de la composition de la fenêtre superposée. Pour générer un COLORREF, utilisez la macro RVB .

pblend

Type : const BLENDFUNCTION*

Valeur de transparence à utiliser lors de la composition de la fenêtre en couches.

dwFlags

Type : DWORD

Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
ULW_ALPHA 0x00000002	Utilisez pblend comme fonction de fusion. Si le mode d’affichage est inférieur ou égal à 256 couleurs, l’effet de cette valeur est identique à l’effet de ULW_OPAQUE.
ULW_COLORKEY 0x00000001	Utilisez crKey comme couleur de transparence.
ULW_OPAQUE 0x00000004	Dessinez une fenêtre opaque en couches.
ULW_EX_NORESIZE 0x00000008	Forcez l’échec de la fonction UpdateLayeredWindowIndirect si la taille de fenêtre actuelle ne correspond pas à la taille spécifiée dans le psize.

 

Si hdcSrc a la valeur NULL, dwFlags doit être égal à zéro.

prcDirty

Type : const RECT*

Zone à mettre à jour. Ce paramètre peut être NULL. S’il n’est pas NULL, seule la zone de ce rectangle est mise à jour à partir du contrôleur de domaine source.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	winuser.h (inclure Windows.h)

Voir aussi

Conceptuel

Référence

UpdateLayeredWindow

Caractéristiques des fenêtres