PDFium Component Docs

Subject eigenschap

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

Syntax

property Subject: WString; // read only

Description

Subject retourneert de vermelding /Subject uit het info-woordenboek van het document — een korte, vrije-vorm beschrijving van waar het document over gaat. De eigenschap delegeert naar MetaText['Subject'], dat de FPDF_GetMetaText van PDFium voor die sleutel aanroept. Het veld is gedefinieerd in ISO 32000-1 § 14.3.3 naast /Title, /Author en /Keywords.

Wanneer het document geen vermelding /Subject heeft, wanneer het nog niet is geladen, of wanneer de /Info-referentie van de trailer geheel ontbreekt, retourneert de eigenschap een lege WString. Er wordt geen exceptie opgegooid.

Conceptueel beantwoordt /Subject “wat is dit document?” terwijl /Title beantwoordt “hoe is dit document genaamd?”. In de praktijk laten veel producenten Subject leeg, dus behandel het als optionele aanvullende tekst in plaats van een verplicht veld.

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