Docs PDFiumPas

Title Proprietà

Questa voce API conserva identificatori, firme, blocchi di codice e termini PDF nella forma originale.
Componente: TPdf  ·  Unità: PDFium
Restituisce il valore della voce /Title dal dizionario informazioni del documento PDF.

Sintassi

property Title: WString; // read only

Descrizione

Title restituisce il titolo dichiarato del documento, la stessa stringa che Acrobat mostra nella barra del titolo dell'applicazione quando è impostata la preferenza di visualizzazione "Display document title in title bar". Il valore viene recuperato tramite MetaText['Title'], che chiama FPDF_GetMetaText di PDFium sulla voce /Title del dizionario informazioni del documento (ISO 32000-1 § 14.3.3).

Se la voce manca o il componente è inattivo, la proprietà restituisce un WString vuoto. Il titolo è volutamente distinto dal basename del file: un PDF appena creato e salvato come quarterly-2026.pdf può legittimamente presentarsi come "Q1 2026 Financial Review" tramite la voce /Title.

La proprietà è in sola lettura. Impostare un titolo al momento della creazione si fa tramite FPDF_SetMetaText di PDFium usando l'handle Document, oppure scrivendo uno stream di metadati XMP (dc:title).

Note

Esempio

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;

// Usa il titolo del documento per la didascalia del form.
Caption := EffectiveTitle(Pdf1, ExtractFileName(Pdf1.FileName));

Vedi anche

Author, Subject, Keywords, MetaText, CreationDate, Active