.. highlightlang:: us

.. index:: MnGetStrings

.. _mngetstrings:

MnGetStrings
============

.. us.tag  MnGetStrings ENGLISH Menu Changed400

:ref:`MnGetStrings` returns the menu item strings of the specified menu.

.. function::  svMenus = MnGetStrings()
    svMenuStrings = MnGetStrings(ssMenu)
    svMenuStrings = MnGetStrings(ssMenu, nMenu)

.. us.return

**Return Value**

*svMenuStrings* is a string vector with the menu item names.If the function is
called without parameters the return value is a string vector with the names of
the menu bars. See parameter *ssMenu*.

In case of an error the return value is an empty string.

.. us.params

**Parameters**

.. uparam:: ssMenu

   *ssMenu* is the name of the menu bar. The following menus are available:

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

      * - Value
        - Meaning
      * - "Editor"
        - This menu appears when an editor is active.
      * - "Document"
        - This menu appears when a document with diagram pages is active.
      * - "DocumentServer"
        - This menu appears when the UniPlot document page is embedded in another application program (OLE).
      * - "Command"
        - This menu appears when the UniScript command window is active.
      * - "Main"
        - This menu appears when no MDI window is available in the UniPlot main window. This is normally the case after UniPlot has be started.

.. uparam:: nMenu

   *nMenu* is the position of the menu. The entry that lies farthest left
   (normally the File Menu) has the position 1.

.. us.example

**Example**

.. highlight:: none

::

   * MnGetStrings("SynEditor")

   &File
   &Edit
   &View
   UniScript
   &Tools
   &Window
   &Help

   * MnGetStrings("SynEditor", 2)

   &Undo Strg+Z
   &Redo Strg+Y

   Cu&t  Ctrl+X
   &Copy Ctrl+C
   &Paste  Ctrl+V
   &Delete Del...
   Select &All    Ctrl+A

   &Find...   Alt+F3
   Find &Next  F3
   Find &Previous  Shift+F3
   Re&place... Ctrl+H

   &Objekt Eigenschaften   Alt+Enter
   Alles &markieren
   &Zeilenumbruch

.. highlight:: us

.. seealso::
   :ref:`overview-menus`,
   :ref:`MnAppend`,
   :ref:`MnInsert`

:sub:`id-1189615`