.. highlightlang:: us

.. index:: MnAppend

.. _mnappend:

MnAppend
========

.. us.tag  MnAppend GERMAN Menu

Die Funktion hängt entweder ein leeres Menü an eine Menüleiste oder einen
einzelnen Menüeintrag an ein Menü an.

.. function::  bool = MnAppend(ssMenu, nCommandID, ssMenuString)
    bool = MnAppend(ssMenu, nCommandID, ssMenuString, nFlag)
    bool = MnAppend(ssMenu, nMenu, nCommandID, ssMenuString)
    bool = MnAppend(ssMenu, nMenu, nCommandID, ssMenuString, nFlag)

.. us.return

**Returnwert**

*bool* ist TRUE (1) wenn das Menü-Item eingefügt werden konnte und sonst
FALSE (0).

.. us.params

**Parameter**

.. uparam:: ssMenu

   ist der Name der Menüleiste (menu bar). Es gibt folgende Menüleisten:

   .. list-table::
      :header-rows: 1

      * - 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.

.. uparam:: nMenu

   ist die Position des Menüs. Der am weitestens links stehende Eintrag
   (i. Allg. das Datei-Menü) hat die Position 1.

.. uparam:: nCommandID

   Ist eine Nummer zwischen 1 und 255, der ein UniScript-Kommando mit der
   Funktion :ref:`MnSetCommand` zugewiesen werden kann.

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

.. uparam:: nFlag

   *nFlag* ist einer der folgenden Werte:

   .. list-table::
      :header-rows: 1

      * - Wert
        - Bedeutung
      * - MF_SEPARATOR
        - Separator (horizontale Linie).
      * - MF_MENUBREAK
        - Menü in neuer Spalte.
      * - MF_MENUBARBREAK
        - Menü in neuer Spalte mit Separator.

.. us.example

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

.. seealso::
   :ref:`uberblick-menus`,
   :ref:`MnInsert`,
   :ref:`MnDrawMenuBar`,
   :ref:`MnSetCommand`

:sub:`id-1481876`