class KSelectAction

Action for selecting one of several items. More...

Definition#include <kstdaction.h>
InheritsQSelectAction (qk)
Inherited byKFontAction, KFontSizeAction
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Methods

Signals

Protected Slots


Detailed Description

Action for selecting one of several items.

This action shows up a submenu with a list of items. One of them can be checked. If The user clicks on an item this item will automatically be checked, the formerly checked item becomes unchecked. There can be only one item checked at a time.

KSelectAction ( const QString& text, int accel = 0, QObject* parent = 0, const char* name = 0 )

Construct a select action with text and potential keyboard accelerator but nothing else. Use this only if you really know what you are doing.

Parameters:
textThe text that will be displayed.
accelThe corresponding keyboard accelerator (shortcut).
parentThis action's parent.
nameAn internal name for this action.

KSelectAction ( const QString& text, int accel, const QObject* receiver, const char* slot, QObject* parent, const char* name = 0 )

Parameters:
textThe text that will be displayed.
accelThe corresponding keyboard accelerator (shortcut).
receiverThe SLOT's parent.
slotThe SLOT to invoke to execute this action.
parentThis action's parent.
nameAn internal name for this action.

KSelectAction ( const QString& text, const QIconSet& pix, int accel = 0, QObject* parent = 0, const char* name = 0 )

Parameters:
textThe text that will be displayed.
pixThe icons that go with this action.
accelThe corresponding keyboard accelerator (shortcut).
parentThis action's parent.
nameAn internal name for this action.

KSelectAction ( const QString& text, const QIconSet& pix, int accel, const QObject* receiver, const char* slot, QObject* parent, const char* name = 0 )

Parameters:
textThe text that will be displayed.
pixThe icons that go with this action.
accelThe corresponding keyboard accelerator (shortcut).
receiverThe SLOT's parent.
slotThe SLOT to invoke to execute this action.
parentThis action's parent.
nameAn internal name for this action.

KSelectAction ( QObject* parent = 0, const char* name = 0 )

Parameters:
parentThis action's parent.
nameAn internal name for this action.

int plug ( QWidget* widget, int index = -1 )

"Plug" or insert this action into a given widget.

This will typically be a menu or a toolbar. From this point on, you will never need to directly manipulate the item in the menu or toolbar. You do all enabling/disabling/manipulation directly with your KSelectAction object.

Parameters:
widgetThe GUI element to display this action.
indexThe index of the item.

void setCurrentItem ( int index )
[virtual]

Sets the currently checked item.

Parameters:
indexIndex of the item (remember the first item is zero).

void setItems ( const QStringList& lst )

Sets a list of strings as items into the menu.

Parameters:
lstA list of strings that represents the items.

void clear ()

Clears all items in the select action.


Generated by: root@tantive.terraplex.com on Sun Feb 27 17:39:25 2000, using kdoc 2.0a33.