Subject Proprietà

Subject restituisce la voce /Subject del dizionario information del documento — una breve descrizione libera di cosa tratta il documento. La proprietà delega a MetaText['Subject'], che invoca FPDF_GetMetaText di PDFium per quella chiave Il campo è definito in ISO 32000-1 § 14.3.3 accanto a /Title, /Author e /Keywords

Quando il documento non ha una voce /Subject, quando non è ancora caricato, o quando il riferimento /Info del trailer manca del tutto, la proprietà restituisce una WString vuota. Non viene sollevata alcuna eccezione

Concettualmente /Subject risponde a "di cosa si occupa questo documento?" mentre /Title risponde a "come si chiama questo documento?". In pratica molti produttori lasciano Subject in bianco, quindi trattalo come testo supplementare facoltativo anziché un campo obbligatorio

• Richiede Active a True per un risultato significativo (non vuoto); su un componente inattivo la proprietà restituisce una stringa vuota senza sollevare eccezioni
• È memorizzato come stringa di testo nel dizionario information usando PDFDocEncoding o UTF-16BE. PDFium gestisce la decodifica in modo trasparente, così la WString restituita contiene Unicode utilizzabile qualunque sia la forma a byte sottostante
• Rispecchia la proprietà XMP dc:description nello stream di metadati XMP. I documenti PDF/A devono tenere le due rappresentazioni sincronizzate
• Se ti servono metadati più ricchi e strutturati (più lingue, creatori, dichiarazione di copyright), vai direttamente al pacchetto XMP invece di sovraccaricare il campo Subject