horizontal property

BorderCollection.horizontal property

Gets the horizontal border that is used between cells or conforming paragraphs.

@property
def horizontal(self) -> aspose.words.Border:
    ...

Examples

Shows how to apply settings to horizontal borders to a paragraph’s format.

doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Create a red horizontal border for the paragraph. Any paragraphs created afterwards will inherit these border settings.
borders = doc.first_section.body.first_paragraph.paragraph_format.borders
borders.horizontal.color = aspose.pydrawing.Color.red
borders.horizontal.line_style = aw.LineStyle.DASH_SMALL_GAP
borders.horizontal.line_width = 3
# Write text to the document without creating a new paragraph afterward.
# Since there is no paragraph underneath, the horizontal border will not be visible.
builder.write('Paragraph above horizontal border.')
# Once we add a second paragraph, the border of the first paragraph will become visible.
builder.insert_paragraph()
builder.write('Paragraph below horizontal border.')
doc.save(file_name=ARTIFACTS_DIR + 'Border.HorizontalBorders.docx')

Shows how to apply settings to vertical borders to a table row’s format.

doc = aw.Document()
builder = aw.DocumentBuilder(doc=doc)
# Create a table with red and blue inner borders.
table = builder.start_table()
i = 0
while i < 3:
    builder.insert_cell()
    builder.write(f'Row {i + 1}, Column 1')
    builder.insert_cell()
    builder.write(f'Row {i + 1}, Column 2')
    row = builder.end_row()
    borders = row.row_format.borders
    # Adjust the appearance of borders that will appear between rows.
    borders.horizontal.color = aspose.pydrawing.Color.red
    borders.horizontal.line_style = aw.LineStyle.DOT
    borders.horizontal.line_width = 2
    # Adjust the appearance of borders that will appear between cells.
    borders.vertical.color = aspose.pydrawing.Color.blue
    borders.vertical.line_style = aw.LineStyle.DOT
    borders.vertical.line_width = 2
    i += 1
# A row format, and a cell's inner paragraph use different border settings.
border = table.first_row.first_cell.last_paragraph.paragraph_format.borders.vertical
self.assertEqual(aspose.pydrawing.Color.empty().to_argb(), border.color.to_argb())
self.assertEqual(0, border.line_width)
self.assertEqual(aw.LineStyle.NONE, border.line_style)
doc.save(file_name=ARTIFACTS_DIR + 'Border.VerticalBorders.docx')

horizontal property

BorderCollection.horizontal property

Examples

See Also