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