The menu assembler and configuration were combined into one class for convenience. More...

Inheritance diagram for makVrf::DtVrfRightClickContextHandler:

Public Member Functions
	DtVrfRightClickContextHandler (makVrv::DtDe &de)
	Default constructor that should not be used by users.
virtual	~DtVrfRightClickContextHandler ()
	Default destructor which should not be used by users.
virtual void	addContext (std::string contextName, DtVrfRightClickContextFunc func)
	Adds a new context to the context handler. This is called by DtVrfRightClickMenu.
virtual void	removeContext (std::string contextName)
	Removes a context from the context handler. This is called by DtVrfRightClickMenu.
virtual void	setDefaultContext (std::string contextName)
	Sets default context of the context handler. This is called by DtVrfRightClickMenu.
virtual void	setCurrentContext (std::string contextName)
	Sets current context of the context handler. This is called by DtVrfRightClickMenu.
virtual void	resetContext ()
	Resets the current context to the default context.
virtual std::string	currentContext ()
	Gets the current context.
virtual std::string	defaultContext ()
	Gets the default context.
virtual void	addMenuPath (const makVrv::DtMenuPath &path, int weight=-1)
	Overridden from base class.
virtual void	removeMenuPath (const makVrv::DtMenuPath &)
	Overridden from base class.
virtual void	addMenuPathAfter (const makVrv::DtMenuPath &newPath, const makVrv::DtMenuPath &relativeTo)
	Overridden from base class.
virtual void	addMenuPathBefore (const makVrv::DtMenuPath &newPath, const makVrv::DtMenuPath &relativeTo)
	Overridden from base class.
virtual void	registerMenu (makVrv::DtMenu *menu)
	Registers a menu object to the right click menu.
virtual void	unregisterMenu (makVrv::DtMenu *menu)
	Unregisters a menu object from the right click menu.
virtual void	registerItem (makVrv::DtMenuItem *item)
	Registers a menu item object to the right click menu.
virtual void	unregisterItem (makVrv::DtMenuItem *item)
	Unregisters a menu item object to the right click menu.
Public Member Functions inherited from makVrf::DtSubMenuConfiguration
	DtSubMenuConfiguration ()
	DtSubMenuConfiguration (const makVrv::DtMenuConfiguration &c)
	DtSubMenuConfiguration (makVrv::DtDe *de)
virtual	~DtSubMenuConfiguration ()
virtual bool	isUnique (const std::string &) const
	Returns true if there is only one occurance of this path.
int	size () const
void	convert (const std::string &str1, const std::string &str2)
virtual void	addMenuItemAfter (const std::string &menuItem, const std::string &after)
	Finds the first occurance of a menu item that matches the "after" in the configuration and adds the menu item to add after that item.
virtual void	removeMenuItem (const std::string &menuItem)
	Finds the first occurance of a menu item that matches the "menuItem" in the configuration and removes it.
virtual void	addMenuItemBefore (const std::string &menuItem, const std::string &before)
	Finds the first occurance of a menu item that matches the "after" in the configuration and adds the menu item to add before that item.
virtual makVrv::DtMenuPath	menuPathForItem (const std::string &menuItem) const
	Finds a menu path that contains the menu item.
virtual std::string	mainMenu () const
	Returns the main menu that represents this path. Will be the first items main menu.
DtSubMenuConfiguration &	operator= (const makVrv::DtMenuConfiguration &rhs)
void	makeChangesTo (makVrv::DtMenuConfiguration *c)
void	clearMakeChangesTo ()
const MenuPathSet &	pathsRemoved () const
const MenuPathSet &	menuPaths () const
void	setProtected (const std::string &p, bool b)
bool	isProtected (const std::string &p) const
bool	isGoingToBeRemoved (const makVrv::DtMenuPath &p) const
virtual void	reworkRelativeOrder ()
	Reworks the relativeTo items to do a closest match and then use that based on the menu paths.
Public Member Functions inherited from makVrf::DtConfigurableMenuAssembler
	DtConfigurableMenuAssembler (makVrv::DtDe &de)
virtual	~DtConfigurableMenuAssembler ()
void	setDeleteReferences (bool b)
bool	deleteReferences () const
void	setLocalOnly (bool b)
bool	localOnly () const
void	cleanup ()
makVrv::DtMenuManager &	menuManager ()
	Returns menu manager.
const makVrv::DtMenuManager &	menuManager () const
QMenu *	findMenu (const makVrv::DtMenuPath &path)
	Returns the QMenu object for the given path.
QAction *	findMenuItem (const makVrv::DtMenuPath &path)
virtual void	merge (const DtQtMenuAssembler::MenuBuilderMap &)
	Merges the contents of the supplied menu builder map, adding new entries and replacing existing.
virtual void	merge (const DtQtMenuAssembler::MenuItemBuilderMap &)
	Merges the contents of the supplied menu item builder map, adding new entries and replacing existing.
