EMRGRADIENTFILL-Struktur (wingdi.h)

Artikel
07/16/2024

Die EMRGRADIENTFILL--Struktur enthält Elemente für den GradientFill- erweiterten Metadateidatensatz.

Syntax

typedef struct tagEMRGRADIENTFILL {
  EMR       emr;
  RECTL     rclBounds;
  DWORD     nVer;
  DWORD     nTri;
  ULONG     ulMode;
  TRIVERTEX Ver[1];
} EMRGRADIENTFILL, *PEMRGRADIENTFILL;

Angehörige

emr

Die Basisstruktur für alle Datensatztypen.

rclBounds

Das umgebende Rechteck in Geräteeinheiten.

nVer

Die Anzahl der Scheitelpunkte.

nTri

Die Anzahl der Rechtecke oder Dreiecke, die an GradientFill-übergeben werden sollen.

ulMode

Der Farbverlaufsfüllmodus. Dieses Element kann einer der folgenden Werte sein:

Wert	Bedeutung
GRADIENT_FILL_RECT_H	In diesem Modus beschreiben zwei Endpunkte ein Rechteck. Das Rechteck wird definiert, um für die linken und rechten Ränder eine Konstante (durch die TRIVERTEX- Struktur angegeben) zu haben. GDI interpoliert die Farbe von links nach rechts und füllt das Innere.
GRADIENT_FILL_RECT_V	In diesem Modus beschreiben zwei Endpunkte ein Rechteck. Das Rechteck wird definiert, um für die oberen und unteren Ränder eine Konstante (durch die TRIVERTEX- Struktur angegeben) zu haben. GDI interpoliert die Farbe vom oberen zum unteren Rand und füllt das Innere.
GRADIENT_FILL_TRIANGLE	In diesem Modus wird ein Array von TRIVERTEX- Strukturen zusammen mit einer Liste von Arrayindizes übergeben, die separate Dreiecke beschreiben. GDI führt eine lineare Interpolation zwischen Dreiecksvertices durch und füllt das Innere. Zeichnung erfolgt direkt in den Modi 24- und 32-bpp. Dithering wird im 16-, 8-, 4- und 1-bpp-Modus durchgeführt.

Ver[1]

Ein Array von TRIVERTEX- Strukturen, die jeweils einen Scheitelpunkt definieren.

Bemerkungen

Dies ist eine Struktur mit variabler Länge. Das Ver--Element bestimmt den Anfang des Bereichs variabler Länge. Zuerst kommt ein Array von nVerTRIVERTEX Strukturen, um die Scheitelpunkte zu übergeben. Als Nächstes kommt ein Array von nTriGRADIENT_TRIANGLE Strukturen oder nTri-GRADIENT_RECT Strukturen, abhängig vom Wert von ulMode- (Dreiecke oder Rechtecke).

Diese Struktur soll während der Metadateiwiedergabe verwendet werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	wingdi.h (enthalten Windows.h)