Action Class Reference

An action (for this plugin) consists of a description, and a set of key sequences. More...

#include <action.h>

List of all members.

Public Member Functions
	Action (const QString &description)
	Create a new empty action.
	Action (const QString &description, const QString &keys)
	Create a new action.
bool	AddKey (const QString &key)
	Add a key sequence to this action.
bool	ReplaceKey (const QString &newkey, const QString &oldkey)
	Replace a key.
bool	RemoveKey (const QString &key)
	Remove a key from this action.
QString	GetDescription (void) const
	Returns the action description. (note: not threadsafe)
QStringList	GetKeys (void) const
	Returns the key sequence(s) that trigger this action.
QString	GetKeyString (void) const
	Returns comma delimited string of key bindings.
bool	IsEmpty (void) const
	Returns true iff the action has no keys.
bool	HasKey (const QString &key) const
	Determine if the action already has a key.
Static Public Attributes
static const unsigned int	kMaximumNumberOfBindings = 4
	The maximum number of keys that can be bound to an action.
Private Attributes
QString	m_description
	The actions description.
QStringList	m_keys
	The keys bound to the action.

---

Detailed Description

An action (for this plugin) consists of a description, and a set of key sequences.

On its own, the action cannot actually identify a particular action. This is a class to make the keybinding class easier to manage.

Definition at line 39 of file action.h.

---

Constructor & Destructor Documentation

Action::Action

(

const QString &

description

)

[inline]

Create a new empty action.

Definition at line 43 of file action.h.

Action::Action	(	const QString &	description,
		const QString &	keys
	)

Create a new action.

The keys are parased by a QKeySequence, so they should be in "," or ", " delimeted format. Also, there should be no more than four keys in the string.

Parameters:

description	The description of the action.
keys	The key sequence (strings) that trigger the action.

Definition at line 41 of file action.cpp.

---

Member Function Documentation

bool Action::AddKey

(

const QString &

key

)

Add a key sequence to this action.

We don't add empty keys nor duplicates, and cannot add more than kMaximumNumberOfBindings. If any of these restrictions are a problem we return false and do not add the binding.

Parameters:

key	The key to add to the action.

Returns:

true if the key was added otherwise, false.

Definition at line 71 of file action.cpp.

Referenced by ActionSet::Add().

bool Action::ReplaceKey	(	const QString &	newkey,
		const QString &	oldkey
	)

Replace a key.

Parameters:

newkey	The new key.
oldkey	The old key, which is being replaced.

Definition at line 91 of file action.cpp.

Referenced by ActionSet::Replace().

bool Action::RemoveKey

(

const QString &

key

)

[inline]

Remove a key from this action.

Returns:

true on success, false otherwise.

Definition at line 54 of file action.h.

Referenced by ActionSet::Remove().

QString Action::GetDescription

(

void

)

const [inline]

Returns the action description. (note: not threadsafe)

Definition at line 61 of file action.h.

QStringList Action::GetKeys

(

void

)

const [inline]

Returns the key sequence(s) that trigger this action.

(note: not threadsafe)

Definition at line 69 of file action.h.

Referenced by ActionSet::AddAction().

QString Action::GetKeyString

(

void

)

const [inline]

Returns comma delimited string of key bindings.

Definition at line 76 of file action.h.

bool Action::IsEmpty

(

void

)

const [inline]

Returns true iff the action has no keys.

Definition at line 78 of file action.h.

bool Action::HasKey

(

const QString &

key

)

const

Determine if the action already has a key.

Parameters:

key	The key to check for.

Returns:

true if the key is already bound in this action, otherwise, false is returned.

Definition at line 55 of file action.cpp.

Referenced by AddKey(), and ReplaceKey().

---

Member Data Documentation

const unsigned int Action::kMaximumNumberOfBindings = 4 [static]

The maximum number of keys that can be bound to an action.

Definition at line 83 of file action.h.

Referenced by AddKey(), MythControls::AddKeyToAction(), MythControls::Create(), MythControls::GetCurrentButton(), and MythControls::RefreshKeyInformation().

QString Action::m_description [private]

The actions description.

Definition at line 86 of file action.h.

Referenced by Action(), and GetDescription().

QStringList Action::m_keys [private]

The keys bound to the action.

Definition at line 87 of file action.h.

Referenced by Action(), AddKey(), GetKeys(), GetKeyString(), HasKey(), IsEmpty(), RemoveKey(), and ReplaceKey().

---

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

• action.h
• action.cpp