Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members  

KListBox Class Reference

A variant of QListBox that honors KDE's system-wide settings. More...

#include <klistbox.h>

Inheritance diagram for KListBox:

KCompletionBox List of all members.

Signals

void executed (QListBoxItem *item)
void executed (QListBoxItem *item, const QPoint &pos)
void doubleClicked (QListBoxItem *item, const QPoint &pos)

Public Methods

 KListBox (QWidget *parent=0, const char *name=0, WFlags f=0)

Protected Slots

void slotOnItem (QListBoxItem *item)
void slotOnViewport ()
void slotSettingsChanged (int)
void slotAutoSelect ()

Protected Methods

void emitExecute (QListBoxItem *item, const QPoint &pos)
virtual void keyPressEvent (QKeyEvent *e)
virtual void focusOutEvent (QFocusEvent *fe)
virtual void leaveEvent (QEvent *e)
virtual void contentsMousePressEvent (QMouseEvent *e)
virtual void contentsMouseDoubleClickEvent (QMouseEvent *e)
virtual void virtual_hook (int id, void *data)

Protected Attributes

bool m_bUseSingle
bool m_bChangeCursorOverItem
QListBoxItem * m_pCurrentItem
QTimer * m_pAutoSelect
int m_autoSelectDelay

Detailed Description

A variant of QListBox that honors KDE's system-wide settings.

Extends the functionality of QListBox to honor the system wide settings for Single Click/Double Click mode, Auto Selection and Change Cursor over Link.

There is a new signal executed(). It gets connected to either QListBox::clicked() or QListBox::doubleClicked() depending on the KDE wide Single Click/Double Click settings. It is strongly recomended that you use this signal instead of the above mentioned. This way you donīt need to care about the current settings. If you want to get informed when the user selects something connect to the QListBox::selectionChanged() signal.


Member Function Documentation

virtual void KListBox::contentsMouseDoubleClickEvent QMouseEvent *    e [protected, virtual]
 

@reimplemented

virtual void KListBox::contentsMousePressEvent QMouseEvent *    e [protected, virtual]
 

@reimplemented

void KListBox::doubleClicked QListBoxItem *    item,
const QPoint &    pos
[signal]
 

This signal gets emitted whenever the user double clicks into the listbox.

Parameters:
item  The pointer to the clicked listbox item.
pos  The position where the user has clicked.
Note that you may not delete any QListBoxItem objects in slots connected to this signal.

This signal is more or less here for the sake of completeness. You should normally not need to use this. In most cases itīs better to use executed() instead.

void KListBox::executed QListBoxItem *    item,
const QPoint &    pos
[signal]
 

Emitted whenever the user executes an listbox item.

That means depending on the KDE wide Single Click/Double Click setting the user clicked or double clicked on that item.

Parameters:
item  is the pointer to the executed listbox item.
pos  is the position where the user has clicked
Note that you may not delete any QListBoxItem objects in slots connected to this signal.

void KListBox::executed QListBoxItem *    item [signal]
 

Emitted whenever the user executes an listbox item.

That means depending on the KDE wide Single Click/Double Click setting the user clicked or double clicked on that item.

Parameters:
item  is the pointer to the executed listbox item.
Note that you may not delete any QListBoxItem objects in slots connected to this signal.

virtual void KListBox::focusOutEvent QFocusEvent *    fe [protected, virtual]
 

@reimplemented

virtual void KListBox::keyPressEvent QKeyEvent *    e [protected, virtual]
 

@reimplemented

virtual void KListBox::leaveEvent QEvent *    e [protected, virtual]
 

@reimplemented

void KListBox::slotAutoSelect   [protected, slot]
 

Auto selection happend.


The documentation for this class was generated from the following file:
Generated on Sat Mar 29 01:17:16 2003 by doxygen1.2.17