K3ListBox Class Reference

#include <k3listbox.h>

Inheritance diagram for K3ListBox:

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

Public Member Functions
	K3ListBox (QWidget *parent=0, const char *name=0, Qt::WindowFlags f=0)

Protected Slots
void	slotAutoSelect ()
void	slotOnItem (Q3ListBoxItem *item)
void	slotOnViewport ()
void	slotSettingsChanged (int)

Protected Member Functions
virtual void	contentsMouseDoubleClickEvent (QMouseEvent *e)
virtual void	contentsMousePressEvent (QMouseEvent *e)
void	emitExecute (Q3ListBoxItem *item, const QPoint &pos)
virtual void	focusOutEvent (QFocusEvent *fe)
virtual void	keyPressEvent (QKeyEvent *e)
virtual void	leaveEvent (QEvent *e)

Protected Attributes
int	m_autoSelectDelay
bool	m_bChangeCursorOverItem
bool	m_bUseSingle
QTimer *	m_pAutoSelect
Q3ListBoxItem *	m_pCurrentItem

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 recommended 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.

Definition at line 39 of file k3listbox.h.

Constructor & Destructor Documentation

K3ListBox::K3ListBox ( QWidget *  parent = 0, const char *  name = 0, Qt::WindowFlags  f = 0  )

explicit

Definition at line 29 of file k3listbox.cpp.

Member Function Documentation

void K3ListBox::contentsMouseDoubleClickEvent ( QMouseEvent *  e )

protectedvirtual

Definition at line 239 of file k3listbox.cpp.

void K3ListBox::contentsMousePressEvent ( QMouseEvent *  e )

protectedvirtual

Definition at line 225 of file k3listbox.cpp.

void K3ListBox::doubleClicked ( Q3ListBoxItem *  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 K3ListBox::emitExecute ( Q3ListBoxItem *  item, const QPoint &  pos  )

protected

Definition at line 175 of file k3listbox.cpp.

void K3ListBox::executed ( Q3ListBoxItem *  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.

void K3ListBox::executed ( Q3ListBoxItem *  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 K3ListBox::focusOutEvent ( QFocusEvent *  fe )

protectedvirtual

Definition at line 211 of file k3listbox.cpp.

void K3ListBox::keyPressEvent ( QKeyEvent *  e )

protectedvirtual

Definition at line 195 of file k3listbox.cpp.

void K3ListBox::leaveEvent ( QEvent *  e )

protectedvirtual

Definition at line 218 of file k3listbox.cpp.

void K3ListBox::slotAutoSelect ( )

protectedslot

Auto selection happend.

Definition at line 105 of file k3listbox.cpp.

void K3ListBox::slotOnItem ( Q3ListBoxItem *  item )

protectedslot

Definition at line 46 of file k3listbox.cpp.

void K3ListBox::slotOnViewport ( )

protectedslot

Definition at line 58 of file k3listbox.cpp.

void K3ListBox::slotSettingsChanged ( int  category )

protectedslot

Definition at line 68 of file k3listbox.cpp.

Member Data Documentation

int K3ListBox::m_autoSelectDelay

protected

Definition at line 115 of file k3listbox.h.

bool K3ListBox::m_bChangeCursorOverItem

protected

Definition at line 110 of file k3listbox.h.

bool K3ListBox::m_bUseSingle

protected

Definition at line 109 of file k3listbox.h.

QTimer* K3ListBox::m_pAutoSelect

protected

Definition at line 114 of file k3listbox.h.

Q3ListBoxItem* K3ListBox::m_pCurrentItem

protected

Definition at line 112 of file k3listbox.h.

---

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

• k3listbox.h
• k3listbox.cpp