Hilfe für LibreOffice 26.8
Dieser Abschnitt beschreibt die Grundlagen für die Arbeit mit LibreOffice Basic.
LibreOffice Basic-Code basiert auf Prozeduren und Funktionen, die zwischen den Abschnitten sub … end sub und function … end function definiert werden. Jede Sub oder Function kann andere Subs und Functions aufrufen. Wenn der Code für eine Sub oder Function möglichst allgemein gehalten wird, kann er im Allgemeinen in anderen Programmen wieder verwendet werden. Siehe auch Prozeduren und Funktionen.
Es gelten gewisse Einschränkungen für die Namen von öffentlichen Variablen, Prozeduren (sub) und Funktionen (function). So ist es nicht zulässig, den Namen eines Moduls derselben Makrobibliothek zu verwenden.
Sub ist die Kurzform von Subroutine (Prozedur), einem Unterprogramm, das in einem Programm eine bestimmte Aufgabe erledigt. Subs werden verwendet, um eine Aufgabe in einzelne Prozeduren zu zerlegen. Indem ein Programm in Prozeduren und Unterprozeduren aufgeteilt wird, wird seine Zuverlässigkeit gesteigert und die Fehleranfälligkeit gesenkt. Eine Sub kann eventuell einige Argumente als Parameter annehmen, sie gibt jedoch keine Werte an die aufrufende Sub oder Function zurück. Syntaxbeispiel:
MachEtwasMitDenWerten(MeinErsterWert,MeinZweiterWert)
Eine Funktion ist im wesentlichen eine Prozedur, die einen Wert zurückgibt. Funktionen können auf der rechten Seite von Variablendeklarationen oder an anderen Stellen eingesetzt werden, an denen normalerweise Werte verwendet würden, beispielsweise:
MeinZweiterWert = meineFunktion(MeinErsterWert)
Globale Variablen sind für alle Prozeduren und Funktionen in einem Modul gültig. Sie werden noch vor der ersten Prozedur oder Funktion am Anfang eines Moduls deklariert.
Variablen, die innerhalb einer Prozedur oder Funktion deklariert werden, sind nur in dieser Prozedur beziehungsweise Funktion gültig. Diese Variablen haben Vorrang vor namensgleichen globalen Variablen und namensgleichen lokalen Variablen, die aus übergeordneten Prozeduren oder Funktionen stammen.
Nachdem das Programm in Prozeduren und Funktionen (Subs und Functions) aufgeteilt wurde, können diese als Dateien gespeichert werden, um sie in anderen Projekten wieder zu verwenden. LibreOffice Basic unterstützt Module und Bibliotheken. Prozeduren und Funktionen sind immer in Modulen enthalten. Module können als global oder als Teil eines Dokuments definiert werden. Mehrere Module können zu einer Bibliothek zusammengefasst werden.
Über den Dialog Makro können Subs, Functions, Module und Bibliotheken zwischen verschiedenen Dateien kopiert und verschoben werden.