17 workbook.set_custom_property()

set_custom_property(name, value[, property_type]) 设置自定义文档属性。

• Parameters:
  • name (字符串) – 自定义属性的名称；
  • value – 自定义属性的值（多种数据类型）。
  • property_type (字符串) – 属性的类型，可选。

set_custom_property()方法用于设置上一节set_properties()方法中未包含的文档属性。例如：

date = datetime.strptime('2016-12-12', '%Y-%m-%d')

workbook.set_custom_property('Checked by',       'Eve')
workbook.set_custom_property('Date completed',   date)
workbook.set_custom_property('Document number',  12345)
workbook.set_custom_property('Reference number', 1.2345)
workbook.set_custom_property('Has review',       True)
workbook.set_custom_property('Signed off',       False)

日期参数需要为datetime.datetime对象。

可选参数property_type可以为自定义属性设置显式的类型，就像在Excel中一样。可用的类型有：

text
date
number
bool

不过，几乎在所有情况下，Python都能正确推断出该类型。

> 注意：Excel中name和value参数的值限制为255个字符。