<<

Inhaltsverzeichnis

Suchen

>>

 

START_MENU

 

 

Funktion

 

 

Syntax:

START_MENU([<Startmenuepunkt>[,<Handle>]])

 

<Startmenuepunkt>

= <STRING-AUSDRUCK>

<Handle>

= <NUM-AUSDRUCK>

 

Bedeutung:

Das Menue, das mit den Funktionen ADD_MENU aufgebaut wurde, wird im Fenster <Handle> gestartet.

 

<Handle> legt fest, in welchem Fenster das Menue angezeigt wird. <Handle> kann die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder eines WINDOWCALL-Windows enthalten. Fehlt der Parameter <Handle> oder ist <Handle> ungültig, so wird Menue im Mainwindow angezeigt.

 

<Startmenuepunkt> legt den Menuepunkt fest, der nach dem Starten des Menues sofort aufgerufen wird. Es muss der Menuetext so angegeben werden, wie er bei ADD_MENU definiert wurde, also inklusive des Zeichens ‘&’ (falls vorhanden).

 

Der Schalter ENABLE / DISABLE MENU_WAIT steuert, wann die Funktion START_MENU zurückkehrt: Bei ENABLE MENU_WAIT wird die Funktion START_MENU erst dann beendet, wenn die Anweisung ENDMENU ausgeführt wird. Bei DISABLE MENU_WAIT wird das Menue gestartet und die Funktion START_MENU kehrt sofort mit dem Ergebniswert zurück. Das Menue bleibt aber trotzdem so lange aktiv, bis die Anweisung ENDMENU ausgeführt wird.

 

Wird START_MENU in einem Unterprogramm ausgeführt, so wird das Menue automatisch beendet, wenn das Unterprogramm beendet wird.

 

Bei ENABLE  MENU_CLOSE werden beim Aufruf eines Menuepunktes der zuvor ausgewählte Menuepunkt beendet und alle NOWAIT-Fenster bis zur Windowtiefe von <Handle> geschlossen.

 

START_MENU liefert folgende Ergebniswerte:

 

0

kein Fehler

-1

Laufzeitfehler

6002

Doppelter Aufruf von START_MENU

6008

Das Menue ist leer.

 

Parameter:

Startmenuepunkt

Menuepunkt, der sofort aufgerufen wird.

Handle

Enthält die Windowtiefe oder die Identifizierungsnummer eines Splitwindows oder eines WINDOWCALL-Windows.

 

Beispiel:

H% = START_MENU("Ö&ffnen")

 

Siehe auch:

ADD_MENU

DEL_MENU

ENDMENU

START_POPUPMENU

EBUS_REOPEN_MENU