PDFium Delphi Component Docs

GetLinkedAnnotationIndex الطريقة

المكوّن: TPdf  ·  الوحدة: PDFium
يتبع علاقة /Popup أو /IRT لتعليق توضيحي على الصفحة الحالية ويعيد فهرس الصفحة للتعليق التوضيحي المترابط

الصياغة

function GetLinkedAnnotationIndex(AnnotIndex: Integer; Relationship: TPdfAnnotationRelationship): Integer;

AnnotIndexInteger. فهرس صفري الأساس للتعليق التوضيحي على الصفحة الحالية، في المدى 0 .. AnnotationCount - 1. والفهرس خارج المدى يرفع EPdfError
RelationshipTPdfAnnotationRelationship. يتبع parPopup مدخل /Popup (نافذة المنبثق لتعليق توضيحي ترميزي)، ويتبع parInReplyTo مدخل /IRT (التعليق التوضيحي الذي يردّ عليه هذا التعليق)
ResultInteger. فهرس الصفحة للتعليق التوضيحي المترابط في 0 .. AnnotationCount - 1، أو -1 عندما لا يملك التعليق رابطًا من هذا النوع

الوصف

تستطيع التعليقات التوضيحية الترميزية الإحالة إلى تعليقات أخرى: ملاحظة النص تحتفظ بنافذة منبثقة في /Popup، والرد يحمل التعليق التوضيحي الذي يجيب عنه في /IRT. يحل هذا الاستدعاء إحالة من هذا النوع عبر الواجهة الأصلية (FPDFAnnot_GetLinkedAnnot) ويرجم مقبض التعليق المترابط ثانيةً إلى فهرس تعليق الصفحة المستخدم في كل مكان آخر، ليستطيع المستدعي فحصه عبر Annotation

عندما لا يملك التعليق التوضيحي مدخلًا للعلاقة المطلوبة تكون النتيجة -1، وهذه هي الحالة الاعتيادية؛ فمعظم التعليقات التوضيحية لا تحمل منبثقًا ولا إحالة رد

ولمشي سلسلة ردود كاملة بدلًا من قفزة واحدة استخدم GetLinkedAnnotationChain

ملاحظات

مثال

var
  PopupIndex: Integer;
begin
  PopupIndex := Pdf1.GetLinkedAnnotationIndex(3, parPopup);
  if PopupIndex >= 0 then
    Memo1.Lines.Add(Pdf1.Annotation[PopupIndex].ContentsText);
end;

انظر أيضًا

GetLinkedAnnotationChain, Annotation, AnnotationCount