|
Bedeutung:
|
Der
ON <Taste> MACRO wird ausgeführt, wenn in einem Maskenfeld die
Taste <Taste> gedrückt wird.
Folgende
Tasten sind zulässig:
F1, F2,..., F24
SF1,…,SF12
PGUP, PGDN
CURSUP, CURSDN, CURSL, CURSR
SHIFT_CURSUP, SHIFT_CURSDN, SHIFT_CURSL,
SHIFT_CURSR
INS, DEL
TABRIGHT, TABLEFT
END,
ESC, HOME
Im
Makro <Makroname> kann mit GET_KEYSTATE
geprüft werden, ob eine der Tasten Alt oder Strg gleichzeitig mit der Taste
<Taste> gedrückt wurde.
Vor
der Ausführung eines ON <Taste> MACRO werden die Variablen EBUS_FDATA und EBUS_FDATA$ mit dem
aktuellen Maskenfeldinhalt belegt.
Im
<Hilfetext> kann ein Icon angegeben werden, das bei den Tasten
F1,…,F24,SF1,…,SF12 in der Iconleiste angezeigt wird. Zusätzlich kann ein
Text angegeben werden, der angezeigt wird, wenn sich die Maus über dem Icon
befindet. <Hilfetext> ist folgendermaßen aufgebaut:
[@<Iconname>,]<Text>
<Iconname> = <STRING-AUSDRUCK>
<Text> = <STRING-AUSDRUCK>
Die ON
<Taste> Makros sind lokal bezüglich Haupt- und Unterprogramme. Dies
bedeutet, dass jedes Haupt- bzw. Unterprogramm seine eigenen ON <Taste>
Makros besitzt.
ON
<Taste> RESET schaltet einen ON <Taste> MACRO wieder aus.
Der
ON <Ereignis> MACRO wird ausgeführt, wenn das Ereignis eintritt.
Folgende Ereignisse sind möglich:
|
Ereignis
|
Bedeutung
|
|
BEGIN_READ(<INDEXDATEI>)
|
Der
Makro wird jeweils vor der Lesezugriff (READ, START, READ-NEXT,
READ-PREVIOUS) ausgeführt. Wird im
Makro die Variable EBUS_TRANSFER = 0 gesetzt,
so wird der Datensatz nicht gelesen und in OK wird die Fehlernummer 1098 geliefert.
|
|
DELETE(<INDEXDATEI>)
|
Der
Makro wird jedes Mal dann ausgeführt, wenn ein Löschzugriff auf die Indexdatei
<INDEXDATEI> erfolgte und bei dem Zugriff kein Fehler auftrat.
Achtung: Wenn in diesem Makro andere Indexdateien gelöscht werden, muss
zuvor ON DELETE_ALL RESET ausgeführt werden, andernfalls wird durch
rekursive Aufrufe ein Endlos-Loop erzeugt.
|
|
DELETE_ALL
|
Der
Makro wird jedes Mal dann ausgeführt, wenn eine DELETE-Anweisung für irgendeine
Indexdatei erfolgte und dabei kein Fehler auftrat.
|
|
DOUBLECLICK
|
Der
Makro wird jedes Mal dann ausgeführt, wenn ein Doppelklick mit der linken
Maustaste auf einer Maske erfolgt.
Die
Variable EBUS_MOUSE_WDEPTH enthält
die Windowtiefe der angeklickten Maske.
Die
Variable EBUS_MOUSE_IN_FIELD enthält
die interne Feldnummer des Maskenfeldes, wenn ein Maskenfeld angeklickt
wurde.
|
|
EXIT
|
Der
Makro wird ausgeführt, wenn das Hauptprogramm beendet wird, unmittelbar
bevor die Indexdateien geschlossen werden. Wird die Variable EBUS_TRANSFER = 1 oder
EBUS_DATA = 0 gesetzt, so wird das
Programm nicht beendet.
Achtung: Werden im ON EXIT MACRO Funktionen oder Anweisungen aufgerufen,
die EBUS_TRANSFER oder EBUS_DATA verändern, so muss am Ende des Makros
EBUS_TRANFER = 0 und EBUS_DATA = 1 gesetzt werden, wenn das Programm
beendet werden soll.
|
|
INDEXERROR
|
Der
Makro wird ausgeführt, wenn bei folgenden Befehlen aufgrund eines Fehlers
in den Block ON ERROR ... END gesprungen wird:
READ, READS
READ-NEXT, READS-NEXT
READ-PREVIOUS,READS-PREVIOUS
START, STARTS
DELETE
WRITE
Der
Makro wird ausgeführt bevor die erste Anweisung im Block ON ERROR ... END
ausgeführt wird.
Die
folgenden Variablen enthalten dann die Informationen über den aktuellen
Indexdateizugriff:
EBUS_FILENAME$(EBUS_FILENR) liefert den Indexdateinamen.
EBUS_KEYNR liefert
die Schlüsselnummer (0=Primärkey, 1 ... = Sekundärkey).
EBUS_IFUNC liefert
die Zugriffsart:
1 = READ, READS
2 = START, STARTS
3 = READ-NEXT, READS-NEXT
4 = READ-PREVIOUS, READS-PREVIOUS
5
= DELETE
6
= WRITE
Nach
dem Verlassen des ON INDEXERROR Makros wird mit der ersten Anweisung im
Block ON ERROR ... END fortgefahren.
|
|
KEY
|
Der
Makro wird jedes Mal ausgeführt, wenn in einem alphanumerischen Maskenfeld
ein Zeichen eingegeben wurde. Die Variable EBUS_KEY enthält
den ASCII-Wert des eingegebenen Zeichens und kann im Makro geändert werden.
Nach der Ausführung des Makros wird das durch EBUS_KEY
dargestellte Zeichen in das aktuelle Eingabefeld übernommen, wenn EBUS_KEY >0 und <256 ist. In jedem
anderen Fall wird die Eingabe ignoriert.
Beispiel:
/* Ä in AE umwandeln, Ö nicht zulassen
ON KEY MACRO
UMWANDELN
Makro UMWANDELN:
IF EBUS_KEY
= ASC("Ä")
THEN EBUS_KEY
= ASC("A")
UNGETCHAR "E"
ENDIF
IF EBUS_KEY
= ASC("Ö")
THEN EBUS_KEY
= 0
ENDIF
Die Variable EBUS_TRANSFER
wird vor dem Aufruf des Makros = 0 gesetzt. Wird im Makro EBUS_TRANSFER = 1 gesetzt, so wird der
Inhalt der Variablen EBUS_DATA in das
aktuelle Feld übernommen. Wird EBUS_TRANSFER
auf einen Wert <> 0, <> 99 und <> 1 gesetzt, so wird der
Inhalt der Variablen EBUS_DATA$ in das
aktuelle Feld übernommen. In diesen Fällen wird weder das eingegebene
Zeichen noch EBUS_KEY verarbeitet.
Achtung:
Diese Anweisung hat keine Wirkung bei Html-Programmen.
|
|
LBUTTONUP
|
Der
Makro wird ausgeführt, wenn die linke Maustaste nach dem Drücken wieder
losgelassen wird.
Die
Variablen EBUS_MOUSE_ROW und EBUS_MOUSE_COL enthalten die Zeile und Spalte des Mauscursors.
Die
Variable EBUS_MOUSE_WDEPTH enthält
die Windowtiefe der Maske, über der sich die Maus befindet.
Die
Variable EBUS_MOUSE_IN_FIELD enthält
die interne Feldnummer des Maskenfeldes, wenn ein Maskenfeld angeklickt
wurde.
SYNCHRONIZE_MOUSE legt fest, ob die
MOUSE Makros synchronisiert werden.
|
|
LPRINT_LPRECORDER
|
Der
Makro wird anstelle des Drucks ausgeführt, wenn in der Druckvorschau F1=Drucken
ausgeführt wird.
EBUS_LPRECORDER_FILE$ enthält
den Dateinamen der temporären Recorderdatei.
|

|
ON LPRINT_LPRECORDER hat keine Wirkung bei
Html-Programmen.
|
|
|
MENU
|
Der
Makro wird jedes Mal dann ausgeführt, wenn ein neuer Menuepunkt ausgewählt
wurde, auch dann, wenn der aktuelle Menuepunkt 'normal' beendet wird.
Über
die Variable EBUS_DATA kann
gesteuert werden, ob der Menuepunkt angesprungen werden soll oder nicht.
Vor der Ausführung des Makros wird diese Variable =1 gesetzt. Ist sie nach
der Ausführung des Makros =0, so wird der ausgewählte Menuepunkt nicht
angesprungen.
|
|
MESSAGE
|
Der
Makro wird anstelle der Anweisungen MESSAGE
und ERRORMES ausgeführt.
Im
Makro kann die Art der Meldung über die Variable MESSAGETYPE und die
Meldung selbst über die Variable MESSAGE$ erhalten
werden.
Innerhalb
des Makros sind die Anweisungen MESSAGE und ERRORMES zulässig. Sie werden dort nicht mehr
umgeleitet.
|
|
MOUSE
|
Der
Makro wird ausgeführt, wenn die linke Maustaste gedrückt wurde.
Die
Variablen EBUS_MOUSE_ROW und EBUS_MOUSE_COL enthalten die Zeile und Spalte des Mauscursors.
Die
Variable EBUS_MOUSE_WDEPTH enthält
die Windowtiefe der angeklickten Maske.
Die
Variable EBUS_MOUSE_IN_FIELD enthält
die interne Feldnummer des Maskenfeldes, wenn ein Maskenfeld angeklickt
wurde.
SYNCHRONIZE_MOUSE legt fest, ob die
MOUSE Makros synchronisiert werden.
|
|
MOUSEMOVE
|
Der
Makro wird jedes Mal ausgeführt, wenn der Mauszeiger bewegt wird.
Die
Variablen EBUS_MOUSE_ROW und EBUS_MOUSE_COL enthalten die Zeile und Spalte des Mauscursors.
Die
Variable EBUS_MOUSE_WDEPTH enthält
die Windowtiefe der Maske, über der sich die Maus befindet.
Die
Variable EBUS_MOUSE_IN_FIELD enthält
die interne Feldnummer des Maskenfeldes, wenn ein Maskenfeld angeklickt
wurde.
Die
Variable EBUS_OPTIMIZE_MOUSEMOVE legt
fest, ob die ON MOUSEMOVE Makros optimiert werden.
|
|
RBUTTONUP
|
Der
Makro wird ausgeführt, wenn die rechte Maustaste nach dem Drücken wieder
losgelassen wird.
Die
Variable EBUS_STANDARD_POPUP
steuert, ob in Maskenfeldern das Standardpopupmenue angezeigt oder der ON
RBUTTONUP MACRO ausgeführt wird.
Die
Variablen EBUS_MOUSE_ROW und EBUS_MOUSE_COL enthalten die Zeile und Spalte des Mauscursors.
Die
Variable EBUS_MOUSE_WDEPTH enthält
die Windowtiefe der Maske, über der sich die Maus befindet.
Die
Variable EBUS_MOUSE_IN_FIELD enthält
die interne Feldnummer des Maskenfeldes, wenn ein Maskenfeld angeklickt
wurde.
SYNCHRONIZE_MOUSE legt fest, ob die
MOUSE Makros synchronisiert werden.
|
|
READ
(<INDEXDATEI>)
|
Der
Makro wird jedes Mal dann ausgeführt, wenn ein erfolgreicher Lesezugriff
READ, READS,
START, STARTS,
READ-NEXT,
READ-PREVIOUS,
READS-NEXT,
READS-PREVIOUS
auf
die Indexdatei <INDEXDATEI> ausgeführt wurde.
Der
Makro wird auch dann ausgeführt, wenn z.B. in einem Maskenfeld, das mit der
Indexdateivariablen verknüpft ist, mit F3 oder F4 geblättert wird oder die SELECT-Funktion ausgeführt wird.
|
|
READ_ALL
|
Der
Makro wird jedes Mal dann ausgeführt, wenn ein ein erfolgreicher
Lesezugriff auf irgendeine Indexdatei ausgeführt
wurde..
Achtung: Wenn in diesem Makro andere Indexdateien gelesen werden, muss
zuvor ON READ_ALL RESET ausgeführt werden, andernfalls wird durch rekursive
Aufrufe ein Endlos-Loop erzeugt.
|
|
RESIZE
|
Der
Makro wird jedes Mal ausgeführt, wenn sich die Größe des Mainwindows ändert
oder ein Splitbalken verschoben wird.
Die
Variable EBUS_DATA = 0,
wenn sich die Größe des Mainwindows geändert hat und = 1, wenn ein
Splitbalken verschoben wurde.
Die
Variable EBUS_MAINSIZE enthält
die Information über die Größe des Mainwindows.
|
|
RMOUSE
|
Der Makro
wird ausgeführt, wenn die rechte Maustaste gedrückt wird.
Die
Variable EBUS_STANDARD_POPUP
steuert, ob in Maskenfeldern das Standardpopupmenue angezeigt oder der ON
RMOUSE MACRO ausgeführt wird.
Die
Variablen EBUS_MOUSE_ROW und EBUS_MOUSE_COL enthalten die Zeile und Spalte des Mauscursors.
Die
Variable EBUS_MOUSE_WDEPTH enthält
die Windowtiefe der Maske, über der sich die Maus befindet.
Die
Variable EBUS_MOUSE_IN_FIELD enthält
die interne Feldnummer des Maskenfeldes, wenn ein Maskenfeld angeklickt
wurde.
SYNCHRONIZE_MOUSE legt fest, ob die
MOUSE Makros synchronisiert werden.
|
|
SELECT
|
Der
Makro wird jedes Mal ausgeführt, wenn in einer SELECT-Funktion
ein Datensatz einer Indexdatei
gelesen wurde. Der Makro wird ausgeführt bevor der Datensatz am
Bildschirm angezeigt wird. In diesem Makro können die Werte der
Indexdatei-Variablen für die Anzeige am Bildschirm verändert werden.
Mit
der Variablen EBUS_SELECT kann
gesteuert werden, ob der Datensatz am Bildschirm angezeigt werden soll oder
nicht. Bei EBUS_SELECT
= 0 wird nach Verlassen des Makros die Anzeige des Datensatzes unterdrückt,
andernfalls wird der Datensatz angezeigt. Jedes Mal vor der Ausführung des
Makros wird EBUS_SELECT
= 1 gesetzt.
Wird
EBUS_SELECT
= 99 gesetzt, so wird das Dateiende simuliert, d.h. der aktuelle Datensatz
wird nicht angezeigt und es werden keine weiteren Datensätze mehr gelesen.
Dies kann dazu benutzt werden, die Menge der zu lesenden Datensätze
einzugrenzen.
Mit
Hilfe der Variablen EBUS_SELECT_COLOR$ können
die einzelnen Felder farbig angezeigt werden.
Der
ON SELECT MACRO wird auch bei der Anweisung REFRESHSELECT für
jeden gelesenen Datensatz ausgeführt. Die Variable EBUS_SELECT und die
Anweisungen ENDSELECT und QUITSELECT haben
dabei aber keine Wirkung.
|
|
SELECT(<Taste>)
|
Der
Makro wird jedes Mal dann ausgeführt, wenn im SELECT,
SELECTA oder TREEVIEW
die Taste <TASTE> gedrückt wurde.
Folgende
Tasten sind möglich:
F1, F2,..., F24
SF1,…,SF12
PGUP, PGDN
CURSUP, CURSDN, CURSL, CURSR
SHIFT_CURSUP, SHIFT_CURSDN, SHIFT_CURSL,
SHIFT_CURSR
SHIFT_INS,
SHIFT_DEL
SHIFT_PGUP, SHIFT_PGDN
TABRIGHT, TABLEFT
RETURN
MOUSE
RMOUSE
RBUTTONUP
MOUSE_HEADER
RMOUSE_HEADER
RBUTTONUP_HEADER
INS, DEL
END
HOME
ESC
Bei den
Tasten CURSUP, CURSDN, PGUP und PGDN bleibt die ursprüngliche Wirkung erhalten,
d.h. es kann mit diesen Tasten weiter vorwärts und rückwärts geblättert
bzw. positioniert werden. Wenn die Aktion erfolgreich war (es wurde also
nicht versucht, am Anfang oder Ende weiter zu blättern), wird nach der
Neupositionierung des Inversbalkens der zugehörige Makro ausgeführt.
Der
ON SELECT(MOUSE) Makro wird im SELECT/SELECTA ausgeführt, wenn die linke
Maustaste betätigt wurde und gleichzeitig eine oder mehrere der Tasten
SHIFT, ALT oder Strg gedrückt sind.
Der
ON SELECT(RMOUSE) Makro wird im SELECT/SELECTA ausgeführt, wenn die rechte
Maustaste gedrückt wird
Der
ON SELECT(RBUTTONUP) Makro wird im SELECT/SELECTA ausgeführt, wenn die
rechte Maustaste nach dem Drücken wieder losgelassen wird
Der
ON SELECT(MOUSE_HEADER) Makro wird im SELECT/SELECTA ausgeführt, wenn die
linke Maustaste wenn die linke Maustaste in einem Feld der
Überschriftszeile gedrückt wurde.
Der
ON SELECT(RMOUSE_HEADER) Makro wird im SELECT/SELECTA ausgeführt, wenn die
rechte Maustaste in einem Feld der Überschriftszeile gedrückt wird
Der
ON SELECT(RBUTTONUP_HEADER) Makro wird im SELECT/SELECTA ausgeführt, wenn
die rechte Maustaste in einem Feld der Überschriftszeile nach dem Drücken
wieder losgelassen wird
|
|
SELECT(KEY)
|
Der Makro wird
ausgeführt, wenn im SELECT, SELECTA oder TREEVIEW
eine Taste mit ASCII-Wert 1 bis 255 (also keine Funktionstasten) gedrückt
wird. Die Variable EBUS_SELECT_KEY enthält dann den ASCII-Wert der gedrückten Taste.
Achtung:
Diese Anweisung hat keine Wirkung bei Html-Programmen.
|
|
SELECT_STARTED
|
Der Makro wird ausgeführt, nachdem der SELECT/SELECTA
gestartet und am Bildschirm angezeigt wurde.
|
|
SET_FOCUS
|
Der Makro
wird ausgeführt, wenn mit SET_FOCUS ein Window aktiviert wird. EBUS_WDEPTH enthält die Windowtiefe.
|
|
STDOUT
|
Der Makro
wird ausgeführt, wenn eine Zeile in die Standardausgabe geschrieben wird. EBUS_STDOUT$ enthält die Zeile.
|
|
TABCONTROL_CHANGE
|
Der
Makro wird ausgeführt, wenn im Tabcontrol eine andere Karteikarte aktiviert
werden soll. Die Variable EBUS_DATA
enthält die Nummer der Karteikarte, die aktiviert werden soll. EBUS_DATA$ enthält die Maskennummer. Wird im
Makro EBUS_TRANSFER = 1 gesetzt, so
wird die Karteikarte nicht aktiviert.
|
|
TIMER
TIMER2
TIMER3
TIMER4
TIMER5
TIMER6
TIMER7
TIMER8
TIMER9
TIMER10
TIMER11
TIMER12
TIMER13
TIMER14
TIMER15
TIMER16
|
Es können 16 Timer definiert werden.
Der
Timer wird alle EBUS_TIMER_TIMEOUT Millisekunden ausgehrt.
Soll
das Timeout-Intervall eines bereits laufenden Timers geändert werden, so
muss der Variablen EBUS_TIMER_TIMEOUT
der neue Intervallwert zugewiesen und anschließend die Anweisung ON TIMER
MACRO erneut ausgeführt werden.
Hat
die Variable EBUS_TIMER_TIMEOUT
einen Wert <= 0, so hat die Anweisung ON TIMER MACRO keine Wirkung.
Für
jede Ausführung des ON TIMER MACRO wird ein eigener Thread gestartet. Es
ist damit möglich, dass der ON TIMER MACRO mehrere Male gleichzeitig
parallel ausgeführt wird. ON TIMER RESET führt dazu, dass alle aktuell
laufenden Makros des Timers abgebrochen werden. Dies kann zu
Fehlermeldungen führen.
Wird
im ON TIMER MACRO die Anweisung ON TIMER RESET ausgeführt, so wird der
gerade laufende Thread nicht beendet, sondern nur alle anderen laufenden
Threads dieses Timers.
|
|
TREEVIEW_EDIT
|
Der Makro wird ausgeführt, wenn die Editierung
eines Elementes eines TREEVIEW beendet
wurde. EBUS_DATA enthält die Nummer des
editierten Elementes und EBUS_DATA$
enthält den Text des editierten Elementes.
Achtung:
Wenn die Editierung mit ESC beendete wurde, enthält EBUS_DATA$ den ursprünglichen Wert des
Elementes.
|
|
WINDOW_ACTIVATE
|
Der
Makro wird jedes Mal ausgeführt, wenn ein Fenster den Focus erhält oder
verliert. EBUS_TRANSFER = 1, wenn das
Fenster den Focus erhält und = 0, wenn das Fenster den Focus verliert.
EBUS_TRANSFER2 enthält die Windowtiefe.
|
|
WRITE(<INDEXDATEI>)
|
Der Makro jedes Mal ausgeführt, wenn ein Schreibzugriff
auf die Indexdatei <INDEXDATEI> erfolgte und bei dem Zugriff kein
Fehler auftrat.
|
|
WRITE_ALL
|
Der Makro wird jedes Mal dann ausgeführt, wenn eine WRITE-Anweisung für irgendeine
Indexdatei erfolgte und dabei kein Fehler auftrat.
Achtung: Wenn in diesem Makro andere
Indexdateien geschrieben werden, muss zuvor ON WRITE_ALL RESET ausgeführt
werden, andernfalls wird durch rekursive Aufrufe ein Endlos-Loop erzeugt.
|
Die ON
<Ereignis> Makros sind global bezüglich Haupt- und Unterprogramme, d.h.
sie gelten im Hauptprogramm und allen Unterprogrammen.
ON
<Ereignis> RESET schaltet einen ON <Ereignis> MACRO wieder aus.
Bei
den ON SELECT(<Taste>) Makros kann ein <Hilfetext> angegeben
werden. Die Wirkung ist dieselbe wie bei den ON <Taste> Makros (siehe
oben).
|