<<

Inhaltsverzeichnis

Suchen

>>

 

ON

 

 

Anweisung

 

 

Syntax:

ON <Taste> MACRO <Makroname>[,<Hilfetext>]

ON <Ereignis> MACRO <Makroname>[,<Hilfetext>]

 

ON <Taste> RESET

ON <Ereignis> RESET

 

<Makroname>

= <MAKRONAME>

<Hilfetext>

= <STRING-AUSDRUCK>

 

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

 

Parameter:

Makroname

Name des Makros

Hilfetext

[@<Iconname>,]<Text>

 

Beispiel:

ON F3 MACRO SUCHEN,"@such.gif,Suchen Kunden"

 

ON SELECT(F3)  MACRO WEITERE.INFOS,"@weiter.jpg,Weitere Informationen"

 

Siehe auch:

GET_KEYSTATE