ComposeNext

چیدمان صفحه، صفحه‌بندی، Form XObjectها

توضیحات

یک قطعهٔ پویای وضعیت‌دار را با سیاست چیدمان پیش‌فرض در جایگاه صفحهٔ مقصد ترکیب می‌کند و جای‌گذاری نهایی را گزارش می‌دهد

نحو

Function TPDFlibDynamicComponentSession.ComposeNext(Page: Integer;
  Left, Top, Width, Height: Double;
  Out Placement: TPDFlibDynamicPagePlacement): Integer;

پارامترها

`Page`	شمارهٔ صفحهٔ مقصد موجود با مبنای یک
`Left`, `Top`	موقعیت بالا-چپ جایگاه مقصد در واحدهای جاری سند
`Width`, `Height`	اندازهٔ متناهی و مثبت جایگاه مقصد که اندازهٔ بوم طبیعی نیز می‌شود
`Placement`	رکورد جای‌گذاری صادره که قطعهٔ تثبیت‌شده را توصیف می‌کند

ملاحظات

فراخوان گزینه‌هایش را از طریق CreateLayoutOptions(Width, Height) می‌سازد و به ComposeNextLayout می‌سپارد؛ بنابراین مدیریت سرریز dopReject، تراز dhaLeft و dvaTop، صفحه‌بندی dppAllowSplit و نبود کمینهٔ فضای جریان را به ارث می‌برد مستطیل استفاده‌شده باید در جایگاه جا شود، زیرا سیاست پیش‌فرض سرریز رد می‌کند نه برش و نه مقیاس برای رفتار کامل جای‌گذاری، تلاش دوباره و تبدیل،

ComposeNextLayout را ببینید

مثال

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