|
Meaning:
|
Der
ON <Key> MACRO wird ausgeführt, wenn in einem Maskenfeld die Taste
<Key> 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
Macro <Macroname> kann mit GET_KEYSTATE
geprüft werden, ob eine der Tasten Alt oder Ctrl gleichzeitig mit der Taste
<Taste> gedrückt wurde.
Vor
der Ausführung eines ON <Key> MACRO werden die Variablen EBUS_FDATA und EBUS_FDATA$ mit dem
aktuellen Maskenfeldinhalt belegt.
Im
<Helptext> 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.
<Helptext> ist folgendermaßen aufgebaut:
[@<Iconname>,]<Text>
<Iconname> = <STRING-AUSDRUCK>
<Text> = <STRING-AUSDRUCK>
Die ON
<Key> Macros sind lokal bezüglich Haupt- und Unterprogramme. Dies
bedeutet, dass jedes Haupt- bzw. Unterprogramm seine eigenen ON <Key>
Macros besitzt.
ON
<Key> RESET schaltet einen ON <Key> MACRO wieder aus.
Der
ON <Event> MACRO wird ausgeführt, wenn das Ereignis eintritt. Folgende
Ereignisse sind möglich:
|
Ereignis
|
Bedeutung
|
|
BEGIN_READ(<INDEXDATEI>)
|
Der
Macro wird jeweils vor der Lesezugriff (READ, START, READ-NEXT,
READ-PREVIOUS) ausgeführt. Wird im
Macro die Variable EBUS_TRANSFER = 0
gesetzt, so wird der Datensatz nicht gelesen und in OK wird die Fehlernummer 1098
geliefert.
|
|
DELETE(<INDEXDATEI>)
|
Der
Macro wird jedes Mal dann ausgeführt, wenn ein Löschzugriff auf die Indexdatei erfolgte und bei
dem Zugriff kein Fehler auftrat.
|
|
DOUBLECLICK
|
Der
Macro 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
Macro 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.
|
|
INDEXERROR
|
Der
Macro 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
Macro 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 Macros wird mit der ersten Anweisung im
Block ON ERROR ... END fortgefahren.
|
|
KEY
|
Der
Macro 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 Macro geändert werden.
Nach der Ausführung des Macros 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
Macro 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 Macros = 0 gesetzt. Wird im Macro 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.
|
|
LPRINT_LPRECORDER
|
Der
Macro 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.
|
|
MENU
|
Der
Macro 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 Macros wird diese Variable =1 gesetzt. Ist sie nach
der Ausführung des Macros =0, so wird der ausgewählte Menuepunkt nicht
angesprungen.
|
|
MESSAGE
|
Der
Macro wird anstelle der Anweisungen MESSAGE
und ERRORMES ausgeführt.
Im
Macro kann die Art der Meldung über die Variable MESSAGETYPE und die
Meldung selbst über die Variable MESSAGE$ erhalten
werden.
Innerhalb
des Macros sind die Anweisungen MESSAGE und ERRORMES zulässig. Sie werden dort nicht mehr
umgeleitet.
|
|
MOUSE
|
Der
Macro 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.
|
|
MOUSEMOVE
|
Der
Macro 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.
|
|
RBUTTONUP
|
Der
Macro wird ausgeführt, wenn die rechte Maustaste nach dem Drücken wieder losgelassen
wird. Ist ein ON RMOUSE MACRO definiert, so wird dieser nicht ausgeführt.
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.
|
|
READ(<INDEXDATEI>)
|
Der
Macro wird jedes Mal dann ausgeführt, wenn ein erfolgreicher Lesezugriff
READ, READS,
START, STARTS,
READ-NEXT,
READ-PREVIOUS,
READS-NEXT,
READS-PREVIOUS
ausgeführt
wurde.
Der
Macro 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.
|
|
RESIZE
|
Der
Macro wird jedes Mal ausgeführt, wenn sich die Größe des main windows
ändert. Die Variable EBUS_MAINSIZE enthält
die Information über die Größe des main windows.
|
|
RMOUSE
|
Der Macro
wird ausgeführt, wenn die rechte Maustaste gedrückt wird.
Der
ON RMOUSE MACRO wird nur ausgeführt, wenn kein ON RBUTTONUP MACRO definiert
ist.
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.
|
|
SELECT
|
Der
Macro wird jedes Mal ausgeführt, wenn in einer SELECT-Funktion
ein Datensatz einer Indexdatei
gelesen wurde. Der Macro wird ausgeführt bevor der Datensatz am
Bildschirm angezeigt wird. In diesem Macro 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 Macros die Anzeige des Datensatzes unterdrückt,
andernfalls wird der Datensatz angezeigt. Jedes Mal vor der Ausführung des
Macros 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(<Key>)
|
Der
Macro wird jedes Mal dann ausgeführt, wenn im SELECT
oder SELECTA 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_PGUP, SHIFT_PGDN
SHIFT_INS,
SHIFT_DEL
TABRIGHT, TABLEFT
RETURN
MOUSE
RMOUSE
RBUTTONUP
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 Macro
ausgeführt.
Der
ON SELECT(MOUSE) Macro 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(RBUTTONUP) Macro wird ausgeführt, wenn die rechte Maustaste nach
dem Drücken wieder losgelassen wird. Ist ein ON SELECT(RMOUSE) Macro
definiert, so wird dieser nicht
ausgeführt, wenn ein ON SELECT(RBUTTONUP) Macro definiert ist.
|
|
SELECT(KEY)
|
Der Macro wird
ausgeführt, wenn im SELECT/SELECTA 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.
|
|
SELECTLINE
|
Dieser
Macro wird jedes Mal dann ausgeführt, wenn ein einzelnes Feld einer Zeile
im SELECT am Bildschirm angezeigt wurde.
Folgende Variablen sind dabei gesetzt:
EBUS_SELECT_FIELD enthält
die Nummer des angezeigten Feldes (= Spalte des SELECT).
EBUS_SELECT_COLUMN enthält
die Spalte des angezeigten Feldes (X-Koordinate).
EBUS_SELECT_ROW enthält
die Zeile des angezeigten Feldes (Y-Koordinate).
Dieser
Macro kann z.B. dazu verwendet werden, in den SELECT-Zeilen mit Hilfe der
Funktionen DRAWLINE und FILLRECT Diagramme anzuzeigen.
Achtung: Dieser Macro wird
ausgeführt während die SELECT-Zeilen am Bildschirm angezeigt werden. Der
zugehörige Datensatz der Indexdatei wurde dabei bereits gelesen. Deshalb
ist in diesem Macro die Anweisung READSELECT nicht
notwendig und auch nicht zulässig.
|
|
SET_WDEPTH
|
Der Macro
wird ausgeführt, wenn mit SET_WDEPTH ein Window aktiviert wird. EBUS_WDEPTH enthält die Windowtiefe.
|
|
TABCONTROL_CHANGE
|
Der
Macro 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
Macro 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 Macros 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.
|
|
WINDOW_ACTIVATE
|
Der
Macro 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 Macro jedes Mal ausgeführt, wenn ein
Schreibzugriff auf die Indexdatei erfolgte und bei dem Zugriff kein Fehler
auftrat.
|
Die ON
<Event> Macros sind global bezüglich Haupt- und Unterprogramme, d.h. sie
gelten im Hauptprogramm und allen Unterprogrammen.
ON
<Event> RESET schaltet einen ON <Event> MACRO wieder aus.
Bei
den ON SELECT(<Key>) Macros kann ein <Helptext> angegeben werden.
Die Wirkung ist dieselbe wie bei den ON <Key> Macros (siehe oben).
|