Chart2 Direct Title/Subtitle Borders (Static)

Overview

The ooodev.format.chart2.direct.title.borders.LineProperties class gives the same options as the Chart Data Series Borders dialog as seen in Fig. 813.

Calls to the Chart2.style_title() and Chart2.style_subtitle() methods are used to set the Title and Subtitle borders of a Chart.

Setup

import uno
from ooodev.format.chart2.direct.title.borders import LineProperties as TitleLineProperties
from ooodev.format.chart2.direct.general.borders import LineProperties as ChartLineProperties
from ooodev.format.chart2.direct.general.area import Gradient as ChartGradient
from ooodev.format.chart2.direct.general.area import GradientStyle, ColorRange
from ooodev.office.calc import Calc
from ooodev.office.chart2 import Chart2
from ooodev.utils.color import StandardColor
from ooodev.gui import GUI
from ooodev.loader.lo import Lo

def main() -> int:
    with Lo.Loader(connector=Lo.ConnectPipe()):
        doc = Calc.open_doc("pie_flat_chart.ods")
        GUI.set_visible(True, doc)
        Lo.delay(500)
        Calc.zoom(doc, GUI.ZoomEnum.ZOOM_100_PERCENT)

        sheet = Calc.get_active_sheet()

        Calc.goto_cell(cell_name="A1", doc=doc)
        chart_doc = Chart2.get_chart_doc(sheet=sheet, chart_name="pie_chart")

        chart_bdr_line = ChartLineProperties(color=StandardColor.PURPLE_DARK1, width=0.7)
        chart_grad = ChartGradient(
            chart_doc=chart_doc,
            step_count=64,
            style=GradientStyle.SQUARE,
            angle=45,
            grad_color=ColorRange(StandardColor.BLUE_DARK1, StandardColor.PURPLE_LIGHT2),
        )
        Chart2.style_background(chart_doc=chart_doc, styles=[chart_grad, chart_bdr_line])

        title_border = TitleLineProperties(color=StandardColor.MAGENTA_DARK1, width=0.75)
        Chart2.style_title(chart_doc=chart_doc, styles=[title_border])

        Lo.delay(1_000)
        Lo.close_doc(doc)
    return 0

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

Applying Line Properties

The LineProperties class is used to set the title and subtitle border line properties.

Before formatting the chart is seen in Fig. 832.

Apply to Title

from ooodev.format.chart2.direct.title.borders import LineProperties as TitleLineProperties
# ... other code

title_border = TitleLineProperties(color=StandardColor.MAGENTA_DARK1, width=0.75)
Chart2.style_title(chart_doc=chart_doc, styles=[title_border])

The results are seen in Fig. 812 and Fig. 813.

Fig. 813 Chart Data Series Borders Default Dialog

Apply to Subtitle

# ... other code
Chart2.style_subtitle(chart_doc=chart_doc, styles=[title_border])

The results are seen in Fig. 814.

Fig. 814 Chart with subtitle border set