PDFium Component Docs

Keywords Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
Komponente: TPdf  ·  Unit: PDFium
Vom Autor bereitgestellte Keyword-Liste aus dem Info-Wörterbuch des Dokuments

Syntax

property Keywords: WString; // read only

Beschreibung

Keywords gibt den Eintrag /Keywords aus dem Dokument-Info-Wörterbuch zurück (PDF 1.7 spec section 14.3.3). Der Wert ist eine frei formulierte Textzeichenkette, die vom Autorentool geschrieben wird, und ist üblicherweise eine durch Kommas oder Semikolons getrennte Tag-Liste — z. B. "invoice; 2024; payable; vendor-acme" PDF lässt das Trennzeichen offen, daher müssen Anwendungen jedes vom Erzeuger geschriebene Format akzeptieren (Komma, Semikolon, Zeilenumbruch oder durch Leerzeichen getrennt).

Der Rückgabewert ist UTF-16-dekodiert; CJK- und andere nicht-ASCII-Keywords bleiben korrekt roundtrip-fähig. Die Zeichenkette ist leer, wenn Active False ist, wenn das Info-Wörterbuch fehlt oder wenn kein /Keywords zugewiesen wurde. Viele moderne Autorentools spiegeln Keywords außerdem in XMP-Metadaten unter pdf:Keywords oder dc:subject (einem Bag von RDF-Literalen); wenn beide vorhanden sind, sollten sie übereinstimmen, können aber nach Bearbeitungen auseinanderlaufen.

Keywords werden von Desktop-Suchindizes (Windows Explorer, Spotlight, Adobe Bridge) und von den meisten Dokumentenverwaltungssystemen angezeigt. PDFiumPas stellt nur die Kopie aus dem Info-Wörterbuch bereit — greifen Sie für denselben Wert über PDFiums generischen Metadatenzugriff auf MetaText['Keywords'] zu.

Hinweise

Beispiel

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

Siehe auch

Subject, Title, Author, MetaText