Поделиться через

Структура CLIPOBJ (winddi.h)

  • Статья

Структура CLIPOBJ описывает обрезную область, используемую при рисовании.

Синтаксис

typedef struct _CLIPOBJ {
  ULONG iUniq;
  RECTL rclBounds;
  BYTE  iDComplexity;
  BYTE  iFComplexity;
  BYTE  iMode;
  BYTE  fjOptions;
} CLIPOBJ;

Члены

iUniq

Задает значение, однозначно определяющее обрезную область. Если iUniq не является нулевым, драйвер использует его в качестве идентификатора кэша. Это позволяет драйверу распознавать регион после скачивания и кэширования. Если значение равно нулю, драйвер не должен кэшировать регион, так как этот регион не будет использоваться повторно.

rclBounds

Задает структуру RECTL , ограничивающую часть области, пересекающую документ. Если iDComplexity является DC_RECT, то это прямоугольник обрезки, который следует рассмотреть.

iDComplexity

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

Значение Значение
DC_COMPLEX Область клипа должна быть перечислена.
DC_RECT Обрезка по одному прямоугольнику.
DC_TRIVIAL Обрезка не должна рассматриваться; нарисовать всю фигуру.

iFComplexity

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

Значение Значение
FC_COMPLEX Область состоит из более чем четырех прямоугольников.
FC_RECT Область представляет собой один прямоугольник.
FC_RECT4 Область состоит не более чем из четырех прямоугольников.

iMode

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

Значение Значение
TC_PATHOBJ Регион хранится в виде пути.
TC_RECTANGLES Область хранится в виде прямоугольников.

fjOptions

Задает параметры обрезки. Этот элемент может иметь следующее значение:

Значение Значение
OC_BANK_CLIP Устарело. Указывает обратный вызов подсистемы для банковского устройства.

Комментарии

Область, описанная CLIPOBJ, может быть перечислена в виде ряда прямоугольников.

Требования

   
Верхняя часть winddi.h (включая Winddi.h)

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

CLIPOBJ_bEnum

CLIPOBJ_cEnumStart

RECTL