.. highlightlang:: us

.. index:: MnSetChecked

.. _mnsetchecked:

MnSetChecked
============

.. us.tag  MnSetChecked ENGLISH Menu

:ref:`MnSetChecked` checks or unchecks a menu item.

.. function::  bool = MnSetChecked(ssMenue, nMenu, nItem, bChecked)

.. us.return

**Return Value**

If the function succeeds, the return value *bool* is TRUE (1); otherwise it is
FALSE (0).

.. us.params

**Parameters**

.. uparam:: ssMenue

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

.. uparam:: nItem

   *nItem* is the position of the menu within the menu nMenu.

.. uparam:: bChecked

   If *bChecked* is TRUE (1) the menu will be marked. When it is FALSE (0) the
   marking will be removed.

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

:sub:`id-563061`