PDFium Delphi Component Docs

Title Proprietà

Componente: TPdf  ·  Unità: PDFium
Restituisce il valore della voce /Title dal dizionario informazioni del documento PDF.

Syntax

property Title: WString; // read only

Description

Title restituisce il titolo dichiarato dal documento — la stessa stringa che Acrobat mostra nella barra del titolo dell'applicazione quando la preferenza di visualizzazione "Visualizza il titolo del documento nella barra del titolo" è attiva Il valore viene letto tramite MetaText['Title'], che chiama FPDF_GetMetaText di PDFium sulla voce /Title del dizionario information del documento (ISO 32000-1 § 14.3.3)

Se la voce manca o il componente è inattivo, la proprietà restituisce una WString vuota. Il titolo è volutamente distinto dal nome base del file: un PDF appena creato e salvato come trimestre-2026.pdf può legittimamente dichiararsi "Riesame finanziario Q1 2026" tramite la voce /Title

La proprietà è in sola lettura. Impostare un titolo alla creazione si fa tramite FPDF_SetMetaText di PDFium usando l'handle Document, oppure scrivendo uno stream di metadati XMP (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