Функция EngStrokePath (winddi.h)

Функция EngStrokePath запрашивает обводку GDI указанного пути.

Синтаксис

ENGAPI BOOL EngStrokePath(
       SURFOBJ   *pso,
       PATHOBJ   *ppo,
       CLIPOBJ   *pco,
       XFORMOBJ  *pxo,
       BRUSHOBJ  *pbo,
       POINTL    *pptlBrushOrg,
  [in] LINEATTRS *plineattrs,
  [in] MIX       mix
);

Параметры

pso

Указатель на структуру SURFOBJ , описывающую поверхность, на которой выполняется рисование.

ppo

Указатель на структуру PATHOBJ . Подпрограммы службы PATHOBJ_Xxx предоставляются для перечисления линий, кривых Безье и других данных, составляющих путь. Это указывает, что должно быть нарисовано.

pco

Указатель на структуру CLIPOBJ . Подпрограммы службы CLIPOBJ_Xxx предоставляются для перечисления области клипа в виде набора прямоугольников. При необходимости все строки в пути можно перечислить предварительно с помощью этого CLIPOBJ. Это означает, что драйверы могут выполнять все вычисления обрезки строк.

pxo

Указатель на структуру XFORMOBJ . Это необходимо только в том случае, если требуется провести геометрическую широкую линию. Он задает преобразование, которое преобразует мировые координаты в координаты устройства. Это необходимо, так как путь указан в координатах устройства, а геометрическая широкая линия фактически расширяется в мировых координатах.

Драйвер может использовать процедуры службы XFORMOBJ_Xxx для определения преобразования.

pbo

Указатель на структуру BRUSHOBJ , которая указывает кисть, используемую при рисовании пути.

pptlBrushOrg

Указатель на структуру POINTL , содержащую источник кисти, используемый для выравнивания шаблона кисти на устройстве.

[in] plineattrs

Указатель на структуру LINEATTRS . Обратите внимание, что элемент elStyleState этой структуры должен обновляться как часть этой функции, если строка имеет стиль. Также обратите внимание, что элемент ptlLastPel той же структуры должен быть обновлен, если рисуется косметическая линия ширины в один пиксель.

[in] mix

Указывает, как объединить кисть с назначением.

Возвращаемое значение

Возвращаемое значение равно TRUE , если GDI обводит путь. Если драйвер должен обводить путь, возвращаемое значение равно FALSE и ошибка не регистрируется. Если GDI обнаруживает ошибку, возвращаемое значение DDI_ERROR, а код ошибки регистрируется в журнале.

Комментарии

Режим смешивания определяет, как входящий шаблон должен смешиваться с данными, уже имеющимися на поверхности устройства. Тип данных MIX состоит из двух значений ROP2, упакованных в один ULONG. Байт нижнего порядка определяет растровую операцию переднего плана; следующий байт определяет фоновую растровую операцию. Дополнительные сведения о кодах растровых операций см. в документации по Microsoft Windows SDK.

Требования

См. также раздел

CLIPOBJ

DrvStrokePath

LINEATTRS

PATHOBJ

SURFOBJ

XFORMOBJ