AttachComponent

أجزاء المستند، البيانات المتغيرة، تحرير المستندات

الوصف

يستبدل لقطتي الحالة الأولية والحالية لـ TPDFlibDynamicComponentSession باستنساخين جديدين من مكوّن يملكه المستدعي ويمسح كل حالة التقدم

الصيغة

Function TPDFlibDynamicComponentSession.AttachComponent(
  AComponent: TPDFlibDynamicComponent): Integer;

المعاملات

`AComponent`	المكوّن المملوك من المستدعي الذي يوفر `CloneComponent` الخاص به كلتا اللقطتين الجديدتين: الأولية والحالية

ملاحظات

يُنشأ الاستنساخان قبل تحرير أي لقطة مخزنة، لذا فإن CloneComponent الذي يعيد Nil يترك المكوّن السابق وعدد التركيبات وعلامة الإكمال وحالة إعادة المحاولة دون مساس عند النجاح تحرر الجلسة لقطاتها القديمة وتخزن الزوج الجديد وتصفّر

CompositionCount و Completed و KeepTogetherRetryPending و LastRetryReason و LastRequiredSlotHeight لا تستولي الجلسة أبدًا على ملكية

AComponent

AttachComponent; يُخزَّنان الاستنساخان فقط، لذا يحتفظ المستدعي بالنسخة الممررة ويحررها باستقلال يستدعي باني الجلسة Nil، لذا تبدأ الجلسة المنشأة بمكوّن

مثال

Replacement := TNumberedPagesComponent.Create(1, 5);
try
  if Session.AttachComponent(Replacement) = 1 then
    Status := Session.ComposeNext(PageNumber, 36, 36, 540, 720,
      Placement);
finally
  Replacement.Free;
end;

قيم الإرجاع

`1`	أُنشئ الاستنساخان والتُزما بوصفهما اللقطتين الأولية والحالية الجديدتين مع مسح كل حالة التقدم
`0`	`AComponent` تساوي `Nil` أو أن إحدى استدعاءات `CloneComponent` أعادت `Nil`، وتُحفظ اللقطات والحالة السابقة

انظر أيضًا

TPDFlibDynamicComponentSession, TPDFlibDynamicComponent, CloneComponent, CloneCurrentComponent, ComposeNextLayout