Subject Propiedad

Subject devuelve la entrada /Subject del diccionario de información del documento — una descripción corta y de forma libre de lo que el documento trata. La propiedad delega en MetaText['Subject'], que invoca FPDF_GetMetaText de PDFium para esa clave El campo se define en ISO 32000-1 § 14.3.3 junto con /Title, /Author y /Keywords

Cuando el documento no tiene entrada /Subject, cuando aún no está cargado, o cuando la referencia /Info del trailer falta por completo, la propiedad devuelve un WString vacío. No se genera ninguna excepción

Conceptualmente /Subject responde "¿de qué trata este documento?" mientras que /Title responde "¿cómo se llama este documento?". En la práctica muchos productores dejan Subject en blanco, de modo que trátelo como texto suplementario opcional en lugar de un campo requerido

• Requiere Active en True para un resultado significativo (no vacío); en un componente inactivo la propiedad devuelve una cadena vacía sin generar error
• Se almacena como una cadena de texto en el diccionario de información usando PDFDocEncoding o UTF-16BE. PDFium maneja la decodificación de forma transparente, de modo que el WString devuelto contiene Unicode utilizable sin importar la forma de byte subyacente
• Refleja la propiedad XMP dc:description en el flujo de metadatos XMP. Los documentos PDF/A deben mantener ambas representaciones sincronizadas
• Si necesita metadatos estructurados más ricos (múltiples idiomas, creadores, declaración de copyright), acceda al paquete XMP directamente en lugar de sobrecargar el campo Subject