void	makeChangesTo (makVrv::DtQtMenuAssembler *c)
void	clearMakeChangesTo ()
virtual QMenuBar *	menuBar ()
virtual QWidget *	menuWindow ()
void	setCreateSubMenusForMissingMenus (bool b)
	If true, for any missing sub-menu item, create a menu builder and add it. Default is false.
virtual void	assembleMenu (const makVrv::DtMenuPath &menuPath)

Protected Member Functions
virtual void	applyContext (std::string contextName, makVrv::DtMenuConfiguration &config)
	Internally used function to apply contexts to the configuration.
virtual void	applyRegistrations (makVrv::DtQtMenuAssembler &assembler)
	Internally used function to apply registrations to the menu assembler.
virtual void	slot_modifyRightClickMenu (makVrv::DtQtMenuAssembler &, makVrv::DtMenuConfiguration &, const makVrv::DtSelectionManager::IdSet &, int, makVrv::DtDe &)
	Internally used function to handle right click at the time it happens.
virtual void	registerMenu (makVrv::DtMenuItem *)
	Use registerItem() instead.
virtual void	unregisterMenu (makVrv::DtMenu *, bool deleteBuilder=true)
	Use unregisterMenu() instead.
virtual void	unregisterMenu (makVrv::DtMenuItem *, bool deleteBuilder=true)
	Use unregisterItem() instead.

Protected Attributes
std::map< std::string, DtVrfRightClickContextFunc >	myChangeRules
std::map< std::string, DtVrfRightClickChanges * >	myChanges
std::string	myDefaultContext
std::string	myCurrentContext
std::vector< makVrv::DtMenu * >	myUnregisterMenus
std::vector< makVrv::DtMenu * >	myRegisterMenus
std::vector< makVrv::DtMenuItem * >	myRegisterItems
std::vector< makVrv::DtMenuItem * >	myUnregisterItems
Protected Attributes inherited from makVrf::DtSubMenuConfiguration
makVrv::DtDe *	myDe
std::vector < makVrv::DtMenuConfiguration * >	myMakeChangesTo
MenuPathSet	myPathsRemoved
std::map< std::string, bool >	myIsProtected
Protected Attributes inherited from makVrf::DtConfigurableMenuAssembler
DtConfigurationMenuManager	myMenuManager
std::vector < makVrv::DtQtMenuAssembler * >	myMakeChangesTo
bool	myDeleteReferences
bool	myLocalOnly
bool	myCreateSubMenusForMissingMenus

Detailed Description

The menu assembler and configuration were combined into one class for convenience.

Most users won't really notice this or care.

Constructor & Destructor Documentation

makVrf::DtVrfRightClickContextHandler::DtVrfRightClickContextHandler ( makVrv::DtDe & de )

Default constructor that should not be used by users.

virtual makVrf::DtVrfRightClickContextHandler::~DtVrfRightClickContextHandler ( )

virtual

Default destructor which should not be used by users.

Member Function Documentation

virtual void makVrf::DtVrfRightClickContextHandler::addContext	(	std::string	contextName,
		DtVrfRightClickContextFunc	func
	)

virtual

Adds a new context to the context handler. This is called by DtVrfRightClickMenu.

virtual void makVrf::DtVrfRightClickContextHandler::removeContext ( std::string contextName )

virtual

Removes a context from the context handler. This is called by DtVrfRightClickMenu.

virtual void makVrf::DtVrfRightClickContextHandler::setDefaultContext ( std::string contextName )

virtual

Sets default context of the context handler. This is called by DtVrfRightClickMenu.

virtual void makVrf::DtVrfRightClickContextHandler::setCurrentContext ( std::string contextName )

virtual

Sets current context of the context handler. This is called by DtVrfRightClickMenu.

virtual void makVrf::DtVrfRightClickContextHandler::resetContext ( )

inlinevirtual

Resets the current context to the default context.

virtual std::string makVrf::DtVrfRightClickContextHandler::currentContext ( )

inlinevirtual

Gets the current context.

virtual std::string makVrf::DtVrfRightClickContextHandler::defaultContext ( )

inlinevirtual

Gets the default context.

virtual void makVrf::DtVrfRightClickContextHandler::addMenuPath	(	const makVrv::DtMenuPath &	path,
		int	weight = `-1`
	)

virtual

Overridden from base class.

Adds a menu path to the right click menu based on the current context. To change contexts, you should call setCurrentContext() before calling this function to ensure your right click change happens when you want it to. This function assumes the menu/item at the end of the path is already registered to this class or to DtVrfMainMenu.

Reimplemented from makVrf::DtSubMenuConfiguration.

virtual void makVrf::DtVrfRightClickContextHandler::removeMenuPath ( const makVrv::DtMenuPath & )

virtual

Overridden from base class.

Removes a menu path from the right click menu based on the current context. To change contexts, you should call setCurrentContext() before calling this function to ensure your right click change happens when you want it to. This function assumes the menu/item at the end of the path is already registered to this class or to DtVrfMainMenu.

