<<

Inhaltsverzeichnis

Suchen

>>

 

ADD_POPUPMENU

 

 

Funktion

 

 

Syntax:

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

 

<Menuestufe>

= <STRING-AUSDRUCK>

<Hauptmenue>

= <STRING-AUSDRUCK>

<Untermenue>

= <STRING-AUSDRUCK>

<Makroname>

= <MAKRONAME>

 

 

Bedeutung:

Mit der Funktion ADD_POPUPMENU wird ein Popup-Menuebaum erzeugt, der anschließend durch START_POPUPMENU zur Abarbeitung aufgerufen werden kann.

 

Für ADD_POPUPMENU gelten dieselben Regeln und Rückgabewerte wie für die Funktion ADD_MENU.

 

Beim Aufbau eines Popup-Menues ist folgendermaßen vorzugehen:

 

1. Mit der Funktion ADD_POPUPMENU werden die Zweige des Popup-Menues erzeugt.

2. Mit START_POPUPMENU wird das Popup-Menue gestartet.

 

ADD_POPUPMENU 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_POPUPMENU 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 Hauptmenunamen ersetzt.

 

Beispiel:

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

H% = ADD_POPMENU("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>

 

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_POPUPMENUE("1","&Suchen","nach &Name;nach &Ort",POPUPMEN.MACRO)

 

Siehe auch:

DEL_POPUPMENU

START_POPUPMENU

EBUS_MENU$

POPUPACTIVATE

POPUPDEACTIVATE

ADD_MENU