ComposeNext
Верстка страниц, разбивка на страницы, Form XObjects
Описание
Компонует один динамический фрагмент с состоянием в слот целевой страницы, используя политику верстки по умолчанию, и сообщает итоговое размещение
Синтаксис
Function TPDFlibDynamicComponentSession.ComposeNext(Page: Integer;
Left, Top, Width, Height: Double;
Out Placement: TPDFlibDynamicPagePlacement): Integer;
Параметры
Page | Существующий номер целевой страницы, начиная с 1 |
|---|---|
Left, Top | Позиция левого верхнего угла целевого слота в текущих единицах документа |
Width, Height | Конечный положительный размер целевого слота, который также становится размером естественного холста |
Placement | Выдаваемая запись размещения, описывающая зафиксированный фрагмент |
Примечания
Вызов строит свои параметры через CreateLayoutOptions(Width, Height) и перенаправляет в ComposeNextLayout, поэтому наследует обработку переполнения dopReject, выравнивание dhaLeft и dvaTop, разбивку на страницы dppAllowSplit и отсутствие минимумов пространства потока
Используемый прямоугольник должен умещаться в слот, поскольку политика переполнения по умолчанию отклоняет, а не обрезает и не масштабирует
Полное описание размещения, повторов и преобразований см. в
Использованный прямоугольник должен помещаться в слот, поскольку политика переполнения по умолчанию отклоняет, а не обрезает и не масштабирует
Пример
repeat
Status := Session.ComposeNext(PageNumber, 36, 36, 540, 720,
Placement);
if Status = PDF_DYNAMIC_COMPONENT_MORE then
PageNumber := PDF.NewPage;
until Status <> PDF_DYNAMIC_COMPONENT_MORE;
Возвращаемые значения
PDF_DYNAMIC_COMPONENT_ERROR | Ввод, колбэк, геометрия, переполнение или проверка размещения не прошли без фиксации состояния |
|---|---|
PDF_DYNAMIC_COMPONENT_MORE | Фрагмент зафиксирован, и содержимое осталось |
PDF_DYNAMIC_COMPONENT_COMPLETE | Фрагмент завершил сеанс либо сеанс уже был завершен |
PDF_DYNAMIC_COMPONENT_RETRY | Политика разбивки на страницы или пространства потока отложила незафиксированную попытку в другой слот |
См. также
ComposeNextLayout, CreateLayoutOptions, TPDFlibDynamicComponentSession, Compose, Completed, CompositionCount