共享类

长度对象

长度值 python-docx 表示为标准化 Length 值对象。 Length 是的子类 int ,具有 int . 此外,它还具有内置的单位转换属性,例如:

>>> inline_shape.height
914400
>>> inline_shape.height.inches
1.0

Length对象是使用一系列方便的构造函数构造的,允许用最适合上下文的单位来表示值。

class docx.shared.Length(emu)[源代码]

长度构造函数类英寸、厘米、毫米、PX和Emu的基类。

行为为英制公制单位的整数计数,英寸为914,400,毫米为36,000。以只读属性的形式提供方便的单位转换方法。一成不变。

property cm

以厘米(float)表示的等效长度。

property emu

以英制公制单位(int)表示的等效长度。

property inches

以英寸(浮点)表示的等效长度。

property mm

以毫米(浮点)表示的等效长度。

property pt

浮点长度(以点为单位)。

property twips

以twips(int)表示的等效长度。

class docx.shared.Inches(inches)[源代码]

长度单位为英寸的方便构造器,例如。 width = Inches(0.5) .

class docx.shared.Cm(cm)[源代码]

长度以厘米为单位的方便构造函数,例如。 height = Cm(12) .

class docx.shared.Mm(mm)[源代码]

长度单位为毫米的方便构造器,例如。 width = Mm(240.5) .

class docx.shared.Pt(points)[源代码]

用于指定以磅为单位的长度的便利值类。

class docx.shared.Twips(twips)[源代码]

TWIPS中用于长度的方便构造函数,例如 width = Twips(42)

一个twip是二十分之一分,635个动车组。

class docx.shared.Emu(emu)[源代码]

以英制公制单位表示长度的方便构造函数,例如。 width = Emu(457200) .

RGBColor 对象

class docx.shared.RGBColor(r, g, b)[源代码]

定义特定RGB颜色的不可变值对象。

rg ,以及 b 均为0-255范围内的整数(含0-255)。使用十六进制整数记数法,例如 0x42 在使用十六进制RGB值的情况下可能会增强可读性:

>>> lavender = RGBColor(0xff, 0x99, 0xcc)
classmethod from_string(rgb_hex_str)[源代码]

从一个RGB颜色十六进制字符串返回一个新实例,如 '3C2F80' .