文档属性

文档属性可用于识别有关文档的一些有用的详细信息，如作者、主题、类别、注释、创建日期、上次保存时间等。GcExcel支持存储内置和自定义文档属性，这些属性可被导出成Excel文档查看。一些内置属性也可以导出为PDF文档，如作者、标题、主题、注释、创建日期和上次保存时间。

注意： 要了解有关PDF中支持的文档属性的更多信息，请参阅支持文档属性页面。

The IDocumentProperty 接口用来表示文档属性，并提供以下方法：

• getType/setType:设置或获取文档属性的类型。

• addLinkToContent: 添加用于连接到具体内容的链接。

• getLinkSource/setLinkSource: 设置或者获取链接内容的源数据。

• getName/setName: 设置或获取名称。

• getValue/setValue: 设置或获取值。

BuiltInDocumentPropertyCollection是IWorkbook接口的内置属性。该属性可以通过getBuiltInDocumentProperties方法获取并设置任何内置属性（如Author、Subject等）的值。

IWorkbook接口的CustomDocumentPropertyCollection提供重载的add方法和addLinkToContent方法。重载的add方法可用于创建具有字符串、布尔值、日期时间、双精度或整数值的自定义文档属性。addLinkToContent方法可用于创建一个新的文档属性，这个属性会被链接到已命名的单元格。它提供'name'和'source'参数，其中'source'是命名的范围。如果删除了命名范围，最后一个值会被会被存储在自定义特性中。如果命名范围引用多个单元格，则使用左上角单元格的值。

请参阅以下示例代码以设置作者和公司（内置属性）并添加自定义文档属性

//create a new workbook
Workbook workbook = new Workbook();
IWorksheet worksheet = workbook.getWorksheets().get(0);
worksheet.getRange("A1").setValue("hello");

// Add a defined name.
workbook.getNames().add("Headings", "=Sheet1!$A$1");

// Set values for built-in document properties
workbook.getBuiltInDocumentProperties().setAuthor("Beryl");
workbook.getBuiltInDocumentProperties().setCompany("GrapeCity");

// Add a custom document property.
IDocumentProperty property = workbook.getCustomDocumentProperties().addLinkToContent("aaa", "Headings");
Object value = property.getValue(); // The value is "Hello".
System.out.println(value);
PropertyType type = property.getType(); // The Type is String.
System.out.println(type);
    
//save to an excel file
workbook.save("DocumentProperties.xlsx");

限制

GcExcel不支持以下文档属性。

• 字符数

• 字节数

• 行数

• 段落数

• 幻灯片数

• Notes的数量

• 隐藏的幻灯片数

• 多媒体剪辑数

• 字符数（带空格）