PDFium Delphi Component Docs

Keywords Eigenschaft

Komponente: TPdf  ·  Unit: PDFium
Vom Autor bereitgestellte Keyword-Liste aus dem Info-Wörterbuch des Dokuments

Syntax

property Keywords: WString; // read only

Description

Keywords liefert den /Keywords-Eintrag aus dem Information-Dictionary des Dokuments (PDF 1.7 spec section 14.3.3). Der Wert ist eine Freitext-Zeichenkette, die das Autoren-Werkzeug schreibt, und nach Konvention eine komma- oder semikolongetrennte Liste von Tags — etwa "invoice; 2024; payable; vendor-acme" PDF lässt den Trenner offen, Anwendungen müssen also jedes Format akzeptieren, das der Produzent geschrieben hat (Komma, Semikolon, Zeilenumbruch oder Leerzeichen)

Der Rückgabewert ist als UTF-16 dekodiert; CJK- und andere Nicht-ASCII-Keywords durchlaufen den Kreislauf verlustfrei. Die Zeichenkette ist leer, wenn Active False ist, wenn das Info-Dictionary fehlt oder wenn kein /Keywords zugewiesen wurde. Viele moderne Autoren-Werkzeuge spiegeln Keywords zusätzlich in XMP-Metadaten unter pdf:Keywords oder dc:subject (ein Bag of RDF literals); sind beide vorhanden, sollten sie übereinstimmen, können nach Bearbeitungen aber auseinanderdriften

Desktop-Suchindexer (Windows Explorer, Spotlight, Adobe Bridge) und die meisten Dokumentenmanagementsysteme zeigen Keywords an. PDFium Delphi Component legt nur die Info-Dictionary-Kopie offen — MetaText['Keywords'] liefert denselben Wert über PDFiums generischen Metadata-Accessor

Remarks

Example

var Tags: TStringList;
Tags := TStringList.Create;
try
  Tags.Delimiter := ';';
  Tags.StrictDelimiter := True;
  Tags.DelimitedText := Pdf1.Keywords;
  ListBox1.Items.Assign(Tags);
finally
  Tags.Free;
end;

See Also

Subject, Title, Author, MetaText