PDFium Delphi Component Docs

Title-ominaisuus

Component: TPdf  ·  Unit: PDFium
Palauttaa /Title-merkinnän arvon PDF-dokumentin tietosanakirjasta

Syntax

property Title: WString; // read only

Description

Title palauttaa dokumentin ilmoittaman otsikon — saman merkkijonon, jonka Acrobat näyttää sovelluksen otsikkopalkissa, kun katseluohjelman asetus "Display document title in title bar" on käytössä Arvo haetaan MetaText['Title']-ominaisuudella, joka kutsuu PDFiumin FPDF_GetMetaText-funktiota dokumentin tietosanakirjan /Title-merkintään (ISO 32000-1 § 14.3.3)

Jos merkintä puuttuu tai komponentti ei ole aktiivinen, ominaisuus palauttaa tyhjän WString-arvon. Otsikko on tarkoituksella eri asia kuin tiedoston perusnimi: juuri laadittu ja nimellä quarterly-2026.pdf tallennettu PDF saa täysin laillisesti ilmoittaa itsensä nimellä "Q1 2026 Financial Review" /Title-merkinnän kautta

Ominaisuus on vain luku -muotoinen. Otsikon asettaminen luontivaiheessa tapahtuu PDFiumin FPDF_SetMetaText-funktiolla Document-kahvaa käyttäen tai kirjoittamalla XMP- metadatavirta (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