Python in LibreOffice Calc: Statistik per MessageBox anzeigen

Bindet das UNO-Modul ein, damit Python mit der LibreOffice-API kommunizieren kann.

Importiert die Konstante für eine MessageBox mit einem OK-Button.

Importiert den Typ für eine Informations-MessageBox mit passendem Symbol.

Definiert die Funktion, die später als LibreOffice-Skript aufgerufen wird, wobei *args optionale Aufrufparameter aufnimmt.

Greift auf das aktuell geöffnete LibreOffice-Dokument zu.

Holt die aktuelle Auswahl des Benutzers im Dokument.

Prüft, ob die aktuelle Auswahl die Methoden besitzt, die ein Zellbereich bereitstellt.

Beendet die Funktion sofort, wenn kein Zellbereich ausgewählt ist.

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

Liest den Namen des Tabellenblatts als Text aus.

Ermittelt die Position des markierten Zellbereichs mit Start- und Endzeilen sowie Spalten.

Liest den kompletten Zellbereich als zweidimensionales Tupel in den Arbeitsspeicher.

Erstellt eine Liste aller numerischen Werte aus dem gesamten markierten Zellbereich.

Prüft, ob im Zellbereich überhaupt Zahlen vorhanden sind.

Legt den Text für die MessageBox fest, falls keine Zahlen gefunden wurden.

Zeigt eine MessageBox mit dem Hinweistext an.

Beendet die Funktion, da keine Auswertung möglich ist.

Berechnet die Summe aller numerischen Werte im markierten Bereich.

Berechnet den Mittelwert aller Zahlen im Bereich.

Ermittelt den kleinsten Wert im Zellbereich.

Ermittelt den größten Wert im Zellbereich.

Erklärt, dass der Bereichsname vereinheitlicht dargestellt wird.

Extrahiert aus dem vollständigen Namen der Auswahl nur den Zellbereich ohne Tabellenblatt.

Setzt den Tabellenblattnamen und den Zellbereich zu einer lesbaren Bereichsangabe zusammen.

Beginnt den mehrzeiligen Text, der später in der MessageBox angezeigt wird.

Schreibt die Überschrift und fügt zwei Zeilenumbrüche ein.

Gibt den Namen des Tabellenblatts aus und erzeugt einen Zeilenumbruch.

Gibt den ausgewerteten Zellbereich aus und trennt die Metadaten von den Ergebnissen.

Zeigt an, wie viele numerische Werte im Bereich gefunden wurden.

Gibt die Summe aller Zahlen mit zwei Nachkommastellen aus.

Gibt den Mittelwert mit zwei Nachkommastellen aus.

Gibt den kleinsten Wert mit zwei Nachkommastellen aus.

Gibt den größten Wert mit zwei Nachkommastellen aus.

Schließt den zusammenhängenden Textblock ab.

Zeigt die berechneten Ergebnisse in einer MessageBox an.
Der führende Unterstrich ist eine Python-Konvention und bedeutet, dass diese Funktion nur intern verwendet wird.
Sie gehört zur Umsetzung des Skripts, ist aber nicht der eigentliche Einstiegspunkt.

Definiert eine Hilfsfunktion zum Anzeigen einer MessageBox.

Ermittelt das aktuelle LibreOffice-Fenster als Elternobjekt für die MessageBox.
Also hier holen wir uns das aktuelle LibreOffice-Fenster, damit die MessageBox korrekt diesem Fenster zugeordnet werden kann.

Greift auf den globalen UNO-Komponentenkontext zu.
Mit dieser Zeile holen wir uns den UNO-Komponentenkontext.
Er stellt die Laufzeitumgebung von LibreOffice bereit und wird benötigt, um neue UNO-Services wie zum Beispiel das GUI-Toolkit zu erzeugen.

Hier erzeugen wir das grafische Toolkit von LibreOffice über den ServiceManager, das später benötigt wird, um MessageBoxen und andere GUI-Elemente anzuzeigen.
GUI steht für „Graphical User Interface“ und bedeutet auf Deutsch grafische Benutzeroberfläche, also alles, womit der Benutzer direkt über Fenster, Buttons oder Dialoge interagiert.

Hier erstellen wir die MessageBox und legen fest, zu welchem Fenster sie gehört, welchen Typ sie hat, welche Buttons angezeigt werden und welcher Text ausgegeben wird.
Mit dieser Zeile wird die MessageBox selbst erzeugt, aber noch nicht angezeigt.

Zeigt die MessageBox an und wartet auf die Bestätigung durch den Benutzer.

Registriert die Funktion als aufrufbares LibreOffice-Python-Skript.

---

Hier habt Ihr den Code noch als Downloaddatei: