#include <MenuList.h>

Inheritance diagram for Kwave::MenuList:

Collaboration diagram for Kwave::MenuList:

Public Member Functions
	MenuList (Kwave::MenuNode *parent, const QString &command, const QString &uid)

virtual	~MenuList () Q_DECL_OVERRIDE

virtual bool	isBranch () const Q_DECL_OVERRIDE

virtual void	clear () Q_DECL_OVERRIDE

virtual Kwave::MenuNode *	insertLeaf (const QString &name, const QString &command, const QKeySequence &shortcut, const QString &uid) Q_DECL_OVERRIDE

Public Member Functions inherited from Kwave::MenuNode
	MenuNode (Kwave::MenuNode *parent, const QString &name, const QString &command, const QKeySequence &shortcut, const QString &uid)

virtual	~MenuNode ()

const QString	path () const

const QString &	name () const

const QString &	command () const

virtual QAction *	action ()

const QString &	uid () const

void	setUID (const QString &uid)

const QKeySequence &	shortcut () const

virtual void	setShortcut (const QKeySequence &shortcut)

virtual const QIcon	icon ()

virtual void	setIcon (const QIcon &icon)

virtual Kwave::MenuNode *	parentNode () const

virtual void	setVisible (bool visible)

virtual bool	isEnabled ()

virtual void	setEnabled (bool enable)

virtual void	setChecked (bool check)

virtual void	setText (const QString &text)

Kwave::MenuNode *	findUID (const QString &uid)

Kwave::MenuNode *	findChild (const QString &name)

virtual void	removeChild (Kwave::MenuNode *child)

virtual Kwave::MenuSub *	insertBranch (const QString &name, const QString &command, const QKeySequence &shortcut, const QString &uid)

virtual void	insertChild (Kwave::MenuNode node, Kwave::MenuNode before)

virtual void	insertNode (const QString &name, const QString &position, const QString &command, const QKeySequence &shortcut, const QString &uid)

virtual Kwave::MenuNode *	leafToBranch (Kwave::MenuNode *node)

virtual bool	specialCommand (const QString &command)

virtual void	actionSelected ()

virtual QHash< QString, Kwave::MenuGroup * > &	groupList ()

void	joinGroup (const QString &group, Kwave::MenuGroup::Mode mode)

void	leaveGroup (const QString &group)

Additional Inherited Members
Signals inherited from Kwave::MenuNode
void	sigCommand (const QString &command)

Protected Member Functions inherited from Kwave::MenuNode
Kwave::MenuNode *	rootNode ()

void	emitCommand (const QString &command)

Protected Attributes inherited from Kwave::MenuNode
QList< Kwave::MenuNode * >	m_children

QStringList	m_groups

Detailed Description

Container for a group of entries that belong to a list of menu entries, which contains a number of list entries. It is normally owned by a sub menu.

Definition at line 37 of file MenuList.h.

Constructor & Destructor Documentation

◆ MenuList()

Kwave::MenuList::MenuList	(	Kwave::MenuNode *	parent,
		const QString &	command,
		const QString &	uid
	)

Constructor.

Parameters

parent	pointer to the node's parent (might be 0)
command	the command to be sent when the entry is selected, should contain a wildcard (%1)
uid	unique id string (optional, default=0)

Definition at line 25 of file MenuList.cpp.

     :MenuNode(parent, _("LISTENTRY[") + uid + _("]"), command, 0, uid)
 {
     /* NOTE: the "name" of this node is the uid of the list entries */
 }

◆ ~MenuList()

Kwave::MenuList::~MenuList ( )

virtual

Destructor

Definition at line 34 of file MenuList.cpp.

35 {

36 }

Member Function Documentation

◆ clear()

void Kwave::MenuList::clear ( )

virtual

Removes all entries from the list menu.

Reimplemented from Kwave::MenuNode.

Definition at line 39 of file MenuList.cpp.

References Kwave::MenuNode::findUID(), Kwave::MenuNode::name(), Kwave::MenuNode::parentNode(), and Kwave::MenuNode::removeChild().

Referenced by isBranch().

 {
     Kwave::MenuNode *parent = parentNode();
     Q_ASSERT(parent);
     if (!parent) return;
 
     QString list_uid = name();
     Kwave::MenuNode *child;
     while ((child = parent->findUID(list_uid)) != Q_NULLPTR)
         parent->removeChild(child);
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ insertLeaf()

Kwave::MenuNode * Kwave::MenuList::insertLeaf	(	const QString &	name,
		const QString &	command,
		const QKeySequence &	shortcut,
		const QString &	uid
	)

virtual

Inserts a new leaf node under the corresponding submenu. The new node normally is (derived from) MenuItem.

Parameters

name	non-localized name of the node
command	the command to be sent when the node is selected (might be 0)
shortcut	keyboard shortcut, 0 if unused
uid	unique id string (might be 0)

Returns: pointer to the new leaf node

Reimplemented from Kwave::MenuNode.

Definition at line 52 of file MenuList.cpp.

References Kwave::MenuNode::insertLeaf(), Kwave::MenuNode::name(), and Kwave::MenuNode::parentNode().

Referenced by isBranch().

 {
     Q_UNUSED(uid);
 
     Kwave::MenuNode *parent = parentNode();
     Q_ASSERT(parent);
     QString list_uid = this->name();
     return (parent) ?
         parent->insertLeaf(name, command, shortcut, list_uid) : Q_NULLPTR;
 }