UPDATELAYEREDWINDOWINFO-Struktur (winuser.h)

  • Artikel

Wird von UpdateLayeredWindowIndirect verwendet, um Informationen zu Position, Größe, Form, Inhalt und Transparenz für ein mehrstufiges Fenster bereitzustellen.

Syntax

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;

Member

cbSize

Art: DWORD

Die Größe (in Bytes) dieser Struktur.

hdcDst

Typ: HDC

Ein Handle für einen DC für den Bildschirm. Dieses Handle wird abgerufen, indem null in diesem Member angegeben wird, wenn UpdateLayeredWindowIndirect aufgerufen wird. Das Ziehpunkt wird für den Farbabgleich der Palette verwendet, wenn der Fensterinhalt aktualisiert wird. Wenn hdcDstNULL ist, wird die Standardpalette verwendet.

Wenn hdcSrcNULL ist, muss hdcDstNULL sein.

pptDst

Typ: const POINT*

Die neue Bildschirmposition des mehrschichtigen Fensters. Wenn die neue Position gegenüber der aktuellen Position unverändert ist, kann pptDstNULL sein.

psize

Typ: const SIZE*

Die neue Größe des mehrschichtigen Fensters. Wenn sich die Größe des Fensters nicht ändert, kann dieser Parameter NULL sein. Wenn hdcSrcNULL ist, muss psizeNULL sein.

hdcSrc

Typ: HDC

Ein Handle zum DC für die Oberfläche, die das mehrschichtige Fenster definiert. Dieses Handle kann durch Aufrufen der CreateCompatibleDC-Funktion abgerufen werden. Wenn sich die Form und der visuelle Kontext des Fensters nicht ändern, kann hdcSrcNULL sein.

pptSrc

Typ: const POINT*

Die Position der Ebene im Gerätekontext. Wenn hdcSrcNULL ist, sollte pptSrcNULL sein.

crKey

Typ: COLORREF

Der Farbschlüssel, der beim Komponieren des mehrschichtigen Fensters verwendet werden soll. Verwenden Sie zum Generieren einer COLORREF das RGB-Makro .

pblend

Typ: const BLENDFUNCTION*

Der Transparenzwert, der beim Komponieren des mehrschichtigen Fensters verwendet werden soll.

dwFlags

Art: DWORD

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
ULW_ALPHA
0x00000002
 Verwenden Sie Pblend als Blendfunktion. Wenn der Anzeigemodus 256 Farben oder weniger beträgt, ist die Auswirkung dieses Werts identisch mit der Auswirkung von ULW_OPAQUE.
ULW_COLORKEY
0x00000001
 Verwenden Sie crKey als Transparenzfarbe.
ULW_OPAQUE
0x00000004
 Zeichnen Sie ein undurchsichtiges mehrschichtiges Fenster.
ULW_EX_NORESIZE
0x00000008
 Erzwingen, dass die UpdateLayeredWindowIndirect-Funktion fehlschlägt, wenn die aktuelle Fenstergröße nicht mit der in psize angegebenen Größe übereinstimmt.
 

Wenn hdcSrcNULL ist, sollte dwFlags null sein.

prcDirty

Typ: const RECT*

Der zu aktualisierende Bereich. Dieser Parameter kann NULL sein. Wenn es nicht NULL ist, wird nur der Bereich in diesem Rechteck vom Quelldomänencontroller aktualisiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile winuser.h (windows.h einschließen)

Siehe auch

Konzept

Referenz

UpdateLayeredWindow

Fensterfeatures