Class MenuItem

Namespace

Terminal.Gui

Assembly

Terminal.Gui.dll

A MenuItem has title, an associated help text, and an action to execute on activation. MenuItems can also have a checked indicator (see Checked).

public class MenuItem

Inheritance

object

MenuItem

Derived

MenuBarItem

Inherited Members

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

Constructors

MenuItem(ustring, ustring, Action, Func<bool>, MenuItem, Key)

Initializes a new instance of MenuItem.

MenuItem(Key)

Initializes a new instance of MenuItem

Fields

HotKey

The HotKey is used to activate a MenuItem with the keyboard. HotKeys are defined by prefixing the Title of a MenuItem with an underscore ('_').

Pressing Alt-Hotkey for a MenuBarItem (menu items on the menu bar) works even if the menu is not active). Once a menu has focus and is active, pressing just the HotKey will activate the MenuItem.

For example for a MenuBar with a "_File" MenuBarItem that contains a "_New" MenuItem, Alt-F will open the File menu. Pressing the N key will then activate the New MenuItem.

See also Shortcut which enable global key-bindings to menu items.

Properties

Action

Gets or sets the action to be invoked when the menu item is triggered.

CanExecute

Gets or sets the action to be invoked to determine if the menu can be triggered. If CanExecute returns true the menu item will be enabled. Otherwise, it will be disabled.

CheckType

Sets or gets the MenuItemCheckStyle of a menu item where Checked is set to true.

Checked

Sets or gets whether the MenuItem shows a check indicator or not. See MenuItemCheckStyle.

Data

Gets or sets arbitrary data for the menu item.

Help

Gets or sets the help text for the menu item. The help text is drawn to the right of the Title.

Parent

Gets the parent for this MenuItem.

Shortcut

Shortcut defines a key binding to the MenuItem that will invoke the MenuItem's action globally for the View that is the parent of the MenuBar or ContextMenu this MenuItem.

The Key will be drawn on the MenuItem to the right of the Title and Help text. See ShortcutTag.

ShortcutTag

Gets the text describing the keystroke combination defined by Shortcut.

Title

Gets or sets the title of the menu item .

Methods

GetMenuBarItem()

Merely a debugging aid to see the interaction with main.

GetMenuItem()

Merely a debugging aid to see the interaction with main.

IsEnabled()

Returns true if the menu item is enabled. This method is a wrapper around CanExecute.