Class MenuBar

Provides a menu bar with drop-down and cascading menus.
Inheritance
System.Object
Responder
View
MenuBar
Implements
System.IDisposable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize
Remarks

The MenuBar appears on the first row of the terminal.

The MenuBar provides global hotkeys for the application.

Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
Namespace: Terminal.Gui
Assembly: Terminal.Gui.dll
Syntax
public class MenuBar : View, IDisposable, ISupportInitializeNotification, ISupportInitialize

Constructors

| Improve this Doc View Source

MenuBar()

Initializes a new instance of the MenuBar.
Declaration
public MenuBar()
| Improve this Doc View Source

MenuBar(MenuBarItem[])

Initializes a new instance of the MenuBar class with the specified set of toplevel menu items.
Declaration
public MenuBar(MenuBarItem[] menus)
Parameters
Type Name Description
MenuBarItem[] menus Individual menu items; a null item will result in a separator being drawn.

Properties

| Improve this Doc View Source

HotKeySpecifier

The specifier character for the hotkey to all menus.
Declaration
public static Rune HotKeySpecifier { get; }
Property Value
Type Description
System.Rune
| Improve this Doc View Source

IsMenuOpen

True if the menu is open; otherwise false.
Declaration
public bool IsMenuOpen { get; protected set; }
Property Value
Type Description
System.Boolean
| Improve this Doc View Source

LastFocused

Get the lasted focused view before open the menu.
Declaration
public View LastFocused { get; }
Property Value
Type Description
View
| Improve this Doc View Source

Menus

Gets or sets the array of MenuBarItems for the menu. Only set this when the MenuBar is visible.
Declaration
public MenuBarItem[] Menus { get; set; }
Property Value
Type Description
MenuBarItem[] The menu array.
| Improve this Doc View Source

ShortcutDelimiter

Used for change the shortcut delimiter separator.
Declaration
public static ustring ShortcutDelimiter { get; set; }
Property Value
Type Description
NStack.ustring
| Improve this Doc View Source

UseKeysUpDownAsKeysLeftRight

Used for change the navigation key style.
Declaration
public bool UseKeysUpDownAsKeysLeftRight { get; set; }
Property Value
Type Description
System.Boolean
| Improve this Doc View Source

UseSubMenusSingleFrame

Gets or sets if the sub-menus must be displayed in a single or multiple frames.
Declaration
public bool UseSubMenusSingleFrame { get; set; }
Property Value
Type Description
System.Boolean

Methods

| Improve this Doc View Source

CloseMenu(Boolean)

Closes the current Menu programatically, if open and not canceled.
Declaration
public bool CloseMenu(bool ignoreUseSubMenusSingleFrame = false)
Parameters
Type Name Description
System.Boolean ignoreUseSubMenusSingleFrame
Returns
Type Description
System.Boolean
| Improve this Doc View Source

MouseEvent(MouseEvent)

Declaration
public override bool MouseEvent(MouseEvent me)
Parameters
Type Name Description
MouseEvent me
Returns
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

OnEnter(View)

Declaration
public override bool OnEnter(View view)
Parameters
Type Name Description
View view
Returns
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

OnKeyDown(KeyEvent)

Declaration
public override bool OnKeyDown(KeyEvent keyEvent)
Parameters
Type Name Description
KeyEvent keyEvent
Returns
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

OnKeyUp(KeyEvent)

Declaration
public override bool OnKeyUp(KeyEvent keyEvent)
Parameters
Type Name Description
KeyEvent keyEvent
Returns
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

OnLeave(View)

Declaration
public override bool OnLeave(View view)
Parameters
Type Name Description
View view
Returns
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

OnMenuAllClosed()

Virtual method that will invoke the MenuAllClosed
Declaration
public virtual void OnMenuAllClosed()
| Improve this Doc View Source

OnMenuClosing(MenuBarItem, Boolean, Boolean)

Virtual method that will invoke the MenuClosing
Declaration
public virtual MenuClosingEventArgs OnMenuClosing(MenuBarItem currentMenu, bool reopen, bool isSubMenu)
Parameters
Type Name Description
MenuBarItem currentMenu The current menu to be closed.
System.Boolean reopen Whether the current menu will be reopen.
System.Boolean isSubMenu Whether is a sub-menu or not.
Returns
Type Description
MenuClosingEventArgs
| Improve this Doc View Source

OnMenuOpened()

Virtual method that will invoke the MenuOpened event if it's defined.
Declaration
public virtual void OnMenuOpened()
| Improve this Doc View Source

OnMenuOpening(MenuBarItem)

Virtual method that will invoke the MenuOpening event if it's defined.
Declaration
public virtual MenuOpeningEventArgs OnMenuOpening(MenuBarItem currentMenu)
Parameters
Type Name Description
MenuBarItem currentMenu The current menu to be replaced.
Returns
Type Description
MenuOpeningEventArgs Returns the MenuOpeningEventArgs
| Improve this Doc View Source

OpenMenu()

Opens the current Menu programatically.
Declaration
public void OpenMenu()
| Improve this Doc View Source

PositionCursor()

Declaration
public override void PositionCursor()
Overrides
| Improve this Doc View Source

ProcessColdKey(KeyEvent)

Declaration
public override bool ProcessColdKey(KeyEvent kb)
Parameters
Type Name Description
KeyEvent kb
Returns
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

ProcessHotKey(KeyEvent)

Declaration
public override bool ProcessHotKey(KeyEvent kb)
Parameters
Type Name Description
KeyEvent kb
Returns
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

ProcessKey(KeyEvent)

Declaration
public override bool ProcessKey(KeyEvent kb)
Parameters
Type Name Description
KeyEvent kb
Returns
Type Description
System.Boolean
Overrides
| Improve this Doc View Source

Redraw(Rect)

Declaration
public override void Redraw(Rect bounds)
Parameters
Type Name Description
Rect bounds
Overrides

Events

| Improve this Doc View Source

MenuAllClosed

Raised when all the menu are closed.
Declaration
public event Action MenuAllClosed
Event Type
Type Description
System.Action
| Improve this Doc View Source

MenuClosing

Raised when a menu is closing passing MenuClosingEventArgs.
Declaration
public event Action<MenuClosingEventArgs> MenuClosing
Event Type
Type Description
System.Action<MenuClosingEventArgs>
| Improve this Doc View Source

MenuOpened

Raised when a menu is opened.
Declaration
public event Action<MenuItem> MenuOpened
Event Type
Type Description
System.Action<MenuItem>
| Improve this Doc View Source

MenuOpening

Raised as a menu is opening.
Declaration
public event Action<MenuOpeningEventArgs> MenuOpening
Event Type
Type Description
System.Action<MenuOpeningEventArgs>

Implements

System.IDisposable
System.ComponentModel.ISupportInitializeNotification
System.ComponentModel.ISupportInitialize