Wt::WSelectionBox Class Reference
[Model/view system]

A selection box allows selection from a list of options. More...

#include <Wt/WSelectionBox>

Inheritance diagram for Wt::WSelectionBox:

Inheritance graph
[legend]

List of all members.

Public Member Functions

 WSelectionBox (WContainerWidget *parent=0)
 Constructor.
int verticalSize () const
 Sets the number of items that are visible.
void setVerticalSize (int items)
 Returns the number of items that are visible.
void setSelectionMode (SelectionMode mode)
 Sets the selection mode.
SelectionMode selectionMode () const
 Returns the selection mode.
const std::set< int > & selectedIndexes () const
 Returns the current selection (in Wt::ExtendedSelection mode).
void setSelectedIndexes (const std::set< int > &selection)
 Sets the selection (in Wt::ExtendedSelection mode).
void clearSelection ()
 Clears the current selection.


Detailed Description

A selection box allows selection from a list of options.

By default, a selection box may be used to let the user select one item from a list. This may be changed to multiple selection mode using setSelectionMode().

The current selection may be set and read using setCurrentIndex() and currentIndex(), for SingleSelection mode, or setSelectedIndexes() and selectedIndexes() for Wt::ExtendedSelection mode. The activated() and sactivated() signals are not emited in the Wt::ExtendedSelection mode, use the changed() signal changed().

WSelectionBox is an MVC view class, using a simple string list model by default. The model may be populated using WComboBox::addItem() or WComboBox::insertItem() and the contents can be cleared through clear(). These methods manipulate the underlying model().

To use the selectionbox with a custom model instead of the default WStringListModel, use setModel().

Usage example:

 Wt::WSelectionBox *selectionBox = new Wt::WSelectionBox(this);
 selectionBox->addItem("Clint Eastwood");
 selectionBox->addItem("Mick Jagger");
 selectionBox->addItem("Johnny Depp");
 selectionBox->addItem("Kate Winslet");

 selectionBox->setCurrentIndex(2); // Johnny Depp
 selectionBox->activated().connect(SLOT(this, MyWidget::comboChanged));

WSelectionBox is an inline widget.

CSS

The widget corresponds to the HTML <select> tag and does not provide styling. It can be styled using inline or external CSS as appropriate.


Member Function Documentation

int Wt::WSelectionBox::verticalSize (  )  const [inline]

Sets the number of items that are visible.

If more items are available, a scroll-bar is provided.

void Wt::WSelectionBox::setSelectionMode ( SelectionMode  mode  ) 

Sets the selection mode.

The default selection mode is SingleSelection. You can change to Wt::ExtendedSelection to allow selection of multiple items.

SelectionMode Wt::WSelectionBox::selectionMode (  )  const [inline]

Returns the selection mode.

See also:
setSelectionMode(SelectionMode)

const std::set<int>& Wt::WSelectionBox::selectedIndexes (  )  const [inline]

Returns the current selection (in Wt::ExtendedSelection mode).

Get the list of currently selected items. This method is only defined when selectionMode() is Wt::ExtendedSelection. Otherwise, you should use currentIndex() to get item currently selected.

See also:
currentIndex()

void Wt::WSelectionBox::setSelectedIndexes ( const std::set< int > &  selection  ) 

Sets the selection (in Wt::ExtendedSelection mode).

For an Wt::ExtendedSelection mode, set the list of currently selected items.

See also:
selectedIndexes()

void Wt::WSelectionBox::clearSelection (  ) 

Clears the current selection.

Clears the current selection.

See also:
setCurrentIndex(), setSelectedIndexes()


Generated on Fri Mar 26 17:12:07 2010 for Wt by doxygen 1.5.6