PDFium Delphi Component Docs

Title властивість

Component: TPdf  ·  Unit: PDFium
Повертає значення запису /Title з словника інформації PDF-документа

Syntax

property Title: WString; // read only

Description

Title повертає заявлений заголовок документа — той самий рядок, який Acrobat показує в рядку заголовка застосунку, коли встановлено параметр перегляду "Display document title in title bar". Значення отримується через MetaText['Title'], який викликає FPDF_GetMetaText із PDFium проти запису /Title словника інформації документа (ISO 32000-1 § 14.3.3)

Якщо запис відсутній або компонент неактивний, властивість повертає порожній WString. Заголовок навмисно відрізняється від базового імені файлу: щойно створений PDF, збережений як quarterly-2026.pdf, може цілком правомірно оголошувати себе "Q1 2026 Financial Review" через запис /Title

Властивість доступна лише для читання. Задання заголовка під час створення виконується через FPDF_SetMetaText із PDFium з використанням дескриптора Document або шляхом запису потоку метаданих 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