character_unit_left_indent property

ParagraphFormat.character_unit_left_indent property

Gets or sets the left indent value (in characters) for the specified paragraphs.

@property
def character_unit_left_indent(self) -> float:
    ...

@character_unit_left_indent.setter
def character_unit_left_indent(self, value: float):
    ...

Examples

Shows how to change paragraph spacing and indents.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)
format = doc.first_section.body.first_paragraph.paragraph_format
# Below are five different spacing options, along with the properties that their configuration indirectly affects.
# 1 -  Left indent:
self.assertEqual(format.left_indent, 0.0)
format.character_unit_left_indent = 10.0
self.assertEqual(format.left_indent, 120.0)
# 2 -  Right indent:
self.assertEqual(format.right_indent, 0.0)
format.character_unit_right_indent = -5.5
self.assertEqual(format.right_indent, -66.0)
# 3 -  Hanging indent:
self.assertEqual(format.first_line_indent, 0.0)
format.character_unit_first_line_indent = 20.3
self.assertAlmostEqual(format.first_line_indent, 243.59, delta=0.1)
# 4 -  Line spacing before paragraphs:
self.assertEqual(format.space_before, 0.0)
format.line_unit_before = 5.1
self.assertAlmostEqual(format.space_before, 61.1, delta=0.1)
# 5 -  Line spacing after paragraphs:
self.assertEqual(format.space_after, 0.0)
format.line_unit_after = 10.9
self.assertAlmostEqual(format.space_after, 130.8, delta=0.1)
builder.writeln('Lorem ipsum dolor sit amet, consectetur adipiscing elit, ' + 'sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.')
builder.write('测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试' + '文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档测试文档')

See Also

ParagraphFormat.character_unit_first_line_indent property ParagraphFormat.character_unit_right_indent property