Source Code (Use browser search to find items of interest.)
Class Index
kdelibs'KListBox (./kdelibs/kdeui/klistbox.h:37)
class KListBox : public QListBox
{
Q_OBJECT
public:
KListBox( QWidget *parent = 0, const char *name = 0, WFlags f = 0 );
signals:
/**
* This signal is 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.
* @param item is the pointer to the executed listbox item.
*
* Note that you may not delete any @ref QListBoxItem objects in slots
* connected to this signal.
*/
void executed( QListBoxItem *item );
/**
* This signal is 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.
* @param item is the pointer to the executed listbox item.
* @param pos is the position where the user has clicked
*
* Note that you may not delete any @ref QListBoxItem objects in slots
* connected to this signal.
*/
void executed( QListBoxItem *item, const QPoint &pos );
/**
* This signal gets emitted whenever the user double clicks into the
* listbox.
* @param item is the pointer to the clicked listbox item.
* @param pos is the position where the user has clicked, and
*
* Note that you may not delete any @ref 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 @ref #executed instead.
*/
void doubleClicked( QListBoxItem *item, const QPoint &pos );
protected slots:
void slotOnItem( QListBoxItem *item );
void slotOnViewport();
void slotSettingsChanged(int);
/**
* Auto selection happend.
*/
void slotAutoSelect();
protected:
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 );
QCursor oldCursor;
bool m_bUseSingle;
bool m_bChangeCursorOverItem;
QListBoxItem* m_pCurrentItem;
QTimer* m_pAutoSelect;
int m_autoSelectDelay;
private slots:
void slotMouseButtonClicked( int btn, QListBoxItem *item, const QPoint &pos );
private:
class KListBoxPrivate;
KListBoxPrivate *d;
};
kdelibs'KListBox::KListBox() (./kdelibs/kdeui/klistbox.cpp:30)
KListBox::KListBox( QWidget *parent, const char *name, WFlags f )
: QListBox( parent, name, f )
{
oldCursor = viewport()->cursor();
connect( this, SIGNAL( onViewport() ),
this, SLOT( slotOnViewport() ) );
connect( this, SIGNAL( onItem( QListBoxItem * ) ),
this, SLOT( slotOnItem( QListBoxItem * ) ) );
slotSettingsChanged(KApplication::SETTINGS_MOUSE);
connect( kapp, SIGNAL( settingsChanged(int) ), SLOT( slotSettingsChanged(int) ) );
kapp->addKipcEventMask( KIPC::SettingsChanged );
m_pCurrentItem = 0L;
m_pAutoSelect = new QTimer( this );
connect( m_pAutoSelect, SIGNAL( timeout() ),
this, SLOT( slotAutoSelect() ) );
}
kdelibs'KListBox::slotOnItem() (./kdelibs/kdeui/klistbox.cpp:49)
void KListBox::slotOnItem( QListBoxItem *item )
{
if ( item && m_bChangeCursorOverItem && m_bUseSingle )
viewport()->setCursor( KCursor().handCursor() );
if ( item && (m_autoSelectDelay > -1) && m_bUseSingle ) {
m_pAutoSelect->start( m_autoSelectDelay, true );
m_pCurrentItem = item;
}
}
kdelibs'KListBox::slotOnViewport() (./kdelibs/kdeui/klistbox.cpp:60)
void KListBox::slotOnViewport()
{
if ( m_bChangeCursorOverItem )
viewport()->setCursor( oldCursor );
m_pAutoSelect->stop();
m_pCurrentItem = 0L;
}
kdelibs'KListBox::slotSettingsChanged() (./kdelibs/kdeui/klistbox.cpp:70)
void KListBox::slotSettingsChanged(int category)
{
if (category != KApplication::SETTINGS_MOUSE)
return;
m_bUseSingle = KGlobalSettings::singleClick();
disconnect( this, SIGNAL( mouseButtonClicked( int, QListBoxItem *,
const QPoint & ) ),
this, SLOT( slotMouseButtonClicked( int, QListBoxItem *,
const QPoint & ) ) );
// disconnect( this, SIGNAL( doubleClicked( QListBoxItem *,
// const QPoint & ) ),
// this, SLOT( slotExecute( QListBoxItem *,
// const QPoint & ) ) );
if( m_bUseSingle )
{
connect( this, SIGNAL( mouseButtonClicked( int, QListBoxItem *,
const QPoint & ) ),
this, SLOT( slotMouseButtonClicked( int, QListBoxItem *,
const QPoint & ) ) );
}
else
{
// connect( this, SIGNAL( doubleClicked( QListBoxItem *,
// const QPoint & ) ),
// this, SLOT( slotExecute( QListBoxItem *,
// const QPoint & ) ) );
}
m_bChangeCursorOverItem = KGlobalSettings::changeCursorOverIcon();
m_autoSelectDelay = KGlobalSettings::autoSelectDelay();
if( !m_bUseSingle || !m_bChangeCursorOverItem )
viewport()->setCursor( oldCursor );
}
kdelibs'KListBox::slotAutoSelect() (./kdelibs/kdeui/klistbox.cpp:107)
void KListBox::slotAutoSelect()
{
//Give this widget the keyboard focus.
if( !hasFocus() )
setFocus();
Window root;
Window child;
int root_x, root_y, win_x, win_y;
uint keybstate;
XQueryPointer( qt_xdisplay(), qt_xrootwin(), &root, &child,
&root_x, &root_y, &win_x, &win_y, &keybstate );
QListBoxItem* previousItem = item( currentItem() );
setCurrentItem( m_pCurrentItem );
if( m_pCurrentItem ) {
//Shift pressed?
if( (keybstate & ShiftMask) ) {
bool block = signalsBlocked();
blockSignals( true );
//No Ctrl? Then clear before!
if( !(keybstate & ControlMask) )
clearSelection();
bool select = !m_pCurrentItem->selected();
bool update = viewport()->isUpdatesEnabled();
viewport()->setUpdatesEnabled( false );
bool down = index( previousItem ) < index( m_pCurrentItem );
QListBoxItem* it = down ? previousItem : m_pCurrentItem;
for (;it ; it = it->next() ) {
if ( down && it == m_pCurrentItem ) {
setSelected( m_pCurrentItem, select );
break;
}
if ( !down && it == previousItem ) {
setSelected( previousItem, select );
break;
}
setSelected( it, select );
}
blockSignals( block );
viewport()->setUpdatesEnabled( update );
triggerUpdate( false );
emit selectionChanged();
if( selectionMode() == QListBox::Single )
emit selectionChanged( m_pCurrentItem );
}
else if( (keybstate & ControlMask) )
setSelected( m_pCurrentItem, !m_pCurrentItem->selected() );
else {
bool block = signalsBlocked();
blockSignals( true );
if( !m_pCurrentItem->selected() )
clearSelection();
blockSignals( block );
setSelected( m_pCurrentItem, true );
}
}
else
kdDebug() << "Thatīs not supposed to happen!!!!" << endl;
}
kdelibs'KListBox::emitExecute() (./kdelibs/kdeui/klistbox.cpp:178)
void KListBox::emitExecute( QListBoxItem *item, const QPoint &pos )
{
Window root;
Window child;
int root_x, root_y, win_x, win_y;
uint keybstate;
XQueryPointer( qt_xdisplay(), qt_xrootwin(), &root, &child,
&root_x, &root_y, &win_x, &win_y, &keybstate );
m_pAutoSelect->stop();
//Donīt emit executed if in SC mode and Shift or Ctrl are pressed
if( !( m_bUseSingle && ((keybstate & ShiftMask) || (keybstate & ControlMask)) ) ) {
emit executed( item );
emit executed( item, pos );
}
}
//
// 2000-16-01 Espen Sand
// This widget is used in dialogs. It should ignore
// F1 (and combinations) and Escape since these are used
// to start help or close the dialog. This functionality
// should be done in QListView but it is not (at least now)
//
kdelibs'KListBox::keyPressEvent() (./kdelibs/kdeui/klistbox.cpp:203)
void KListBox::keyPressEvent(QKeyEvent *e)
{
if( e->key() == Key_Escape )
{
e->ignore();
}
else if( e->key() == Key_F1 )
{
e->ignore();
}
else
{
QListBox::keyPressEvent(e);
}
}
kdelibs'KListBox::focusOutEvent() (./kdelibs/kdeui/klistbox.cpp:219)
void KListBox::focusOutEvent( QFocusEvent *fe )
{
m_pAutoSelect->stop();
QListBox::focusOutEvent( fe );
}
kdelibs'KListBox::leaveEvent() (./kdelibs/kdeui/klistbox.cpp:226)
void KListBox::leaveEvent( QEvent *e )
{
m_pAutoSelect->stop();
QListBox::leaveEvent( e );
}
kdelibs'KListBox::contentsMousePressEvent() (./kdelibs/kdeui/klistbox.cpp:233)
void KListBox::contentsMousePressEvent( QMouseEvent *e )
{
if( (selectionMode() == Extended) && (e->state() & ShiftButton) && !(e->state() & ControlButton) ) {
bool block = signalsBlocked();
blockSignals( true );
clearSelection();
blockSignals( block );
}
QListBox::contentsMousePressEvent( e );
}
kdelibs'KListBox::contentsMouseDoubleClickEvent() (./kdelibs/kdeui/klistbox.cpp:247)
void KListBox::contentsMouseDoubleClickEvent ( QMouseEvent * e )
{
QListBox::contentsMouseDoubleClickEvent( e );
QListBoxItem* item = itemAt( e->pos() );
if( item ) {
emit doubleClicked( item, e->globalPos() );
if( (e->button() == LeftButton) && !m_bUseSingle )
emitExecute( item, e->globalPos() );
}
}
kdelibs'KListBox::slotMouseButtonClicked() (./kdelibs/kdeui/klistbox.cpp:261)
void KListBox::slotMouseButtonClicked( int btn, QListBoxItem *item, const QPoint &pos )
{
if( (btn == LeftButton) && item )
emitExecute( item, pos );
}