PDFium Delphi Component Docs

Title Propriété

Composant: TPdf  ·  Unit: PDFium
Renvoie la valeur de l'entrée /Title du dictionnaire d'informations du document PDF

Syntax

property Title: WString; // read only

Description

Title renvoie le titre déclaré du document, c'est-à-dire la même chaîne qu'Acrobat affiche dans la barre de titre de l'application lorsque la préférence d'affichage "Display document title in title bar" est définie La valeur est récupérée via MetaText['Title'], qui appelle FPDF_GetMetaText de PDFium sur l'entrée /Title du dictionnaire d'informations du document (ISO 32000-1 § 14.3.3)

Si l'entrée est absente ou si le composant est inactif, la propriété renvoie un WString vide. Le titre est volontairement distinct du nom de base du fichier: un PDF fraîchement créé enregistré sous quarterly-2026.pdf peut tout à fait s'annoncer comme "Q1 2026 Financial Review" via l'entrée /Title

La propriété est en lecture seule. Définir un titre à la création se fait via FPDF_SetMetaText de PDFium en utilisant le Document, ou en écrivant un flux XMP de métadonnées (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