.. highlightlang:: us

.. index:: MnSetCommand

.. _mnsetcommand:

MnSetCommand
============

.. us.tag  MnSetCommand GERMAN Menu Changed300

:ref:`MnSetCommand` ordnet einem Menüeintrag ein UniScript-Kommando zu.

.. function::  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)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion ausgeführt werden konnte und sonst
FALSE (0).

.. us.params

**Parameter**

.. uparam:: nCommandID

   *nCommandID* ist eine Identifikations-Nummer eines Menü Eintrags, der mit der
   Funktion :ref:`MnAppend` oder :ref:`MnInsert` definiert wurde. Eine eindeutige
   *nCommandID* kann von der Funktion *MnGetNewCommandID* erzeugt werden.

.. uparam:: 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 :ref:`MnAppend`).

.. uparam:: ssMenuText

   *ssMenuText* ist eine Zeichenkette mit dem Menütext. Dieser Parameter wird nur
   bei Popup-Menüs verwendet (rechte Maustaste).

.. uparam:: 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.

.. uparam:: ssStatusBarText

   Ist ein Text, der in der Statuszeile angezeigt wird. 

.. uparam:: ssCategory

   Mit Hilfe des Parameters *ssCategory* können die Kommandos in Kategorien
   eingeteilt werden. Im Dialogfeld :ref:`extrasbenutzerschalterleiste-einrichten`
   wird die Kategorietext vor dem Schaltertext getrennt durch die Zeichen ``=>``
   angezeigt.

.. uparam:: ssBitmapFile

   Ist der vollständige Name mit Pfadangabe einer Bitmap-Datei. Wird nur der Name
   des Bitmaps angegeben (z. B. :file:`spline.bmp`), muss sich die Bitmap-Datei
   im Verzeichnis :file:`UniPlot\\bitmap` befinden. Das Bitmap sollte 16 Pixel
   breit und 15 Pixel hoch sein und als 256-Farben Bitmap gespeichert werden.
   Siehe :ref:`RegisterCommand`.

.. us.example

**Beispiel**

::

   nID = MnGetNewCommandID()
   MnAppend("Editor", 4, nID, "Show Version Info")
   MnSetCommand(nID, "ShowVersionInfo");
   MnDrawMenuBar()
   def ShowVersionInfo()
   {
       MessageBox("Version: " + version());
   }

.. seealso::
   :ref:`uberblick-menus`,
   :ref:`MnAppend`,
   :ref:`MnInsert`,
   :ref:`MnGetNewCommandID`,
   :ref:`MnDrawMenuBar`,
   :ref:`RegisterCommand`

:sub:`id-1510899`