#include <MenuManagerInterface.h>

Inherited by AzToolsFramework::MenuManager [private].

Public Member Functions
	AZ_RTTI (MenuManagerInterface, "{D70B7989-62BD-447E-ADF6-0971EC4B7DEE}")

virtual MenuManagerOperationResult	RegisterMenu (const AZStd::string &menuIdentifier, const MenuProperties &properties)=0

virtual MenuManagerOperationResult	RegisterMenuBar (const AZStd::string &menuBarIdentifier, QMainWindow *mainWindow)=0

virtual bool	IsMenuRegistered (const AZStd::string &menuIdentifier) const =0

virtual MenuManagerOperationResult	AddActionToMenu (const AZStd::string &menuIdentifier, const AZStd::string &actionIdentifier, int sortIndex)=0

virtual MenuManagerOperationResult	AddActionsToMenu (const AZStd::string &menuIdentifier, const AZStd::vector< AZStd::pair< AZStd::string, int > > &actions)=0

virtual MenuManagerOperationResult	RemoveActionFromMenu (const AZStd::string &menuIdentifier, const AZStd::string &actionIdentifier)=0

virtual MenuManagerOperationResult	RemoveActionsFromMenu (const AZStd::string &menuIdentifier, const AZStd::vector< AZStd::string > &actionIdentifiers)=0

virtual MenuManagerOperationResult	AddSeparatorToMenu (const AZStd::string &menuIdentifier, int sortIndex)=0

virtual MenuManagerOperationResult	AddSubMenuToMenu (const AZStd::string &menuIdentifier, const AZStd::string &subMenuIdentifier, int sortIndex)=0

virtual MenuManagerOperationResult	AddSubMenusToMenu (const AZStd::string &menuIdentifier, const AZStd::vector< AZStd::pair< AZStd::string, int > > &subMenus)=0

virtual MenuManagerOperationResult	RemoveSubMenuFromMenu (const AZStd::string &menuIdentifier, const AZStd::string &subMenuIdentifier)=0

virtual MenuManagerOperationResult	RemoveSubMenusFromMenu (const AZStd::string &menuIdentifier, const AZStd::vector< AZStd::string > &subMenuIdentifiers)=0

virtual MenuManagerOperationResult	AddWidgetToMenu (const AZStd::string &menuIdentifier, const AZStd::string &widgetActionIdentifier, int sortIndex)=0

virtual MenuManagerOperationResult	AddMenuToMenuBar (const AZStd::string &menuBarIdentifier, const AZStd::string &menuIdentifier, int sortIndex)=0

virtual MenuManagerIntegerResult	GetSortKeyOfActionInMenu (const AZStd::string &menuIdentifier, const AZStd::string &actionIdentifier) const =0

virtual MenuManagerIntegerResult	GetSortKeyOfSubMenuInMenu (const AZStd::string &menuIdentifier, const AZStd::string &subMenuIdentifier) const =0

virtual MenuManagerIntegerResult	GetSortKeyOfWidgetInMenu (const AZStd::string &menuIdentifier, const AZStd::string &widgetActionIdentifier) const =0

virtual MenuManagerIntegerResult	GetSortKeyOfMenuInMenuBar (const AZStd::string &menuBarIdentifier, const AZStd::string &menuIdentifier) const =0

virtual MenuManagerOperationResult	DisplayMenuAtScreenPosition (const AZStd::string &menuIdentifier, const QPoint &screenPosition)=0

virtual MenuManagerOperationResult	DisplayMenuUnderCursor (const AZStd::string &menuIdentifier)=0

virtual MenuManagerPositionResult	GetLastContextMenuPosition () const =0

Detailed Description

MenuManagerInterface Interface to register and manage menus in the Editor.

Member Function Documentation

◆ AddActionsToMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::AddActionsToMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::vector< AZStd::pair< AZStd::string, int > > &	actions
	)

pure virtual

Add multiple Actions to a Menu.

Parameters

menuIdentifier	The identifier for the menu the actions are being added to.
actions	A vector of pairs of identifiers for the actions to add to the menu and their sort position.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ AddActionToMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::AddActionToMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::string &	actionIdentifier,
		int	sortIndex
	)

pure virtual

Add an Action to a Menu. Will prompt an update of the menu.

Parameters

menuIdentifier	The identifier for the menu the action is being added to.
actionIdentifier	The identifier for the action to add to the menu.
sortIndex	An integer defining the position the action should appear in the menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ AddMenuToMenuBar()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::AddMenuToMenuBar	(	const AZStd::string &	menuBarIdentifier,
		const AZStd::string &	menuIdentifier,
		int	sortIndex
	)

