.TH "KListBox" kde3 "11 Jun 2005" "Version Version 3.4.1" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KListBox \- A variant of \fBQListBox\fP that honors KDE's system-wide settings.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <klistbox.h>\fP
.PP
Inherits \fBQListBox\fP.
.PP
Inherited by \fBKCompletionBox\fP, KJanusWidget::IconListBox, and \fBKURLBarListBox\fP.
.PP
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBexecuted\fP (\fBQListBoxItem\fP *\fBitem\fP)"
.br
.ti -1c
.RI "void \fBexecuted\fP (\fBQListBoxItem\fP *\fBitem\fP, const \fBQPoint\fP &pos)"
.br
.ti -1c
.RI "void \fBdoubleClicked\fP (\fBQListBoxItem\fP *\fBitem\fP, const \fBQPoint\fP &pos)"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKListBox\fP (\fBQWidget\fP *parent=0, const char *name=0, WFlags f=0)"
.br
.in -1c
.SS "Protected Slots"

.in +1c
.ti -1c
.RI "void \fBslotOnItem\fP (\fBQListBoxItem\fP *\fBitem\fP)"
.br
.ti -1c
.RI "void \fBslotOnViewport\fP ()"
.br
.ti -1c
.RI "void \fBslotSettingsChanged\fP (int)"
.br
.ti -1c
.RI "void \fBslotAutoSelect\fP ()"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "void \fBemitExecute\fP (\fBQListBoxItem\fP *\fBitem\fP, const \fBQPoint\fP &pos)"
.br
.ti -1c
.RI "virtual void \fBkeyPressEvent\fP (\fBQKeyEvent\fP *e)"
.br
.ti -1c
.RI "virtual void \fBfocusOutEvent\fP (\fBQFocusEvent\fP *fe)"
.br
.ti -1c
.RI "virtual void \fBleaveEvent\fP (\fBQEvent\fP *e)"
.br
.ti -1c
.RI "virtual void \fBcontentsMousePressEvent\fP (\fBQMouseEvent\fP *e)"
.br
.ti -1c
.RI "virtual void \fBcontentsMouseDoubleClickEvent\fP (\fBQMouseEvent\fP *e)"
.br
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SS "Protected Attributes"

.in +1c
.ti -1c
.RI "bool \fBm_bUseSingle\fP"
.br
.ti -1c
.RI "bool \fBm_bChangeCursorOverItem\fP"
.br
.ti -1c
.RI "\fBQListBoxItem\fP * \fBm_pCurrentItem\fP"
.br
.ti -1c
.RI "\fBQTimer\fP * \fBm_pAutoSelect\fP"
.br
.ti -1c
.RI "int \fBm_autoSelectDelay\fP"
.br
.in -1c
.SH "Detailed Description"
.PP 
A variant of \fBQListBox\fP that honors KDE's system-wide settings. 

Extends the functionality of \fBQListBox\fP to honor the system wide settings for Single Click/Double Click mode, Auto Selection and Change Cursor over Link.
.PP
There is a new signal \fBexecuted()\fP. It gets connected to either \fBQListBox::clicked()\fP or \fBQListBox::doubleClicked()\fP depending on the \fBKDE\fP 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 \fBQListBox::selectionChanged()\fP signal. 
.PP
Definition at line 40 of file klistbox.h.
.SH "Member Function Documentation"
.PP 
.SS "void KListBox::executed (\fBQListBoxItem\fP * item)\fC [signal]\fP"
.PP
Emitted whenever the user executes an listbox item. 
.PP
That means depending on the \fBKDE\fP wide Single Click/Double Click setting the user clicked or double clicked on that item. 
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP is the pointer to the executed listbox item.
.RE
.PP
Note that you may not delete any \fBQListBoxItem\fP objects in slots connected to this signal. 
.SS "void KListBox::executed (\fBQListBoxItem\fP * item, const \fBQPoint\fP & pos)\fC [signal]\fP"
.PP
Emitted whenever the user executes an listbox item. 
.PP
That means depending on the \fBKDE\fP wide Single Click/Double Click setting the user clicked or double clicked on that item. 
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP is the pointer to the executed listbox item. 
.br
\fIpos\fP is the position where the user has clicked
.RE
.PP
Note that you may not delete any \fBQListBoxItem\fP objects in slots connected to this signal. 
.SS "void KListBox::doubleClicked (\fBQListBoxItem\fP * item, const \fBQPoint\fP & pos)\fC [signal]\fP"
.PP
This signal gets emitted whenever the user double clicks into the listbox. 
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP The pointer to the clicked listbox item. 
.br
\fIpos\fP The position where the user has clicked.
.RE
.PP
Note that you may not delete any \fBQListBoxItem\fP objects in slots connected to this signal.
.PP
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 \fBexecuted()\fP instead. 
.PP
Referenced by KCompletionBox::KCompletionBox().
.SS "void KListBox::slotAutoSelect ()\fC [protected, slot]\fP"
.PP
Auto selection happend. 
.PP
Definition at line 109 of file klistbox.cpp.
.PP
References QListBox::clearSelection(), QListBox::currentItem(), endl(), QListBox::index(), QListBoxItem::isSelected(), QListBox::item(), kdDebug(), KApplication::keyboardMouseState(), QListBoxItem::next(), QListBox::selectionChanged(), QListBox::selectionMode(), QListBox::setCurrentItem(), QListBox::setSelected(), and QListBox::triggerUpdate().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdeui Library from the source code.
