Hilfe für LibreOffice 24.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 Sie sich bemühen, den Code für eine Sub oder Function möglichst allgemein zu halten, können Sie ihn im Allgemeinen in anderen Programmen wieder verwenden. Lesen Sie 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 Sie ein Programm in Prozeduren und Unterprozeduren aufteilen, steigern Sie seine Zuverlässigkeit und senken die Fehleranfälligkeit. 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. Sie können Funktionen auf der rechten Seite von Variablendeklarationen oder an anderen Stellen einsetzen, 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 Sie innerhalb einer Prozedur oder Funktion deklarieren, 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 Sie Ihr Programm in Prozeduren und Funktionen (Subs und Functions) aufgeteilt haben, können Sie diese als Dateien speichern, um sie in anderen Projekten wieder zu verwenden. LibreOffice Basic unterstützt Module und Bibliotheken. Prozeduren und Funktionen sind immer in Modulen enthalten. Sie können Module als global oder als Teil eines Dokuments definieren. Mehrere Module können zu einer Bibliothek zusammengefasst werden.
Über den Dialog Makro können Sie Subs, Functions, Module und Bibliotheken zwischen verschiedenen Dateien kopieren und verschieben.