Структура EMRGRADIENTFILL (wingdi.h)

Статья
07/16/2024

Структура EMRGRADIENTFILL содержит элементы для записи GradientFill расширенной записи метафайла.

Синтаксис

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

Члены

emr

Базовая структура для всех типов записей.

rclBounds

Ограничивающий прямоугольник в единицах устройства.

nVer

Число вершин.

nTri

Число прямоугольников или треугольников, передаваемых в GradientFill.

ulMode

Режим градиентной заливки. Этот элемент может быть одним из следующих значений.

Ценность	Значение
GRADIENT_FILL_RECT_H	В этом режиме две конечные точки описывают прямоугольник. Прямоугольник определяется с константным цветом (заданным структурой TRIVERTEX) для левых и правых краев. GDI интерполирует цвет слева на правый край и заполняет интерьер.
GRADIENT_FILL_RECT_V	В этом режиме две конечные точки описывают прямоугольник. Прямоугольник определяется как константный цвет (указанный структурой TRIVERTEX) для верхних и нижних краев. GDI интерполирует цвет от верхнего до нижнего края и заполняет интерьер.
GRADIENT_FILL_TRIANGLE	В этом режиме массив структуры TRIVERTEX передается В GDI вместе со списком индексов массивов, описывающих отдельные треугольники. GDI выполняет линейную интерполяцию между вершинами треугольника и заполняет интерьер. Рисование выполняется непосредственно в режимах 24- и 32-bpp. Дитерирование выполняется в режиме 16-, 8-, 4-и 1-bpp.

Ver[1]

Массив структур TRIVERTEX, определяющих вершину.

Замечания

Это структура переменной длины. Элемент Ver обозначает начало области переменной длины. Сначала происходит массив nVerTRIVERTEX структуры для передачи вершин. Далее происходит массив структур nTriGRADIENT_TRIANGLE или nTriGRADIENT_RECT структур в зависимости от значения ulMode (треугольники или прямоугольники).

Эта структура должна использоваться во время воспроизведения метафайлов.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	wingdi.h (включая Windows.h)