Reimplemented from makVrf::DtSubMenuConfiguration.

virtual void makVrf::DtVrfRightClickContextHandler::addMenuPathAfter	(	const makVrv::DtMenuPath &	newPath,
		const makVrv::DtMenuPath &	relativeTo
	)

virtual

Overridden from base class.

Adds a menu path to the right click menu based on the current context. To change contexts, you should call setCurrentContext() before calling this function to ensure your right click change happens when you want it to. This function assumes the menu/item at the end of the path is already registered to this class or to DtVrfMainMenu.

Reimplemented from makVrf::DtSubMenuConfiguration.

virtual void makVrf::DtVrfRightClickContextHandler::addMenuPathBefore	(	const makVrv::DtMenuPath &	newPath,
		const makVrv::DtMenuPath &	relativeTo
	)

virtual

Overridden from base class.

Adds a menu path to the right click menu based on the current context. To change contexts, you should call setCurrentContext() before calling this function to ensure your right click change happens when you want it to. This function assumes the menu/item at the end of the path is already registered to this class or to DtVrfMainMenu.

Reimplemented from makVrf::DtSubMenuConfiguration.

virtual void makVrf::DtVrfRightClickContextHandler::registerMenu ( makVrv::DtMenu * menu )

virtual

Registers a menu object to the right click menu.

Menus registered in the DtVrfMainMenu do not need to be re-registered.

Reimplemented from makVrf::DtConfigurableMenuAssembler.

virtual void makVrf::DtVrfRightClickContextHandler::unregisterMenu ( makVrv::DtMenu * menu )

virtual

Unregisters a menu object from the right click menu.

virtual void makVrf::DtVrfRightClickContextHandler::registerItem ( makVrv::DtMenuItem * item )

virtual

Registers a menu item object to the right click menu.

Menus itmes registered in the DtVrfMainMenu do not need to be re-registered.

virtual void makVrf::DtVrfRightClickContextHandler::unregisterItem ( makVrv::DtMenuItem * item )

virtual

Unregisters a menu item object to the right click menu.

virtual void makVrf::DtVrfRightClickContextHandler::applyContext	(	std::string	contextName,
		makVrv::DtMenuConfiguration &	config
	)

protectedvirtual

Internally used function to apply contexts to the configuration.

virtual void makVrf::DtVrfRightClickContextHandler::applyRegistrations ( makVrv::DtQtMenuAssembler & assembler )

protectedvirtual

Internally used function to apply registrations to the menu assembler.

virtual void makVrf::DtVrfRightClickContextHandler::slot_modifyRightClickMenu	(	makVrv::DtQtMenuAssembler &	,
		makVrv::DtMenuConfiguration &	,
		const makVrv::DtSelectionManager::IdSet &	,
		int	,
		makVrv::DtDe &
	)

protectedvirtual

Internally used function to handle right click at the time it happens.

The user's entry point into this is to call addContext() and add functions which will eventually be called.

virtual void makVrf::DtVrfRightClickContextHandler::registerMenu ( makVrv::DtMenuItem * )

protectedvirtual

Use registerItem() instead.

Reimplemented from makVrf::DtConfigurableMenuAssembler.

virtual void makVrf::DtVrfRightClickContextHandler::unregisterMenu	(	makVrv::DtMenu *	,
		bool	deleteBuilder = `true`
	)

protectedvirtual

Use unregisterMenu() instead.

Reimplemented from makVrf::DtConfigurableMenuAssembler.

virtual void makVrf::DtVrfRightClickContextHandler::unregisterMenu	(	makVrv::DtMenuItem *	,
		bool	deleteBuilder = `true`
	)

protectedvirtual

Use unregisterItem() instead.

Reimplemented from makVrf::DtConfigurableMenuAssembler.

Member Data Documentation

std::map<std::string, DtVrfRightClickContextFunc> makVrf::DtVrfRightClickContextHandler::myChangeRules

protected

std::map<std::string, DtVrfRightClickChanges*> makVrf::DtVrfRightClickContextHandler::myChanges

protected

std::string makVrf::DtVrfRightClickContextHandler::myDefaultContext

protected

std::string makVrf::DtVrfRightClickContextHandler::myCurrentContext

protected

std::vector<makVrv::DtMenu*> makVrf::DtVrfRightClickContextHandler::myUnregisterMenus

protected

std::vector<makVrv::DtMenu*> makVrf::DtVrfRightClickContextHandler::myRegisterMenus

protected

std::vector<makVrv::DtMenuItem*> makVrf::DtVrfRightClickContextHandler::myRegisterItems

protected

std::vector<makVrv::DtMenuItem*> makVrf::DtVrfRightClickContextHandler::myUnregisterItems

protected

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

/exports/nfedora7-1/nightly/docs/vrforcesDevelopment.tot/include/vrfGuiCoreQt/vrfRightClickMenu.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation