Структура 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) |