PDFium Delphi Component Docs

AnnotationCount Eigenschaft

Komponente: TPdf  ·  Unit: PDFium
Anzahl der Anmerkungsobjekte auf der aktuell aktiven Seite

Syntax

property AnnotationCount: Integer; // read only

Description

AnnotationCount liefert die Länge des /Annots-Arrays der aktuellen Seite (PDF 1.7 spec section 12.5). Alle Annotationstypen werden gezählt — Textnotizen, Highlights, Unterstreichungen, Free-Text, Ink, Stamps, Polygon- und Polyline-Formen, Link-Annotationen, Popup-Dialoge und Formular-Widget-Annotationen. Kombinieren Sie die Werte aller Seiten, um die Annotation-Gesamtanzahl des Dokuments zu erhalten

Die Eigenschaft verlangt, dass Active True ist, und liest von der durch PageNumber angegebenen Seite. Hat die Seite keine Annotationen oder ist kein Dokument geladen, ist der Wert 0. Mit Annotation[Index] und Indizes von 0 bis AnnotationCount - 1 holen Sie einen TPdfAnnotation-Record, der Subtyp, umgebendes Rechteck, Farbe, Flag-Bitmaske und Inhaltstext jedes Eintrags beschreibt

Das Iterieren über Annotationen ist O(n), aber jeder Annotation[Index]-Aufruf öffnet ein neues PDFium-Handle und dekodiert die Unicode-Inhalte bei Bedarf; cachen Sie das Ergebnis, wenn Sie es mehrfach brauchen. Änderungen an den Annotationen einer Seite (Einfügen, Löschen) machen Indizes ungültig — starten Sie die Schleife neu oder lesen Sie AnnotationCount nach der Änderung erneut

Remarks

Example

var I: Integer;
var A: TPdfAnnotation;
for I := 0 to Pdf1.AnnotationCount - 1 do
begin
  A := Pdf1.Annotation[I];
  Memo1.Lines.Add(Format('%d: subtype=%d text=%s',
    [I, Ord(A.Subtype), A.ContentsText]));
end;

See Also

Annotation, LinkAnnotationCount, FormFieldCount, PageNumber