Class MenuModelRegistry

The MenuModelRegistry allows to register and unregister menus, submenus and actions via strings and MenuActions without the need to access the underlying UI representation.

Constructors

constructor

new MenuModelRegistry(contributions, commands, menuNodeFactory): MenuModelRegistry
Parameters
- contributions: ContributionProvider<MenuContribution>
- commands: CommandRegistry
- menuNodeFactory: MenuNodeFactory
Returns MenuModelRegistry
- Defined in packages/core/src/common/menu/menu-model-registry.ts:104

Properties

`Protected` `Readonly` commands

commands: CommandRegistry

`Protected` `Readonly` contributions

contributions: ContributionProvider<MenuContribution>

`Protected` isReady

isReady: boolean = false

`Protected` `Readonly` menuNodeFactory

menuNodeFactory: MenuNodeFactory

`Protected` `Readonly` onDidChangeEmitter

onDidChangeEmitter: Emitter<MenuChangedEvent> = ...

`Protected` root

root: CompoundMenuNode & MutableCompoundMenuNode

Accessors

onDidChange

get onDidChange(): Event<MenuChangedEvent>
Returns Event<MenuChangedEvent>
- Defined in packages/core/src/common/menu/menu-model-registry.ts:115

Methods

`Protected` findInNode

findInNode(root, menuPath, pathIndex): undefined | MenuNode
Parameters
- root: CompoundMenuNode
- menuPath: MenuPath
- pathIndex: number
Returns undefined | MenuNode
- Defined in packages/core/src/common/menu/menu-model-registry.ts:314

`Protected` fireChangeEvent

fireChangeEvent<T>(evt): void
Type Parameters
- T extends MenuChangedEvent
Parameters
- evt: T
Returns void
- Defined in packages/core/src/common/menu/menu-model-registry.ts:391

getMenu

getMenu(menuPath): CompoundMenuNode
Parameters
- menuPath: MenuPath
Returns CompoundMenuNode
- Defined in packages/core/src/common/menu/menu-model-registry.ts:329

getMenuNode

getMenuNode(menuPath): undefined | MenuNode
Parameters
- menuPath: string[]
Returns undefined | MenuNode
- Defined in packages/core/src/common/menu/menu-model-registry.ts:325

linkCompoundMenuNode

linkCompoundMenuNode(params): Disposable
Parameters
- params: {
      newParentPath: MenuPath;
      order?: string;
      submenuPath: MenuPath;
      when?: string;
  }
  - newParentPath: MenuPath
  - Optional order?: string
  - submenuPath: MenuPath
  - Optional when?: string
Returns Disposable
- Defined in packages/core/src/common/menu/menu-model-registry.ts:234

onStart

onStart(): void
Returns void
- Defined in packages/core/src/common/menu/menu-model-registry.ts:121

registerCommandMenu

registerCommandMenu(menuPath, item): Disposable
Adds the given menu action to the menu denoted by the given path.
Parameters
- menuPath: MenuPath
- item: CommandMenu
Returns Disposable
a disposable which, when called, will remove the menu action again.
- Defined in packages/core/src/common/menu/menu-model-registry.ts:133

registerMenuAction

registerMenuAction(menuPath, item): Disposable
Adds the given menu action to the menu denoted by the given path.
Parameters
- menuPath: MenuPath
- item: MenuAction
Returns Disposable
a disposable which, when called, will remove the menu action again.
- Defined in packages/core/src/common/menu/menu-model-registry.ts:157

registerSubmenu

registerSubmenu(menuPath, label, options?): Disposable
Register a new menu at the given path with the given label. (If the menu already exists without a label, iconClass or order this method can be used to set them.)
Parameters
- menuPath: MenuPath
  the path for which a new submenu shall be registered.
- label: string
  the label to be used for the new submenu.
- options: {
      contextKeyOverlay?: Record<string, string>;
      icon?: string;
      sortString?: string;
      when?: string;
  } = {}
  optionally allows to set an icon class and specify the order of the new menu.
  - Optional contextKeyOverlay?: Record<string, string>
  - Optional icon?: string
  - Optional sortString?: string
  - Optional when?: string
Returns Disposable
if the menu was successfully created a disposable will be returned which, when called, will remove the menu again. If the menu already existed a no-op disposable will be returned.

