PDFium Delphi Component Docs

Title Eigenschaft

Komponente: TPdf  ·  Unit: PDFium
Gibt den Wert des Eintrags /Title aus dem Informationswörterbuch des PDF-Dokuments zurück

Syntax

property Title: WString; // read only

Description

Title liefert den deklarierten Titel des Dokuments — dieselbe Zeichenkette, die Acrobat in der Titelzeile der Anwendung zeigt, wenn die Viewer-Einstellung "Display document title in title bar" gesetzt ist Der Wert kommt über MetaText['Title'] zustande, das PDFiums FPDF_GetMetaText gegen den /Title-Eintrag des Document-Information-Dictionarys aufruft (ISO 32000-1 § 14.3.3)

Fehlt der Eintrag oder ist die Komponente inaktiv, liefert die Eigenschaft einen leeren WString. Der Titel ist bewusst zu unterscheiden vom Basisnamen der Datei: Ein frisch erstelltes PDF, gespeichert als quarterly-2026.pdf, darf sich über den /Title-Eintrag getrost als "Q1 2026 Financial Review" ausgeben

Die Eigenschaft ist read-only. Einen Titel zur Erzeugungszeit setzt man über PDFiums FPDF_SetMetaText mit dem Document-Handle oder über das Schreiben eines XMP- Metadaten-Streams (dc:title)

Remarks

Example

function EffectiveTitle(Pdf1: TPdf; const Fallback: string): string;
begin
  if not Pdf1.Active then
    Pdf1.Active := True;
  Result := Trim(Pdf1.Title);
  if Result = '' then
    Result := Fallback;
end;

// Use the document's own title for the form caption.
Caption := EffectiveTitle(Pdf1, ExtractFileName(Pdf1.FileName));

See Also

Author, Subject, Keywords, MetaText, CreationDate, Active