PDFium Component Docs

Title Egenskap

Denna API-post behåller identifierare, signaturer, kodblock och PDF-termer i ursprunglig form.
Komponent: TPdf  ·  Enhet: PDFium
Returnerar värdet av posten /Title från PDF-dokumentets info-ordbok

Syntax

property Title: WString; // read only

Beskrivning

Title returnerar dokumentets deklarerade titel — samma sträng som Acrobat visar i programmets titelrad när visningsinställningen "Display document title in title bar" är satt. Värdet hämtas via MetaText['Title'], som anropar PDFium:s FPDF_GetMetaText mot posten /Title i dokumentets info-ordbok (ISO 32000-1 § 14.3.3)

Om posten saknas eller komponenten är inaktiv returnerar egenskapen en tom WString. Titeln är avsiktligt skild från filens basnamn: en nyss skapad PDF som sparas som quarterly-2026.pdf kan fullt legitimt presentera sig som "Q1 2026 Financial Review" via posten /Title

Egenskapen är skrivskyddad. Att sätta en titel vid skapandet görs via PDFium:s FPDF_SetMetaText med Document-handtaget, eller genom att skriva en XMP-metadata-ström (dc:title)

Anmärkningar

Exempel

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;

// Använd dokumentets egen titel för formulärets rubrik
Caption := EffectiveTitle(Pdf1, ExtractFileName(Pdf1.FileName));

Se även

Author, Subject, Keywords, MetaText, CreationDate, Active