ImportPageAsFormXObject
Манипуляция страницами, Form XObjects
Описание
Импортирует одну страницу из любого открытого документа в выбранный документ как независимый переиспользуемый Form XObject и возвращает дескриптор захваченной страницыДеревья страниц источника и цели остаются без изменений, содержимое страницы декодируется и сжимается один раз, а каждое последующее размещение записывает только ссылку на ресурс и операцию
Do
/GroupИмпорты между документами копируют унаследованное замыкание ресурсов и совместимые с Form записи /Metadata, /PieceInfo, /LastModified и
Синтаксис
Delphi
Function TPDFlib.ImportPageAsFormXObject(SourceDocumentID, SourcePage, Options: Integer): Integer;Параметры
| SourceDocumentID | Дескриптор документа, возвращенный операцией создания или загрузки документа; он может идентифицировать выбранный документ |
|---|---|
| SourcePage | Номер страницы, начиная с 1, в документе-источнике |
| Options | 0 использует поле медиа; 1 — поле обрезки с резервом поля медиа; 2 — поле выпуска за обрез с резервом полей обрезки и медиа; 3 — поле монтажа с резервом полей обрезки и медиа; 4 — поле иллюстраций с резервом полей обрезки и медиа |
Возвращаемые значения
| 0 | Дескриптор документа, номер страницы или параметр был недопустим, выбранное поле было непригодно либо ссылочный ресурс не удалось импортировать |
|---|---|
| Non-zero | Дескриптор захваченной страницы, принимаемый функциями рисования и конфигурации Form |
Примечания
Выбранное поле страницы становится границей Form, а унаследованный поворот страницы нормализуется в матрицу Form, включая ненулевые начала полейАннотации, поля форм, миниатюры, ссылки дерева страниц, элементы навигации и структурные номера родителей не являются графикой страницы и не импортируютсяВызовите эту функцию один раз и повторно используйте возвращенный дескриптор с
DrawCapturedPage, DrawCapturedPageMatrix, DrawRotatedCapturedPage, NewTilingPatternFromCapturedPage, SetCapturedPageOptional или SetCapturedPageTransparencyGroup