MnAppend¶
Die Funktion hängt entweder ein leeres Menü an eine Menüleiste oder einen einzelnen Menüeintrag an ein Menü an.
- bool = MnAppend(ssMenu, nCommandID, ssMenuString)
- bool = MnAppend(ssMenu, nCommandID, ssMenuString, nFlag)
- bool = MnAppend(ssMenu, nMenu, nCommandID, ssMenuString)
- bool = MnAppend(ssMenu, nMenu, nCommandID, ssMenuString, nFlag)
Returnwert
bool ist TRUE (1) wenn das Menü-Item eingefügt werden konnte und sonst FALSE (0).
Parameter
- ssMenu
ist der Name der Menüleiste (menu bar). Es gibt folgende Menüleisten:
Wert
Bedeutung
„Editor“
Dieses Menü wird angezeigt, wenn ein Editor aktiv ist.
„Document“
Dieses Menü wird angezeigt, wenn ein Dokument mit Diagrammseiten aktiv ist.
„DocumentServer“
Dieses Menü wird angezeigt, wenn eine UniPlot-Dokumentseite in einem anderen Anwendungsprogramm eingebettet ist (OLE).
„Command“
Dieses Menü wird angezeigt, wenn das UniScript-Kommandofenster aktiv ist.
„Main“
Dieses Menü wird angezeigt, wenn keine MDI-Fenster im UniPlot-Hauptfenster vorhanden sind. Das ist normalerweise der Fall nachdem UniPlot gestartet wurde.
- nMenu
ist die Position des Menüs. Der am weitestens links stehende Eintrag (i. Allg. das Datei-Menü) hat die Position 1.
- nCommandID
Ist eine Nummer zwischen 1 und 255, der ein UniScript-Kommando mit der Funktion MnSetCommand zugewiesen werden kann.
- ssMenuString
ssMenuString ist eine Zeichenkette, die im Menü erscheint. Will man einen Buchstaben des Menüeintrags unterstreichen, damit der Menüpunkt leichter mit der Tastatur ausgewählt werden kann, muss vor den Buchstaben ein kaufmännisches Und eingegeben werden, z. B.
"&Help".
- nFlag
nFlag ist einer der folgenden Werte:
Wert
Bedeutung
MF_SEPARATOR
Separator (horizontale Linie).
MF_MENUBREAK
Menü in neuer Spalte.
MF_MENUBARBREAK
Menü in neuer Spalte mit Separator.
Beispiel
Zunächst wird eine Funktion geschrieben, die beim Betätigen eines Menüpunktes ausgeführt werden soll:
def Test()
{
MessageBox("Menü Test gewählt!");
}
Nun wird ein Menüpunkt an das Ende des Dokument-Menüs angehängt. Das
Dokument-Menü hat nun die Einträge "Datei" bis "Hilfe" und anschließend
daran den Eintrag "Test".
MnAppend("Document", 99, "&Test");
Nun den Menübalken neu zeichnen:
MnDrawMenuBar();
Nun wird der Kommando-Nummer 99 die UniScript-Funktion Test() zugewiesen.
Wenn der Menüpunkt mit dem Kommando-Nummer 99 betätigt wird, wird die Funktion
test() aufgerufen
MnSetCommand(99, "test()");
Siehe auch
id-1481876