Hilfe für Collabora Office 24.04
Im Register Ereignisse können Sie bestimmten Ereignissen, die in Formularen stattfinden, Makros zuweisen.
Um einem Ereignis ein Makro zuzuweisen, müssen Sie zunächst ein Makro schreiben, das sämtliche beim Eintreten des Ereignisses auszuführenden Befehle enthält. Um dieses Makro dann einem Ereignis zuzuweisen, klicken Sie auf die Schaltfläche … neben dem gewünschten Ereignis. Dadurch öffnet sich der Dialog Makro zuweisen, in dem Sie das Makro auswählen.
Folgende Aktionen sind für den Benutzer frei konfigurierbar, das heißt Sie können ihre eigenen Dialoge verwenden, um eine Aktion darzustellen:
Anzeigen einer Fehlermeldung,
Bestätigen eines Löschvorgangs (von Datensätzen),
Abfrage von Parametern,
sowie Überprüfung von Eingaben bei dem Speichern eines Datensatzes.
Denkbar ist beispielsweise die Definition einer Löschbestätigung der Art "Den Kunden xyz wirklich löschen?", die vor dem Löschen eines Datensatzes ausgegeben wird.
Die im Dialog Ereignisse angezeigten Ereignisse können nicht direkt bearbeitet werden. Sie können ein Ereignis aus der Liste löschen, indem Sie Entf drücken.
In der folgenden Liste sind alle Ereignisse in Formularen aufgeführt und beschrieben, die mit Makros verknüpft werden können:
Das Ereignis Beim Entladen tritt ein, direkt nachdem das Formular entladen, also von seiner Datenquelle getrennt wurde.
Das Ereignis Beim Laden findet direkt nach dem Laden des Formulars statt.
Das Ereignis Beim erneuten Laden findet direkt nach dem Neuladen des Formulars statt. Der Dateninhalt wurde bereits aktualisiert.
Das Ereignis Fehler aufgetreten findet statt, wenn beim Zugriff auf die Datenquelle ein Fehler auftritt. Dies gilt für Formulare, Listen- und Kombinationsfelder.
Das Ereignis Löschung bestätigen tritt ein, sobald Daten vom Formular gelöscht wurden. Es gibt Wahr zurück, um die Lösung der Zeile zu erlauben, anderenfalls Falsch. Als Beispiel kann das verknüpfte Makro eine Bestätigung in einem Dialog anfordern.
Das Ereignis Nach dem Datensatzwechsel tritt ein, direkt nachdem der aktuelle Datensatzzeiger geändert wurde.
Das Ereignis Nach der Datensatzaktion tritt ein, direkt nachdem der aktuelle Datensatz geändert wurde.
Das Ereignis Parameter füllen tritt ein, wenn das zu ladende Formular über Parameter verfügt, die ausgefüllt werden müssen. Der folgende SQL-Befehl könnte beispielsweise die Datenquelle des Formulars darstellen:
SELECT * FROM address WHERE name=:name
:name ein Parameter, der beim Laden ausgefüllt werden muss. Der Parameter wird nach Möglichkeit automatisch aus dem übergeordneten Formular ausgefüllt. Kann der Parameter nicht ausgefüllt werden, wird dieses Ereignis aufgerufen und ein verknüpftes Makro kann den Parameter ausfüllen. Es gibt True zurück, wenn die Ausführung der parametrisierten Anweisung fortgesetzt werden soll, anderenfalls False.
Das Ereignis Vor der Übermittlung tritt ein, bevor die Formulardaten gesendet werden. Wenn Wahr zurückgegeben wird, wird die Übermittlung bestätigt, wenn Falsch zurückgegeben wird, wird sie abgebrochen.
Das Ereignis Vor dem Aktualisieren tritt ein, bevor der vom Benutzer geänderte Steuerelementinhalt in die Datenquelle geschrieben wird. Das verknüpfte Makro kann beispielsweise diese Aktion verhindern, indem es FALSCH zurück gibt.
Das Ereignis Nach dem Aktualisieren tritt ein, nachdem der vom Benutzer geänderte Steuerelement-Inhalt in die Datenquelle geschrieben wurde.
Das Ereignis Vor dem Zurücksetzen tritt ein, bevor ein Formular zurückgesetzt wird. Wenn Wahr zurückgegeben wird, wird das Zurücksetzen bestätigt, wenn Falsch zurückgegeben wird, wird die Operation abgebrochen.
Ein Formular wird zurückgesetzt, wenn eine der folgenden Bedingungen eintritt:
Der Benutzer betätigt eine (HTML-) Schaltfläche, die als Reset-Schaltfläche definiert ist.
In einem an eine Datenquelle angebundenen Formular wird ein neuer, leerer Datensatz erstellt. Beispielsweise wird im letzten Datensatz die Schaltfläche Nächster Datensatz gedrückt.
Das Ereignis Nach dem Zurücksetzen tritt ein, nachdem ein Formular zurückgesetzt wurde.
Das Ereignis Vor dem Datensatzwechsel tritt ein, bevor der aktuelle Datensatzzeiger – der SQL-Cursor – geändert wird. Es gibt True zurück, wenn das Verschieben erlaubt ist, anderenfalls False.
Das Ereignis Vor dem Entladen tritt ein, bevor das Formular entladen, also von seiner Datenquelle getrennt wird.
Das Ereignis Vor dem erneuten Laden tritt ein, bevor das Formular neu geladen wird. Der Dateninhalt wurde noch nicht aktualisiert.
Das Ereignis Vor der Datensatzaktion tritt ein, bevor der aktuelle Datensatz geändert wird. Es gibt True zurück, wenn das Ändern erlaubt ist, anderenfalls False. Beispielsweise kann das verlinkte Makro in einem Dialog eine Bestätigung anfordern.
Makros können die Ausführung von Ereignissen unterbrechen, wenn sie einen booleschen Wert zurückgeben: True ermöglicht die Fortsetzung der Ausführung des Ereignisses und False stoppt die Ausführung des Ereignisses.
Die folgenden Ereignisse sind unterbrechbar, indem False zurückgegeben wird:
Vor der Datensatzaktion
Nach der Datensatzaktion
Vor dem Absenden
Vor dem Aktualisieren
Parameter füllen