EMRGRADIENTFILL, structure (wingdi.h)

Article
07/16/2024

La structure EMRGRADIENTFILL contient des membres pour l’enregistrement de métafichier amélioré de GradientFill.

Syntaxe

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

Membres

emr

Structure de base pour tous les types d’enregistrements.

rclBounds

Rectangle englobant, en unités d’appareil.

nVer

Nombre de sommets.

nTri

Nombre de rectangles ou de triangles à passer à GradientFill.

ulMode

Mode de remplissage dégradé. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
GRADIENT_FILL_RECT_H	Dans ce mode, deux points de terminaison décrivent un rectangle. Le rectangle est défini pour avoir une couleur constante (spécifiée par la structure TRIVERTEX) pour les bords gauche et droit. GDI interpole la couleur du bord gauche à droite et remplit l’intérieur.
GRADIENT_FILL_RECT_V	Dans ce mode, deux points de terminaison décrivent un rectangle. Le rectangle est défini pour avoir une couleur constante (spécifiée par la structure TRIVERTEX) pour les bords supérieur et inférieur. GDI interpole la couleur du haut au bord inférieur et remplit l’intérieur.
GRADIENT_FILL_TRIANGLE	Dans ce mode, un tableau de structures TRIVERTEX est passé à GDI, ainsi qu’une liste d’index de tableau qui décrivent des triangles distincts. GDI effectue une interpolation linéaire entre les sommets de triangle et remplit l’intérieur. Le dessin est effectué directement dans les modes 24 et 32 bpp. Le dithering est effectué en mode 16-, 8-, 4-et 1-bpp.

Ver[1]

Tableau de structures TRIVERTEX qui définissent chacun un sommet.

Remarques

Il s’agit d’une structure de longueur variable. Le membre Ver désigne le début de la zone de longueur variable. Il s’agit tout d’abord d’un tableau de structures nVerTRIVERTEX pour passer les sommets. Vient ensuite un tableau de structures nTriGRADIENT_TRIANGLE ou structures nTriGRADIENT_RECT, selon la valeur de ulMode (triangles ou rectangles).

Cette structure doit être utilisée pendant la lecture du métafichier.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	wingdi.h (include Windows.h)