kdeui Library API Documentation

KActionCollection Class Reference

A managed set of KAction objects. More...

#include <kactioncollection.h>

Inheritance diagram for KActionCollection:

Inheritance graph
[legend]
Collaboration diagram for KActionCollection:

Collaboration graph
[legend]
List of all members.

Public Slots

void clear ()

Signals

void inserted (KAction *)
void removed (KAction *)
void actionHighlighted (KAction *action)
void actionHighlighted (KAction *action, bool highlight)
void actionStatusText (const QString &text)
void clearStatusText ()

Public Member Functions

 KActionCollection (QWidget *parent, const char *name=0, KInstance *instance=0)
 KActionCollection (QWidget *watch, QObject *parent, const char *name=0, KInstance *instance=0)
 KActionCollection (const KActionCollection &copy)
virtual void setWidget (QWidget *widget)
void setAutoConnectShortcuts (bool)
bool isAutoConnectShortcuts ()
bool addDocCollection (KActionCollection *pDoc)
virtual KAccelaccel () KDE_DEPRECATED
virtual const KAccelaccel () const KDE_DEPRECATED
KAccelkaccel ()
const KAccelkaccel () const
KAccelbuilderKAccel () const
virtual uint count () const
bool isEmpty () const
virtual KActionaction (int index) const
virtual KActionaction (const char *name, const char *classname=0) const
virtual QStringList groups () const
virtual KActionPtrList actions (const QString &group) const
virtual KActionPtrList actions () const
bool readShortcutSettings (const QString &sConfigGroup=QString::null, KConfigBase *pConfig=0)
bool writeShortcutSettings (const QString &sConfigGroup=QString::null, KConfigBase *pConfig=0) const
void setInstance (KInstance *instance)
KInstanceinstance () const
void setXMLFile (const QString &)
const QStringxmlFile () const
void setHighlightingEnabled (bool enable)
bool highlightingEnabled () const
void connectHighlight (QWidget *container, KAction *action)
void disconnectHighlight (QWidget *container, KAction *action)
const KXMLGUIClientparentGUIClient () const
 KActionCollection (QObject *parent, const char *name=0, KInstance *instance=0)
void insert (KAction *action)
void remove (KAction *action)
KActiontake (KAction *action)
KActionCollection operator+ (const KActionCollection &) const
KActionCollectionoperator= (const KActionCollection &)
KActionCollectionoperator+= (const KActionCollection &)

Protected Member Functions

virtual void virtual_hook (int id, void *data)

Friends

class KAction
class KXMLGUIClient

Detailed Description

A managed set of KAction objects.

Definition at line 63 of file kactioncollection.h.


Constructor & Destructor Documentation

KActionCollection::KActionCollection QWidget watch,
QObject parent,
const char *  name = 0,
KInstance instance = 0
 

Use this constructor if you want the collection's actions to restrict their accelerator keys to watch rather than the parent.

If you don't require shortcuts, you can pass a null to the watch parameter.

Definition at line 90 of file kactioncollection.cpp.

References kdDebug(), and setWidget().


Member Function Documentation

void KActionCollection::setWidget QWidget widget  )  [virtual]
 

This sets the widget to which the keyboard shortcuts should be attached.

You only need to call this if a null pointer was passed in the constructor.

Definition at line 150 of file kactioncollection.cpp.

References kdWarning().

Referenced by KActionCollection().

void KActionCollection::setAutoConnectShortcuts bool   ) 
 

This indicates whether new actions which are created in this collection should have their keyboard shortcuts automatically connected on construction.

Set to 'false' if you will be loading XML-based settings. This is automatically done by KParts. The default is 'true'.

See also:
isAutoConnectShortcuts()

Definition at line 165 of file kactioncollection.cpp.

bool KActionCollection::isAutoConnectShortcuts  ) 
 

This indicates whether new actions which are created in this collection have their keyboard shortcuts automatically connected on construction.

See also:
setAutoConnectShortcuts()

Definition at line 170 of file kactioncollection.cpp.

bool KActionCollection::addDocCollection KActionCollection pDoc  ) 
 

Doc/View model.

This lets you add the action collection of a document to a view's action collection.

Definition at line 175 of file kactioncollection.cpp.

KAccel * KActionCollection::accel  )  [virtual]
 

Deprecated:
Deprecated because of ambiguous name. Use kaccel()

Definition at line 367 of file kactioncollection.cpp.

References kaccel().

const KAccel * KActionCollection::accel  )  const [virtual]
 

Deprecated:
Deprecated because of ambiguous name. Use kaccel()

Definition at line 368 of file kactioncollection.cpp.

References kaccel().

KAccel * KActionCollection::kaccel  ) 
 

Returns the KAccel object of the most recently set widget.

Definition at line 280 of file kactioncollection.cpp.

Referenced by accel().

const KAccel * KActionCollection::kaccel  )  const
 

Returns the KAccel object of the most recently set widget.

Const version for convenience.

Definition at line 289 of file kactioncollection.cpp.

uint KActionCollection::count  )  const [virtual]
 

Returns the number of actions in the collection.

Definition at line 416 of file kactioncollection.cpp.

Referenced by KAction::plug().

KAction * KActionCollection::action int  index  )  const [virtual]
 

Return the KAction* at position "index" in the action collection.

See also:
count()

Definition at line 398 of file kactioncollection.cpp.

Referenced by KXMLGUIClient::action(), and KXMLGUIClient::stateChanged().

KAction * KActionCollection::action const char *  name,
const char *  classname = 0
const [virtual]
 

Find an action (optionally, of a given subclass of KAction) in the action collection.

Parameters:
name Name of the KAction.
classname Name of the KAction subclass.
Returns:
A pointer to the first KAction in the collection which matches the parameters or null if nothing matches.

