<<

Contents

Search

>>

 

ON

 

 

Instruction

 

 

Syntax:

ON <Key> MACRO <Macroname>[,<Helptext>]

ON <Event> MACRO <Macroname>[,<Helptext>]

 

ON <Key> RESET

ON <Event> RESET

 

<Macroname>

= <MACRONAME>

<Helptext>

= <STRING-EXPRESSION>

 

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).

 

Parameter:

Macroname

Name of macro

Helptext

[@<Iconname>,]<Text>

 

Sample:

ON F3 MACRO SEARCH,"@search.gif,Search Customer"

 

ON SELECT(F3)  MACRO ADDITIONAL.INFOS,"@add.jpg,Additional Informations"

 

See also:

GET_KEYSTATE