PDFium Component Docs

Title eigenschap

Component: TPdf  ·  Unit: PDFium
Retourneert de waarde van de vermelding /Title uit het informatie-woordenboek van het PDF-document

Syntax

property Title: WString; // read only

Description

Title retourneert de gedeclareerde titel van het document — dezelfde string die Acrobat toont in de titelbalk van de toepassing wanneer de viewervoorkeur “Documenttitel in titelbalk tonen” is ingesteld. De waarde wordt opgehaald via MetaText['Title'], dat de FPDF_GetMetaText van PDFium aanroept tegen de vermelding /Title van het informatie-woordenboek van het document (ISO 32000-1 § 14.3.3).

Als de vermelding ontbreekt of de component inactief is, retourneert de eigenschap een lege WString. De titel is opzettelijk verschillend van de bestandsnaam van het bestand: een vers geschreven PDF opgeslagen als quarterly-2026.pdf kan zich legitiem adverteren als “Q1 2026 Financial Review” via de vermelding /Title.

De eigenschap is alleen-lezen. Het instellen van een titel bij aanmaaktijd gebeurt via de FPDF_SetMetaText van PDFium met behulp van de Document-handle, of door een XMP-metagegevensstroom (dc:title) te schrijven.

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