Write Modify Character Borders

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

Default Character Borders Style Dialog

Writer dialog Character Borders default

Fig. 1055 Writer dialog Character Borders default

Setup

General function used to run these examples.

from ooodev.format.writer.modify.char.borders import Sides, Padding, Shadow
from ooodev.format.writer.modify.char.borders import Side
from ooodev.format.writer.modify.char.borders import StyleCharKind
from ooodev.format.writer.modify.char.borders import BorderLineKind
from ooodev.format.writer.modify.char.borders import LineSize
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.ZOOM_150_PERCENT)

        side = Side(line=BorderLineKind.DOUBLE, color=StandardColor.RED, width=LineSize.MEDIUM)
        sides_style = Sides(border_side=side, style_name=StyleCharKind.EXAMPLE)
        sides_style.apply(doc)

        style_obj = Sides.from_style(doc=doc, style_name=StyleCharKind.EXAMPLE)
        assert style_obj.prop_style_name == str(StyleCharKind.EXAMPLE)
        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(border_side=side, style_name=StyleCharKind.EXAMPLE)
sides_style.apply(doc)

Style results.

Writer dialog Character Borders style sides changed

Fig. 1056 Writer dialog Character Borders style sides changed

Getting border sides from a style

We can get the border sides from the document.

# ... other code

style_obj = Sides.from_style(doc=doc, style_name=StyleCharKind.EXAMPLE)
assert style_obj.prop_style_name == str(StyleCharKind.EXAMPLE)

Border Padding

Setting Border Padding

# ... other code

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

Style results.

Writer dialog Character Borders style padding changed

Fig. 1057 Writer dialog Character 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=StyleCharKind.EXAMPLE)
assert style_obj.prop_style_name == str(StyleCharKind.EXAMPLE)

Border Shadow

Setting Border Shadow

# ... other code

shadow_style = Shadow(color=StandardColor.BLUE_DARK2, width=1.5, style_name=StyleCharKind.EXAMPLE)
shadow_style.apply(doc)

Style results.

Writer dialog Character Borders style shadow changed

Fig. 1058 Writer dialog Character 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=StyleCharKind.EXAMPLE)
assert style_obj.prop_style_name == str(StyleCharKind.EXAMPLE)