Note that if the menu already existed and was registered with a different label an error will be thrown.
- Defined in packages/core/src/common/menu/menu-model-registry.ts:192

`Protected` removeActionInSubtree

removeActionInSubtree(parent, id): void
Parameters
- parent: MenuNode
- id: string
Returns void
- Defined in packages/core/src/common/menu/menu-model-registry.ts:304

unregisterMenuAction

unregisterMenuAction(item, menuPath?): void
Unregister all menu nodes with the same id as the given menu action.
Parameters
- item: MenuAction
  the item whose id will be used.
- Optional menuPath: MenuPath
  if specified only nodes within the path will be unregistered.
Returns void
- Defined in packages/core/src/common/menu/menu-model-registry.ts:278
unregisterMenuAction(command, menuPath?): void
Unregister all menu nodes with the same id as the given command.
Parameters
- command: Command
  the command whose id will be used.
- Optional menuPath: MenuPath
  if specified only nodes within the path will be unregistered.
Returns void
- Defined in packages/core/src/common/menu/menu-model-registry.ts:285
unregisterMenuAction(id, menuPath?): void
Unregister all menu nodes with the given id.
Parameters
- id: string
  the id which shall be removed.
- Optional menuPath: MenuPath
  if specified only nodes within the path will be unregistered.
Returns void
- Defined in packages/core/src/common/menu/menu-model-registry.ts:292

`Static` isEmpty

isEmpty(node): boolean
Parameters
- node: MenuNode
Returns boolean
- Defined in packages/core/src/common/menu/menu-model-registry.ts:375

`Static` removeSingleRootNode

removeSingleRootNode(fullMenuModel): CompoundMenuNode
Checks the given menu model whether it will show a menu with a single submenu.
Parameters
- fullMenuModel: CompoundMenuNode
  the menu model to analyze
Returns CompoundMenuNode
if the menu will show a single submenu this returns a menu that will show the child elements of the submenu, otherwise the given fullMenuModel is return
- Defined in packages/core/src/common/menu/menu-model-registry.ts:355

`Static` removeSingleRootNodes

removeSingleRootNodes(fullMenuModel): CompoundMenuNode
Parameters
- fullMenuModel: CompoundMenuNode
Returns CompoundMenuNode
- Defined in packages/core/src/common/menu/menu-model-registry.ts:337

Class MenuModelRegistry

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns MenuModelRegistry

Properties

Protected Readonly commands

Protected Readonly contributions

Protected isReady

Protected Readonly menuNodeFactory

Protected Readonly onDidChangeEmitter

Protected root

Accessors

onDidChange

Returns Event<MenuChangedEvent>

Methods

Protected findInNode

Parameters

Returns undefined | MenuNode

Protected fireChangeEvent

Type Parameters

Parameters

Returns void

getMenu

Parameters

Returns CompoundMenuNode

getMenuNode

Parameters

Returns undefined | MenuNode

linkCompoundMenuNode

Parameters

newParentPath: MenuPath

Optional order?: string

submenuPath: MenuPath

Optional when?: string

Returns Disposable

onStart

Returns void

registerCommandMenu

Parameters

Returns Disposable

registerMenuAction

Parameters

Returns Disposable

registerSubmenu

Parameters

Optional contextKeyOverlay?: Record<string, string>

Optional icon?: string

Optional sortString?: string

Optional when?: string

Returns Disposable

Protected removeActionInSubtree

Parameters

Returns void

unregisterMenuAction

Parameters

Returns void

Parameters

Returns void

Parameters

Returns void

Static isEmpty

Parameters

Returns boolean

Static removeSingleRootNode

Parameters

Returns CompoundMenuNode

Static removeSingleRootNodes

Parameters

Returns CompoundMenuNode

Settings

Member Visibility

Theme

On This Page

`Protected` `Readonly` commands

`Protected` `Readonly` contributions

`Protected` isReady

`Protected` `Readonly` menuNodeFactory

`Protected` `Readonly` onDidChangeEmitter

`Protected` root

`Protected` findInNode

`Protected` fireChangeEvent

`Optional` order?: string

`Optional` when?: string

`Optional` contextKeyOverlay?: Record<string, string>

`Optional` icon?: string

`Optional` sortString?: string

`Optional` when?: string

`Protected` removeActionInSubtree

`Static` isEmpty

`Static` removeSingleRootNode

`Static` removeSingleRootNodes