InsertPageElementClipPath
Редактирование потоков содержимого, обтравочные контуры
Описание
Добавляет обтравочный контур с ненулевым числом обходов или четно-нечетный, затрагивающий только один точный перечисленный элемент текста, изображения или контура
Синтаксис
Delphi
Function TPDFlib.InsertPageElementClipPath(ElementID: Integer; Const PathSource: WideString; FillRule: Integer): Integer;Параметры
| ElementID | Непрозрачный дескриптор элемента страницы, возвращенный EnumPageElements или EnumeratePageElements |
|---|---|
| PathSource | Только инструкции построения контура, начинающиеся с m или re и исключающие W, W* и операторы отрисовки контуров |
| FillRule | 0 для правила ненулевого числа обходов или 1 для четно-нечетного правила |
Возвращаемые значения
| 1 | Локальный обтравочный контур вставлен, и все дескрипторы элементов страницы признаны недействительными |
|---|---|
| 0 | Дескриптор или источник контура недопустим, дескриптор устарел либо текстовое состояние не может быть безопасно восстановлено |
Примечания
Метод записывает сбалансированную область видимости q/Q вокруг цели, чтобы новое пересечение не могло просочиться в последующее содержимое страницыКоординаты
Координаты PathSource используют текущее пользовательское пространство в цели; перечисленные сегменты отсечения и границы используют пространство пользователя по умолчанию после активной CTM
Для цели внутри текстового объекта метод создает корректные окружающие текстовые объекты и воспроизводит исходный невидимый сдвиг, поэтому извлечение текста и последующее позиционирование остаются неизменными
Режимы отображения текста, добавляющие контуры глифов в отсечение, доступны только для чтения, поскольку их изоляция изменила бы постоянную семантику отсечения
LastErrorCode: 532 означает недопустимый ввод, 533 — устаревшее содержимое, 534 — цель нельзя безопасно отредактировать