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()");

id-1481876