pure virtual

Add a Menu to a Menu Bar.

Parameters

menuBarIdentifier	The identifier for the menu bar the menu is being added to.
menuIdentifier	The identifier for the menu to add to the menu bar.
sortIndex	An integer defining the position the menu should appear in the menu bar.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ AddSeparatorToMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::AddSeparatorToMenu	(	const AZStd::string &	menuIdentifier,
		int	sortIndex
	)

pure virtual

Add a Separator to a Menu.

Parameters

menuIdentifier	The identifier for the menu the separator is being added to.
sortIndex	An integer defining the position the separator should appear in the menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ AddSubMenusToMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::AddSubMenusToMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::vector< AZStd::pair< AZStd::string, int > > &	subMenus
	)

pure virtual

Add multiple Sub-Menus to a Menu.

Parameters

menuIdentifier	The identifier for the menu the sub-menus are being added to.
actions	A vector of pairs of identifiers for the sub-menus to add to the menu and their sort position.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ AddSubMenuToMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::AddSubMenuToMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::string &	subMenuIdentifier,
		int	sortIndex
	)

pure virtual

Add a Sub-Menu to a Menu.

Parameters

menuIdentifier	The identifier for the menu the sub-menu is being added to.
subMenuIdentifier	The identifier for the sub-menu to add to the menu.
sortIndex	An integer defining the position the sub-menu should appear in the menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ AddWidgetToMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::AddWidgetToMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::string &	widgetActionIdentifier,
		int	sortIndex
	)

pure virtual

Add a Widget to a Menu.

Parameters

menuIdentifier	The identifier for the menu the sub-menu is being added to.
widgetActionIdentifier	The identifier to the widget to add to the menu.
sortIndex	An integer defining the position the widget should appear in the menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ DisplayMenuAtScreenPosition()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::DisplayMenuAtScreenPosition	(	const AZStd::string &	menuIdentifier,
		const QPoint &	screenPosition
	)

pure virtual

Show the menu at the position provided.

Parameters

menuIdentifier	The identifier for the menu to display.
screenPosition	The position where the menu should appear.

Returns: A successful outcome object if the menu could be displayed, or a string with a message detailing the error in case of failure.

◆ DisplayMenuUnderCursor()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::DisplayMenuUnderCursor ( const AZStd::string & menuIdentifier )

pure virtual

Show the menu under the mouse cursor.

Parameters

menuIdentifier The identifier for the menu to display.

Returns: A successful outcome object if the menu could be displayed, or a string with a message detailing the error in case of failure.

◆ GetLastContextMenuPosition()

virtual MenuManagerPositionResult AzToolsFramework::MenuManagerInterface::GetLastContextMenuPosition ( ) const

pure virtual

Returns the position of the last context menu displayed with the DisplayMenu functions. Note that the menu must still be active.

Returns: A successful outcome object containing the position of the last context menu, or a string with a message detailing the error in case of failure.

◆ GetSortKeyOfActionInMenu()

virtual MenuManagerIntegerResult AzToolsFramework::MenuManagerInterface::GetSortKeyOfActionInMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::string &	actionIdentifier
	)		const

pure virtual

Retrieve the sort key of an action in a menu from its identifier.

Parameters

menuIdentifier	The identifier for the menu to query.
actionIdentifier	The identifier for the action whose sort key to get in the menu.

Returns: A successful outcome object containing the sort key, or a string with a message detailing the error in case of failure.

◆ GetSortKeyOfMenuInMenuBar()

virtual MenuManagerIntegerResult AzToolsFramework::MenuManagerInterface::GetSortKeyOfMenuInMenuBar	(	const AZStd::string &	menuBarIdentifier,
		const AZStd::string &	menuIdentifier
	)		const

pure virtual

Retrieve the sort key of a sub-menu in a menu from its identifier.

Parameters

menuBarIdentifier	The identifier for the menu bar to query.
menuIdentifier	The identifier for the menu whose sort key to get in the menu bar.

Returns: A successful outcome object containing the sort key, or a string with a message detailing the error in case of failure.

◆ GetSortKeyOfSubMenuInMenu()

virtual MenuManagerIntegerResult AzToolsFramework::MenuManagerInterface::GetSortKeyOfSubMenuInMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::string &	subMenuIdentifier
	)		const

pure virtual

Retrieve the sort key of a sub-menu in a menu from its identifier.

Parameters

