ComposeNext
تخطيط الصفحة، تقسيم الصفحات، Form XObjects
الوصف
يركّب جزءًا ديناميكيًا واحدًا ذا حالة في خانة صفحة وجهة باستخدام سياسة التخطيط الافتراضية ويعرض التموضع النهائي
الصيغة
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