class KSelectAction

Public Methods

•  KSelectAction ( const QString& text, const KShortcut& cut = KShortcut(), QObject* parent = 0, const char* name = 0 )
•  KSelectAction ( const QString& text, const KShortcut& cut, const QObject* receiver, const char* slot, QObject* parent, const char* name = 0 )
•  KSelectAction ( const QString& text, const QIconSet& pix, const KShortcut& cut = KShortcut(), QObject* parent = 0, const char* name = 0 )
•  KSelectAction ( const QString& text, const QString& pix, const KShortcut& cut = KShortcut(), QObject* parent = 0, const char* name = 0 )
•  KSelectAction ( const QString& text, const QIconSet& pix, const KShortcut& cut, const QObject* receiver, const char* slot, QObject* parent, const char* name = 0 )
•  KSelectAction ( const QString& text, const QString& pix, const KShortcut& cut, const QObject* receiver, const char* slot, QObject* parent, const char* name = 0 )
•  KSelectAction ( QObject* parent = 0, const char* name = 0 )
• virtual  ~KSelectAction ()
• virtual int  plug ( QWidget* widget, int index = -1 )
• virtual bool  isEditable () const
• virtual QStringList  items () const
• virtual void  changeItem ( int index, const QString& text )
• virtual QString  currentText () const
• virtual int  currentItem () const
• virtual int  comboWidth () const
• QPopupMenu*  popupMenu () const
• void  setRemoveAmpersandsInCombo ( bool b )
• bool  removeAmpersandsInCombo () const
• void  setMenuAccelsEnabled ( bool b )
• bool  menuAccelsEnabled () const

Public Slots

• virtual void  setCurrentItem ( int index )
• virtual void  setItems ( const QStringList &lst )
• virtual void  clear ()
• virtual void  setEditable ( bool )
• virtual void  setComboWidth ( int width )

Signals

• void  activated ( int index )
• void  activated ( const QString& text )

Protected Methods

• virtual void  changeItem ( int id, int index, const QString& text )
• QStringList  comboItems () const
• virtual void  updateCurrentItem ( int id )
• virtual void  updateComboWidth ( int id )
• virtual void  updateItems ( int id )
• virtual void  updateClear ( int id )
• virtual void  virtual_hook ( int id, void* data )

Protected Slots

• virtual void  slotActivated ( int id )
• virtual void  slotActivated ( const QString &text )
• virtual void  slotActivated ()

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.

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

Parameters:

text	The text that will be displayed.
cut	The corresponding keyboard accelerator (shortcut).
parent	This action's parent.
name	An internal name for this action.

Parameters:

text	The text that will be displayed.
cut	The corresponding keyboard accelerator (shortcut).
receiver	The SLOT's parent.
slot	The SLOT to invoke to execute this action.
parent	This action's parent.
name	An internal name for this action.

Parameters:

text	The text that will be displayed.
pix	The icons that go with this action.
cut	The corresponding keyboard accelerator (shortcut).
parent	This action's parent.
name	An internal name for this action.

Parameters:

text	The text that will be displayed.
pix	The dynamically loaded icon that goes with this action.
cut	The corresponding keyboard accelerator (shortcut).
parent	This action's parent.
name	An internal name for this action.

Parameters:

text	The text that will be displayed.
pix	The icons that go with this action.
cut	The corresponding keyboard accelerator (shortcut).
receiver	The SLOT's parent.
slot	The SLOT to invoke to execute this action.
parent	This action's parent.
name	An internal name for this action.

Parameters:

text	The text that will be displayed.
pix	The dynamically loaded icon that goes with this action.
cut	The corresponding keyboard accelerator (shortcut).
receiver	The SLOT's parent.
slot	The SLOT to invoke to execute this action.
parent	This action's parent.
name	An internal name for this action.

Parameters:

parent	This action's parent.
name	An internal name for this action.

[virtual]

Destructor

[virtual]

"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:

widget	The GUI element to display this action.
index	The index of the item.

Reimplemented from KAction.

[const virtual]

When this action is plugged into a toolbar, it creates a combobox.

Returns: true if the combo editable.

[const virtual]

Returns: the items that can be selected with this action. Use setItems to set them.

[virtual]

[const virtual]

[const virtual]

[const virtual]

When this action is plugged into a toolbar, it creates a combobox. This returns the maximum width set by setComboWidth

[const]

Reimplemented from KAction.

Deprecated. See setMenuAccelsEnabled .

[const]

Sets whether any occurence of the ampersand character ( & ) in items should be interpreted as keyboard accelerator for items displayed in a menu or not.

[const]

[virtual slot]

Sets the currently checked item.

Parameters:

index

Index of the item (remember the first item is zero).

[virtual slot]

Sets the items to be displayed in this action You need to call this.

[virtual slot]

Clears up all the items in this action

[virtual slot]

When this action is plugged into a toolbar, it creates a combobox. This makes the combo editable or read-only.

[virtual slot]

When this action is plugged into a toolbar, it creates a combobox. This gives a _maximum_ size to the combobox. The minimum size is automatically given by the contents (the items).

[protected virtual]

[protected const]

Depending on the menuAccelsEnabled property this method will return the actions items in a way for inclusion in a combobox with the ampersand character removed from all items or not.

[protected slots virtual slot]

Reimplemented from KAction.

[protected slots virtual slot]

Reimplemented from KAction.

[protected slots virtual slot]

Reimplemented from KAction.

[signal]

Reimplemented from KAction.

[signal]

Reimplemented from KAction.

[protected virtual]

[protected virtual]

[protected virtual]

[protected virtual]

[protected virtual]

Reimplemented from KAction.