Definition at line 371 of file kactioncollection.cpp.

QStringList KActionCollection::groups  )  const [virtual]
 

Returns a list of all the groups of all the KActions in this action collection.

See also:
KAction::group()

KAction::setGroup()

Definition at line 421 of file kactioncollection.cpp.

KActionPtrList KActionCollection::actions const QString group  )  const [virtual]
 

Returns the list of actions in a particular group managed by this action collection.

Parameters:
group The name of the group.

Definition at line 433 of file kactioncollection.cpp.

KActionPtrList KActionCollection::actions  )  const [virtual]
 

Returns the list of actions managed by this action collection.

Definition at line 447 of file kactioncollection.cpp.

bool KActionCollection::readShortcutSettings const QString sConfigGroup = QString::null,
KConfigBase pConfig = 0
 

Used for reading shortcut configuration from a non-XML rc file.

Definition at line 406 of file kactioncollection.cpp.

bool KActionCollection::writeShortcutSettings const QString sConfigGroup = QString::null,
KConfigBase pConfig = 0
const
 

Used for writing shortcut configuration to a non-XML rc file.

Definition at line 411 of file kactioncollection.cpp.

KInstance * KActionCollection::instance  )  const
 

The instance with which this class is associated.

Definition at line 466 of file kactioncollection.cpp.

Referenced by KKeyChooser::insert(), KPasteTextAction::plug(), KToolBarPopupAction::plug(), KActionMenu::plug(), KRecentFilesAction::plug(), and KAction::plug().

void KActionCollection::setXMLFile const QString  ) 
 

Deprecated:

Definition at line 471 of file kactioncollection.cpp.

Referenced by KXMLGUIClient::setXMLFile().

const QString & KActionCollection::xmlFile  )  const
 

Deprecated:

Definition at line 476 of file kactioncollection.cpp.

void KActionCollection::setHighlightingEnabled bool  enable  ) 
 

Enable highlighting notification for specific KActions.

See also:
connectHighlight()

disconnectHighlight()

actionHighlighted()

actionHighlighted()

highlightingEnabled()

Definition at line 481 of file kactioncollection.cpp.

bool KActionCollection::highlightingEnabled  )  const
 

Return whether highlighting notifications are enabled.

See also:
connectHighlight()

disconnectHighlight()

actionHighlighted()

setHighlightingEnabled()

actionHighlighted()

Definition at line 486 of file kactioncollection.cpp.

void KActionCollection::connectHighlight QWidget container,
KAction action
 

Call this function if you want to receive a signal whenever a KAction is highlighted in a menu or a toolbar.

Parameters:
container A container in which the KAction is plugged (must inherit QPopupMenu or KToolBar)
action The action you are interested in
See also:
disconnectHighlight()

actionHighlighted()

setHighlightingEnabled()

highlightingEnabled()

actionHighlighted()

Definition at line 491 of file kactioncollection.cpp.

Referenced by KActionMenu::plug(), and KAction::plug().

void KActionCollection::disconnectHighlight QWidget container,
KAction action
 

Disconnect highlight notifications for a particular pair of contianer and action.

Parameters:
container A container in which the KAction is plugged (must inherit QPopupMenu or KToolBar)
action The action you are interested in
See also:
connectHighlight()

actionHighlighted()

setHighlightingEnabled()

highlightingEnabled()

actionHighlighted()

Definition at line 524 of file kactioncollection.cpp.

Referenced by KAction::unplug().

const KXMLGUIClient * KActionCollection::parentGUIClient  )  const
 

The parent KXMLGUIClient, return 0L if not available.

Definition at line 625 of file kactioncollection.cpp.

void KActionCollection::actionHighlighted KAction action  )  [signal]
 

Emitted when "action" is highlighted.

See also:
connectHighlight()

disconnectHighlight()

actionHighlighted()

setHighlightingEnabled()

highlightingEnabled()

void KActionCollection::actionHighlighted KAction action,
bool  highlight
[signal]
 

Emitted when "action" is highlighed or loses highlighting.

See also:
connectHighlight()

disconnectHighlight()

actionHighlighted()

setHighlightingEnabled()

highlightingEnabled()

void KActionCollection::insert KAction action  ) 
 

Add an action to the collection.

Generally you don't have to call this. The action inserts itself automatically into its parent collection. This can be useful however for a short-lived collection (e.g. for a popupmenu, where the signals from the collection are needed too). (don't forget that in the simple case, a list of actions should be a simple KActionPtrList). If you manually insert actions into a 2nd collection, don't forget to take them out again before destroying the collection.

Parameters:
action The KAction to add.

Definition at line 363 of file kactioncollection.cpp.

void KActionCollection::remove KAction action  ) 
 

Removes an action from the collection and deletes it.

Since the KAction destructor removes the action from the collection, you generally don't have to call this.

Parameters:
action The KAction to remove.

Definition at line 364 of file kactioncollection.cpp.

KAction * KActionCollection::take KAction action  ) 
 

Removes an action from the collection.

Since the KAction destructor removes the action from the collection, you generally don't have to call this.

Returns:
NULL if not found else returns action.
Parameters:
action the KAction to remove.

Definition at line 365 of file kactioncollection.cpp.

Referenced by KAction::~KAction().

void KActionCollection::clear  )  [slot]
 

Clears the entire actionCollection, deleting all actions.

See also:
remove

Definition at line 366 of file kactioncollection.cpp.


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for kdeui Library Version 3.3.90.
Documentation copyright © 1996-2004 the KDE developers.
Generated on Wed Mar 30 10:12:13 2005 by doxygen 1.3.9.1 written by Dimitri van Heesch, © 1997-2003