Struttura UPDATELAYEREDWINDOWINFO (winuser.h)

  • Articolo

Usato da UpdateLayeredWindowIndirect per fornire informazioni su posizione, dimensioni, forma, contenuto e traslucenza per una finestra a più livelli.

Sintassi

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;

Members

cbSize

Tipo: DWORD

Dimensione, in byte, della struttura.

hdcDst

Tipo: HDC

Handle a un controller di dominio per lo schermo. Questo handle viene ottenuto specificando NULL in questo membro quando si chiama UpdateLayeredWindowIndirect. L'handle viene usato per la corrispondenza dei colori della tavolozza quando il contenuto della finestra viene aggiornato. Se hdcDst è NULL, viene usata la tavolozza predefinita.

Se hdcSrc è NULL, hdcDst deve essere NULL.

pptDst

Tipo: const POINT*

Nuova posizione dello schermo della finestra a più livelli. Se la nuova posizione rimane invariata rispetto alla posizione corrente, pptDst può essere NULL.

psize

Tipo: const SIZE*

Nuova dimensione della finestra a più livelli. Se le dimensioni della finestra non verranno modificate, questo parametro può essere NULL. Se hdcSrc è NULL, psize deve essere NULL.

hdcSrc

Tipo: HDC

Handle per il controller di dominio per la superficie che definisce la finestra a più livelli. Questo handle può essere ottenuto chiamando la funzione CreateCompatibleDC . Se la forma e il contesto visivo della finestra non cambiano, hdcSrc può essere NULL.

pptSrc

Tipo: const POINT*

Posizione del livello nel contesto del dispositivo. Se hdcSrc è NULL, pptSrc deve essere NULL.

crKey

Tipo: COLORREF

Chiave di colore da utilizzare per la composizione della finestra a più livelli. Per generare un COLORREF, utilizzare la macro RGB .

pblend

Tipo: const BLENDFUNCTION*

Valore di trasparenza da utilizzare per la composizione della finestra a più livelli.

dwFlags

Tipo: DWORD

Questo parametro può avere uno dei valori seguenti.

Valore Significato
ULW_ALPHA
0x00000002
 Usare pblend come funzione blend. Se la modalità di visualizzazione è di 256 colori o meno, l'effetto di questo valore corrisponde all'effetto di ULW_OPAQUE.
ULW_COLORKEY
0x00000001
 Usare crKey come colore di trasparenza.
ULW_OPAQUE
0x00000004
 Disegnare una finestra a livelli opaca.
ULW_EX_NORESIZE
0x00000008
 Forzare l'esito negativo della funzione UpdateLayeredWindowIndirect se le dimensioni correnti della finestra non corrispondono alle dimensioni specificate nella ssize.
 

Se hdcSrc è NULL, dwFlags deve essere zero.

prcDirty

Tipo: const RECT*

Area da aggiornare. Questo parametro può essere NULL. Se non è NULL, solo l'area in questo rettangolo viene aggiornata dal controller di dominio di origine.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione winuser.h (include Windows.h)

Vedi anche

Informazioni concettuali

Riferimento

UpdateLayeredWindow

Funzionalità delle finestre