EMRGRADIENTFILL-Struktur (wingdi.h)

Artikel
08/27/2023

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

Syntax

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

Member

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. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
GRADIENT_FILL_RECT_H	In diesem Modus beschreiben zwei Endpunkte ein Rechteck. Das Rechteck ist so definiert, dass es eine konstante Farbe (angegeben durch die TRIVERTEX-Struktur ) für den linken und rechten Rand hat. GDI interpoliert die Farbe vom linken zum rechten Rand und füllt das Innere aus.
GRADIENT_FILL_RECT_V	In diesem Modus beschreiben zwei Endpunkte ein Rechteck. Das Rechteck ist so definiert, dass es eine konstante Farbe (angegeben durch die TRIVERTEX-Struktur ) für den oberen und unteren Rand hat. GDI interpoliert die Farbe vom oberen zum unteren Rand und füllt den Innenraum aus.
GRADIENT_FILL_TRIANGLE	In diesem Modus wird ein Array von TRIVERTEX-Strukturen zusammen mit einer Liste von Arrayindizes, die separate Dreiecke beschreiben, an GDI übergeben. GDI führt eine lineare Interpolation zwischen Dreiecksvertices durch und füllt das Innere aus. Das Zeichnen erfolgt direkt im Modus 24 und 32 bpp. Dithering wird im 16-, 8-, 4- und 1-bpp-Modus ausgeführt.

Ver[1]

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

Hinweise

Dies ist eine Struktur mit variabler Länge. Der Ver-Member gibt den Anfang des Bereichs mit variabler Länge an. Zuerst kommt ein Array von nVerTRIVERTEX-Strukturen , um die Scheitelpunkte zu übergeben. Als Nächstes folgt ein Array von nTriGRADIENT_TRIANGLE Strukturen oder nTriGRADIENT_RECT Strukturen, je nach Wert von ulMode (Dreiecke oder Rechtecke).

Diese Struktur soll während der Metadateiwiedergabe verwendet werden.

Anforderungen

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