PDFium Delphi Component Docs

Subject Propriété

Composant: TPdf  ·  Unit: PDFium
Renvoie la valeur de l’entrée /Subject depuis le dictionnaire d’informations du document PDF

Syntax

property Subject: WString; // read only

Description

Subject renvoie l'entrée /Subject du dictionnaire Info du document — une courte description libre de ce dont le document traite. La propriété délègue à MetaText['Subject'], qui appelle FPDF_GetMetaText de PDFium pour cette clé. Le champ est défini dans ISO 32000-1 § 14.3.3 aux côtés de /Title, /Author et /Keywords

Lorsque le document ne possède pas d'entrée /Subject, lorsqu'il n'est pas encore chargé ou lorsque la référence /Info du trailer est entièrement absente, la propriété renvoie un WString vide. Aucune exception n'est levée

Conceptuellement, /Subject répond à la question « de quoi s'agit-il ? » tandis que /Title répond à « quel est le nom du document ? ». En pratique, de nombreux producteurs laissent Subject vide ; traitez donc ce champ comme un texte complémentaire facultatif plutôt que comme un champ obligatoire

Remarks

Example

procedure TForm1.DumpMetadataToGrid;
begin
  Pdf1.Active := True;
  StringGrid1.Cells[0, 0] := 'Field';
  StringGrid1.Cells[1, 0] := 'Value';
  StringGrid1.Cells[0, 1] := 'Title';
  StringGrid1.Cells[1, 1] := Pdf1.Title;
  StringGrid1.Cells[0, 2] := 'Subject';
  StringGrid1.Cells[1, 2] := Pdf1.Subject;
  StringGrid1.Cells[0, 3] := 'Author';
  StringGrid1.Cells[1, 3] := Pdf1.Author;
end;

See Also

Title, Author, Keywords, Creator, MetaText