Write Modify Page Borders

The ooodev.format.writer.modify.page.borders.Sides, ooodev.format.writer.modify.page.borders.Padding, and ooodev.format.writer.modify.page.borders.Shadow classes are used to modify the border values seen in Fig. 1116 of a character border style.

Default Page Borders Style Dialog

Writer dialog Page Header Borders default

Fig. 1116 Writer dialog Page Header Borders default

Setup

General function used to run these examples.

from ooodev.format.writer.modify.page.borders import Padding, Shadow, Sides, WriterStylePageKind
from ooodev.format.writer.modify.page.borders import BorderLineKind, LineSize, Side
from ooodev.office.write import Write
from ooodev.gui import GUI
from ooodev.loader.lo import Lo
from ooodev.utils.color import StandardColor

def main() -> int:
  with Lo.Loader(Lo.ConnectPipe()):
    doc = Write.create_doc()
    GUI.set_visible(doc=doc)
    Lo.delay(300)
    GUI.zoom(GUI.ZoomEnum.ENTIRE_PAGE)

    side = Side(line=BorderLineKind.DOUBLE, color=StandardColor.RED, width=LineSize.MEDIUM)
    sides_style = Sides(all=side, style_name=WriterStylePageKind.STANDARD)
    sides_style.apply(doc)

    style_obj = Sides.from_style(doc=doc, style_name=WriterStylePageKind.STANDARD)
    assert style_obj.prop_style_name == str(WriterStylePageKind.STANDARD)
    Lo.delay(1_000)

    Lo.close_doc(doc)
return 0

if __name__ == "__main__":
    SystemExit(main())

Border Sides

Setting Border Sides

# ... other code

side = Side(line=BorderLineKind.DOUBLE, color=StandardColor.RED, width=LineSize.MEDIUM)
sides_style = Sides(all=side, style_name=WriterStylePageKind.STANDARD)
sides_style.apply(doc)

Style results.

Writer dialog Page Borders style sides changed

Fig. 1117 Writer dialog Page Borders style sides changed

Getting border sides from a style

# ... other code

style_obj = Sides.from_style(doc=doc, style_name=WriterStylePageKind.STANDARD)
assert style_obj.prop_style_name == str(WriterStylePageKind.STANDARD)

Border Padding

Setting Border Padding

# ... other code

padding_style = Padding(
    left=5, right=5, top=3, bottom=3, style_name=WriterStylePageKind.STANDARD
)
padding_style.apply(doc)

Style results.

Writer dialog Page Borders style padding changed

Fig. 1118 Writer dialog Page Borders style padding changed

Getting border padding from a style

We can get the border padding from the document.

# ... other code

style_obj = Padding.from_style(doc=doc, style_name=WriterStylePageKind.STANDARD)
assert style_obj.prop_style_name == str(WriterStylePageKind.STANDARD)

Border Shadow

Setting Border Shadow

# ... other code

shadow_style = Shadow(
    color=StandardColor.BLUE_DARK2, width=1.5, style_name=WriterStylePageKind.STANDARD
)
shadow_style.apply(doc)

Style results.

Writer dialog Page Borders style shadow changed

Fig. 1119 Writer dialog Page Borders style shadow changed

Getting border shadow from a style

We can get the border shadow from the document.

# ... other code

style_obj = Shadow.from_style(doc=doc, style_name=WriterStylePageKind.STANDARD)
assert style_obj.prop_style_name == str(WriterStylePageKind.STANDARD)