EnumPathElements
Извлечение, Манипуляции со страницами
Описание
Перечисляет каждый векторный контурный объект на странице по всем слоям содержимого. Каждая последовательность построения и закрашивания контура выносится в одну запись TPDFlibPageElement с Kind ekPath, ограничивающей рамкой, включающей контрольные точки кривых, количеством сегментов, флагом замкнутости и именем оператора закрашивания. Каждый элемент также получает снимок ElementID для последующих детальных запросов
Синтаксис
Delphi
Procedure TPDFlib.EnumPathElements(Page: Integer;
Var Elements: Array Of TPDFlibPageElement;
Var ElemIndex, TotalCount: Integer);Параметры
| Page | Номер страницы для перечисления, начиная с 1 |
|---|---|
| Elements | Выделенный вызывающим кодом массив записей TPDFlibPageElement, принимающий результаты; сохраняется не больше записей, чем вмещает массив |
| ElemIndex | Входо-выходной индекс; передайте 0 на входе, на выходе содержит число записей, сохранённых в Elements |
| TotalCount | Входо-выходной счётчик; на выходе содержит общее число найденных контуров, даже когда оно превышает ёмкость Elements |
Примечания
Координаты возвращаются в системе с началом в левом верхнем углу, используемой вспомогательными функциями элементов страницы. Сравните ElemIndex с TotalCount для обнаружения усечения или вызовите метод дважды, задав размер массива по первому проходу
О перечислении более высокого уровня, охватывающем также текст, изображения и размещения градиентов, см. EnumPageElements
Пример
Total:= 0;
SetLength(Elements, 0);
PDF.EnumPathElements(1, Elements, Count, Total);
SetLength(Elements, Total);
Count:= 0; Total:= 0;
PDF.EnumPathElements(1, Elements, Count, Total);