LibreOffice Calc Python Makro – Zellbereiche automatisch summieren

Importiert das Python-Modul uno, das benötigt wird, um mit der UNO-API von LibreOffice zu arbeiten (z. B. Enums erstellen, UNO-Objekte ansprechen).

Importiert die UNO-Enum-Konstante CENTER für horizontale Zell-Ausrichtung. Damit kann später HoriJustify auf „zentriert“ gesetzt werden, ohne uno.Enum(...) zu verwenden.

Definiert eine Funktion (Makro-Einstiegspunkt), die von LibreOffice als Script ausgeführt werden kann.

Holt das aktuell aktive LibreOffice-Dokument über XSCRIPTCONTEXT, das beim Ausführen von Makros automatisch bereitgestellt wird.

Liest die aktuelle Auswahl im Dokument aus. In Calc ist das normalerweise ein markierter Zellbereich.

Prüft, ob die aktuelle Auswahl einen Zellbereich darstellt, indem getestet wird, ob sie eine Bereichsadresse liefern kann.

Bricht die Funktion sofort ab, wenn die Auswahl kein gültiger Zellbereich ist, um Fehler zu vermeiden.

Ermittelt die Start- und Endkoordinaten der markierten Zellen (Zeilen und Spalten, 0-basiert).

Ermittelt das Tabellenblatt, auf dem sich die aktuelle Auswahl befindet.

Initialisiert den Zähler für die fortlaufende Nummerierung der gültigen Zeilen.

Initialisiert die laufende Summe als Fließkommazahl.

Kommentar zur besseren Lesbarkeit des Codes.

Definiert einen hellgrünen RGB-Farbwert zur Kennzeichnung gültiger Zeilen.

Definiert einen hellroten RGB-Farbwert zur Kennzeichnung ignorierter Zeilen.

Definiert einen Wert für „keine Hintergrundfarbe“, der hier vorbereitet, aber nicht weiter verwendet wird.

Ab hier beginnt die eigentliche Datenverarbeitung.

Durchläuft alle Zeilen der Markierung. EndRow + 1 ist nötig, da range() den Endwert sonst nicht einschließt.

Greift auf die Zelle in der linken Spalte der Markierung zu, aus der der Eingabewert gelesen wird.

Greift auf die Zelle eine Spalte rechts neben der Quellzelle zu, in der der Index ausgegeben wird.

Greift auf die Zelle zwei Spalten rechts neben der Quellzelle zu, in der die laufende Summe ausgegeben wird.

Prüft, ob die Quellzelle tatsächlich eine Zahl enthält. Verglichen wird ein typisierter UNO-Enum-Wert, kein Text.

Liest den numerischen Wert der Quellzelle aus.

Addiert den gelesenen Wert zur laufenden Summe.

Schreibt die aktuelle laufende Nummer als Zahl in die Index-Spalte.

Schreibt die aktuelle laufende Summe in die Summen-Spalte.

Setzt die Hintergrundfarbe der Index-Zelle auf Grün, um eine gültige Zeile zu markieren.

Richtet den Inhalt der Index-Zelle horizontal zentriert aus.

Erhöht den Zähler für die nächste gültige Zeile.

Zweig für alle Fälle, in denen die Quellzelle keine Zahl enthält.

Kennzeichnet die Zeile textlich als ignoriert.

Trägt einen Platzhalter ein, da für diese Zeile keine Summe berechnet wird.

Setzt die Hintergrundfarbe der Index-Zelle auf Rot, um die ignorierte Zeile visuell hervorzuheben.

Zentriert auch hier den Zellinhalt für ein einheitliches Erscheinungsbild.

Kommentar: Ab hier wird die Formatierung der Spalten vorgenommen.

Greift auf den Spalten-Container des Tabellenblatts zu, der alle Spaltenobjekte verwaltet.

Holt das Spaltenobjekt der Index-Spalte aus dem Container und speichert eine Referenz darauf.

Holt das Spaltenobjekt der Summen-Spalte aus dem Container.

Aktiviert die automatische Spaltenbreite (OptimalWidth) für die Index-Spalte.

Aktiviert die automatische Spaltenbreite für die Summen-Spalte.

Exportiert die Funktion für LibreOffice, damit sie als Makro erkannt und ausgeführt werden kann.