共享类

长度对象

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

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

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

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

长度构造函数类Inches、Cm、Mm、Px和Emu的基类。表现为英制公制单位的int计数,914400表示英寸,36000表示mm。以只读属性的形式提供方便的单位转换方法。不变的。

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 EMU。

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

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

RGBColor 对象

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

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

rgb 是0-255(含0-255)范围内的整数。使用十六进制整数表示法,例如。 0x42 可提高使用十六进制RGB值时的可读性:

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

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