MnSetCommand¶
MnSetCommand ordnet einem Menüeintrag ein UniScript-Kommando zu.
- bool = MnSetCommand(ssCommand, ssMenuText)
- bool = MnSetCommand(nCommandID, ssCommand)
- bool = MnSetCommand(nCommandID, ssCommand, ssToolTip)
- bool = MnSetCommand(nCommandID, ssCommand, ssToolTip, ssStatusBarText)
- bool = MnSetCommand(nCommandID, ssCommand, ssToolTip, ssStatusBarText, ssMenuText, ssCategory, ssBitmapFile)
Returnwert
bool ist TRUE (1), wenn die Funktion ausgeführt werden konnte und sonst FALSE (0).
Parameter
- nCommandID
nCommandID ist eine Identifikations-Nummer eines Menü Eintrags, der mit der Funktion MnAppend oder MnInsert definiert wurde. Eine eindeutige nCommandID kann von der Funktion MnGetNewCommandID erzeugt werden.
- ssCommand
ssCommand ist eine Zeichenkette die zum UniScript-Interpreter geschickt wird, wenn ein Menüpunkt mit der nCommandID ausgewählt wurde. Normalerweise wird hier ein Funktionsaufruf stehen (siehe Beispiel bei MnAppend).
- ssMenuText
ssMenuText ist eine Zeichenkette mit dem Menütext. Dieser Parameter wird nur bei Popup-Menüs verwendet (rechte Maustaste).
- ssToolTip
Ist ein Text, der angezeigt wird, wenn sich der Mauszeiger über der Schaltfläche befindet. Der Text kann aus mehreren Zeilen bestehen. Für den Zeilenumbruch wird ein
\n
eingegeben.
- ssStatusBarText
Ist ein Text, der in der Statuszeile angezeigt wird.
- ssCategory
Mit Hilfe des Parameters ssCategory können die Kommandos in Kategorien eingeteilt werden. Im Dialogfeld Extras=>Benutzerschalterleiste einrichten wird die Kategorietext vor dem Schaltertext getrennt durch die Zeichen
=>
angezeigt.
- ssBitmapFile
Ist der vollständige Name mit Pfadangabe einer Bitmap-Datei. Wird nur der Name des Bitmaps angegeben (z. B.
spline.bmp
), muss sich die Bitmap-Datei im VerzeichnisUniPlot\bitmap
befinden. Das Bitmap sollte 16 Pixel breit und 15 Pixel hoch sein und als 256-Farben Bitmap gespeichert werden. Siehe RegisterCommand.
Beispiel
nID = MnGetNewCommandID()
MnAppend("Editor", 4, nID, "Show Version Info")
MnSetCommand(nID, "ShowVersionInfo");
MnDrawMenuBar()
def ShowVersionInfo()
{
MessageBox("Version: " + version());
}
Siehe auch
Überblick Menüs, MnAppend, MnInsert, MnGetNewCommandID, MnDrawMenuBar, RegisterCommand
id-1510899