Subject - TPdf - PDFium Delphi Component

Komponenta: TPdf · Jedinica: PDFium

Vraća vrijednost unosa /Subject iz informacijskog rječnika PDF dokumenta

Sintaksa

property Subject: WString; // read only

Opis

Subject vraća unos /Subject iz informacijskog rječnika dokumenta — kratak, slobodno oblikovan opis teme dokumenta. Svojstvo delegira na MetaText['Subject'], koji za taj ključ poziva PDFiumov FPDF_GetMetaText Polje je definirano u ISO 32000-1 § 14.3.3 uz /Title, /Author i /Keywords

Kad dokument nema unos /Subject, kad još nije učitan ili kad referenca /Info u traileru u potpunosti nedostaje, svojstvo vraća prazan WString; ne baca se iznimka

Pojmovno /Subject odgovara na pitanje "o čemu je ovaj dokument?" dok /Title odgovara "kako se ovaj dokument zove?" U praksi mnogi proizvođači ostavljaju Subject praznim, pa ga tretirajte kao neobavezni dopunski tekst, a ne obavezno polje

Napomene

Za smislen (neprazan) rezultat zahtijeva da Active bude True; na neaktivnoj komponenti svojstvo vraća prazan niz bez bacanja iznimke
Pohranjen kao tekstualni niz u informacijskom rječniku koristeći PDFDocEncoding ili UTF-16BE. PDFium transparentno obavlja dekodiranje, pa vraćeni WString sadrži upotrebljiv Unicode bez obzira na podliježeći oblik bajtova
Odražava svojstvo XMP dc:description u XMP toku metapodataka. PDF/A dokumenti moraju držati obje reprezentacije usklađenima
Ako su vam potrebni bogatiji, strukturirani metapodaci (više jezika, autori, izjava o autorskim pravima), posegnite izravno za XMP paketom umjesto da preopterećujete polje Subject

Primjer

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;

Vidi također