PDFium Delphi Component Docs

Phương thức GetLinkedAnnotationIndex

Component: TPdf  ·  Unit: PDFium
Đi theo quan hệ /Popup hoặc /IRT của một chú thích trên trang hiện tại và trả về chỉ số trang của chú thích được liên kết

Syntax

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

AnnotIndexInteger. Chỉ số dựa từ 0 của chú thích trên trang hiện tại, trong khoảng 0 .. AnnotationCount - 1. Chỉ số ngoài khoảng sẽ phát sinh EPdfError
RelationshipTPdfAnnotationRelationship. parPopup đi theo mục /Popup (cửa sổ popup của một chú thích markup); parInReplyTo đi theo mục /IRT (chú thích mà chú thích này trả lời)
ResultInteger. Chỉ số trang của chú thích được liên kết trong 0 .. AnnotationCount - 1, hoặc -1 khi chú thích không có link như vậy

Description

Các chú thích markup có thể tham chiếu đến các chú thích khác. Một ghi chú văn bản giữ một cửa sổ popup trong /Popup, và một lời trả lời mang theo chú thích mà nó đáp lại trong /IRT. Lời gọi này phân giải một tham chiếu như vậy qua giao diện native (FPDFAnnot_GetLinkedAnnot) và chuyển handle chú thích được liên kết ngược thành chỉ số chú thích trang dùng khắp nơi, nhờ đó bên gọi có thể khảo sát nó qua Annotation

Khi chú thích không có mục cho quan hệ được yêu cầu, kết quả là -1. Đó là trường hợp bình thường — phần lớn chú thích không mang popup cũng như tham chiếu trả lời

Để đi qua toàn bộ một chuỗi trả lời thay vì một bước đơn, dùng GetLinkedAnnotationChain

Remarks

Example

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

See Also

GetLinkedAnnotationChain, Annotation, AnnotationCount