<<

Inhaltsverzeichnis

Suchen

>>

 

ADD_MENU

 

 

Funktion

 

 

Syntax:

ADD_MENU(<Menuestufe>,<Hauptmenue>,<Untermenue>,<Makroname>)

 

<Menuestufe>

= <STRING-AUSDRUCK>

<Hauptmenue>

= <STRING-AUSDRUCK>

<Untermenue>

= <STRING-AUSDRUCK>

<Makroname>

= <MAKRONAME>

 

 

Bedeutung:

Mit der Funktion ADD_MENU wird ein Zweig eines Menuebaums erzeugt, der im Mainwindow angezeigt wird.

 

Beim Aufbau eines Menues ist folgendermaßen vorzugehen:

 

1. Mit der Funktion ADD_MENU werden die Zweige des Menues erzeugt.

2. Mit START_MENU wird das Menue gestartet.

 

ADD_MENU liefert folgende Ergebniswerte:

 

Returncode

Bedeutung

0

Kein Fehler

6001

Fehlerhafte oder ungültige Menuestufe

 

Parameter:

Menuestufe

Legt fest, an welcher Stelle im Menuebaum der neue Zweig seinen Platz findet. <Menuestufe> darf nur aus Ziffern und Punkten zwischen den Ziffern bestehen.

 

Beispiele:

"1" legt Menuestufe 1 fest

"1.2" bezieht sich auf den 2. Untermenuepunkt von Menuestufe "1".

"1.2.1" bezieht sich auf den 1. Untermenuepunkt von Menuestufe "1.2".

 

Die obersten Menuestufen ("1", "2", ...) müssen nicht lückenlos aufsteigend sein. Sie müssen auch nicht unbedingt in aufsteigender Reihenfolge mit der Funktion ADD_MENU definiert werden. Untergeordnete Menuezweige können jedoch nur definiert werden, wenn der zugehörige übergeordnete Zweig bereits vorhanden ist.

 

Hauptmenue

Legt des Namen des übergeordneten Menuepunktes fest.

 

Wird ein Untergeordneter Menuezweig angelegt, so wird der Name Untermenuename im übergeordneten Menuepunkt durch den Hauptmenuenamen ersetzt.

 

Beispiel:

H% = ADD_MENU("1","Datei","Öffnen;Schließen;;Programmende"

H% = ADD_MENU("1.2","Open","Bilddatei;Textdatei"

 

Der 2. Menuepunkt heißt jetzt nicht mehr Öffnen sondern Open.

 

Untermenue

In <Untermenue> stehen durch Strichpunkte getrennt die Namen der Untermenuepunkte. Dabei sind leere Einträge zulässig. Ein leerer Eintrag führt zu einer Trennlinie im Menue. Am Anfang eines  Untermenuenamens können durch Komma getrennt zwei Bilder angegeben werden. Das erste Bild @<Bild-1> wird angezeigt, wenn der Menuepunkt nicht markiert ist, das zweite Bild @<Bild-2> wird angezeigt, wenn der Menuepunkt markiert ist.

 

Ein Untermenuepunkt ist also folgendermaßen aufgebaut:

 

[@<Bild-1>,[@<Bild-2>,]]<Untermenuename>

 

In den einzelnen Namen (Haupt- und Untermenue) kann das Zeichen ‘&’ zur Hervorhebung eines Zeichens verwendet werden. Der Menuepunkt kann dann über ALT/<Zeichen> ausgewählt werden.

 

Im Namen kann auch eine Control- oder Funktionstaste angegeben werden. Die Taste muss durch ein Leerzeichen getrennt am Ende des Namens stehen, z.B. "Erfassen  CTRL/A".

 

Makroname

Der Makro wird aufgerufen, wenn ein Menuepunkt ausgewählt wurde. Es ist zulässig, denselben Makro bei mehreren Menuezweigen anzugeben. Wenn der Makro ausgeführt wird, enthält die Variable EBUS_MENU$ den Namen des ausgewählten Menuepunktes.

 

Beispiel:

H% = ADD_MENU("1","&Dateien","&Erfassen;&Löschen;&Anzeigen",MEN.MACRO)

IF H%<>0 THEN ... Fehler... ENDIF

H% = ADD_MENU("2","Dr&ucken  F8","@einzeln.gif,&Einzeln;;@alles.gif,&Alles",MEN.MACRO)

IF H%<>0 THEN ... Fehler... ENDIF

H% = ADD_MENU("3","&Ende  CTRL/E","",MEN.MACRO)

IF H%<>0 THEN ... Fehler... ENDIF

H% = ADD_MENU("2.3","&Alles","&Aufsteigend;A&bsteigend",MEN.MACRO)

IF H%<>0 THEN ... Fehler... ENDIF

 

Siehe auch:

DEL_MENU

START_MENU

EBUS_MENU$

ACTIVATE

DEACTIVATE

ADD_POPUPMENU

ENDMENU