menuIdentifier	The identifier for the menu to query.
subMenuIdentifier	The identifier for the sub-menu whose sort key to get in the menu.

Returns: A successful outcome object containing the sort key, or a string with a message detailing the error in case of failure.

◆ GetSortKeyOfWidgetInMenu()

virtual MenuManagerIntegerResult AzToolsFramework::MenuManagerInterface::GetSortKeyOfWidgetInMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::string &	widgetActionIdentifier
	)		const

pure virtual

Retrieve the sort key of a widget action in a menu from its identifier.

Parameters

menuIdentifier	The identifier for the menu to query.
widgetActionIdentifier	The identifier for the widget whose sort key to get in the menu.

Returns: A successful outcome object containing the sort key, or a string with a message detailing the error in case of failure.

◆ IsMenuRegistered()

virtual bool AzToolsFramework::MenuManagerInterface::IsMenuRegistered ( const AZStd::string & menuIdentifier ) const

pure virtual

Returns whether a menu with the identifier queried is registered to the Menu Manager.

Parameters

menuIdentifier The identifier for the menu to query.

Returns: True if a Menu with the identifier provided was found, false otherwise.

◆ RegisterMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::RegisterMenu	(	const AZStd::string &	menuIdentifier,
		const MenuProperties &	properties
	)

pure virtual

Register a new Menu to the Menu Manager.

Parameters

menuIdentifier	The identifier for the menu that is being registered.
properties	The properties object for the newly registered menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ RegisterMenuBar()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::RegisterMenuBar	(	const AZStd::string &	menuBarIdentifier,
		QMainWindow *	mainWindow
	)

pure virtual

Register a new Menu Bar to the Menu Manager.

Parameters

menuBarIdentifier	The identifier for the menu bar that is being registered.
mainWindow	Pointer to the QMainWindow to associate the menu bar with.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ RemoveActionFromMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::RemoveActionFromMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::string &	actionIdentifier
	)

pure virtual

Removes an Action from a Menu.

Parameters

menuIdentifier	The identifier for the menu the action is being removed from.
actionIdentifier	The identifier for the action to remove from the menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ RemoveActionsFromMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::RemoveActionsFromMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::vector< AZStd::string > &	actionIdentifiers
	)

pure virtual

Removes multiple Actions from a Menu.

Parameters

menuIdentifier	The identifier for the menu the actions are being removed from.
actionIdentifiers	A vector of identifiers for the actions to remove from the menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ RemoveSubMenuFromMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::RemoveSubMenuFromMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::string &	subMenuIdentifier
	)

pure virtual

Removes a Sub-Menu from a Menu.

Parameters

menuIdentifier	The identifier for the menu the sub-menu is being removed from.
subMenuIdentifier	The identifier for the sub-menu to remove from the menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

◆ RemoveSubMenusFromMenu()

virtual MenuManagerOperationResult AzToolsFramework::MenuManagerInterface::RemoveSubMenusFromMenu	(	const AZStd::string &	menuIdentifier,
		const AZStd::vector< AZStd::string > &	subMenuIdentifiers
	)

pure virtual

Removes multiple Sub-Menus from a Menu.

Parameters

menuIdentifier	The identifier for the menu the sub-menus are being removed from.
subMenuIdentifiers	A vector of identifiers for the sub-menus to remove from the menu.

Returns: A successful outcome object, or a string with a message detailing the error in case of failure.

The documentation for this class was generated from the following file:

Code/Framework/AzToolsFramework/AzToolsFramework/ActionManager/Menu/MenuManagerInterface.h

Public Member Functions

Detailed Description

Member Function Documentation

◆ AddActionsToMenu()

◆ AddActionToMenu()

◆ AddMenuToMenuBar()

◆ AddSeparatorToMenu()

◆ AddSubMenusToMenu()

◆ AddSubMenuToMenu()

◆ AddWidgetToMenu()

◆ DisplayMenuAtScreenPosition()

◆ DisplayMenuUnderCursor()

◆ GetLastContextMenuPosition()

◆ GetSortKeyOfActionInMenu()

◆ GetSortKeyOfMenuInMenuBar()

◆ GetSortKeyOfSubMenuInMenu()

◆ GetSortKeyOfWidgetInMenu()

◆ IsMenuRegistered()

◆ RegisterMenu()

◆ RegisterMenuBar()

◆ RemoveActionFromMenu()

◆ RemoveActionsFromMenu()

◆ RemoveSubMenuFromMenu()

◆ RemoveSubMenusFromMenu()