PDFium Delphi Component Docs

Subject-ominaisuus

Komponentti: TPdf  ·  Yksikkö: PDFium
Palauttaa /Subject-merkinnän arvon PDF-dokumentin tietosanakirjasta.

Syntax

property Subject: WString; // read only

Description

Subject palauttaa dokumentin /Subject-tietosanakirjamerkinnän — lyhyen, vapaamuotoisen kuvauksen siitä, mistä dokumentti kertoo. Ominaisuus delegoi MetaText['Subject']-kohteelle, joka kutsuu PDFiumin FPDF_GetMetaText-funktiota tuolle avaimelle. Kenttä on määritelty ISO 32000-1 § 14.3.3:ssa /Title-, /Author- ja /Keywords-merkintöjen rinnalla.

Kun dokumentilla ei ole /Subject-merkintää, kun sitä ei ole vielä ladattu tai kun trailerin /Info-viite puuttuu kokonaan, ominaisuus palauttaa tyhjän WString-arvon. Poikkeusta ei nosteta.

Käsitteellisesti /Subject vastaa kysymykseen "mikä tämä dokumentti on?", kun taas /Title vastaa "mikä tämän dokumentin nimi on?". Käytännössä monet tuottajat jättävät Subject-kentän tyhjäksi, joten käsittele sitä valinnaisena täydentävänä tekstinä pakollisen kentän sijaan.

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