.. _pages/widget/combobox#combobox:

ComboBox
********
A ComboBox widget is used to select items from a list or allow customer input. The items in a ComboBox supports plain text and/or icons.  

.. _pages/widget/combobox#preview_image:

Preview Image
-------------

|ComboBox|

.. |ComboBox| image:: /pages/widget/combobox.png

.. _pages/widget/combobox#features:

Features
--------
* Mouse and keyboard support.
* Items with plain text and/or icons
* Ellipsis: If the label does not fit into the widget bounds an ellipsis (”...”) is rendered at the end of the label.

.. _pages/widget/combobox#description:

Description
-----------
A ComboBox is like a :doc:`textfield`  with a drop down of predefined values. The main difference to the :doc:`selectbox` is that the user can enter individual values or choose from the predefined ones. The items in the predefined list supports plain text and/or icons. The items which can be added to the list are ``qx.ui.form.ListItem`` items. 

Please note that the ComboBox supports no auto-	completion.

.. _pages/widget/combobox#demos:

Demos
-----
Here are some links that demonstrate the usage of the widget:

* `ComboBox demo <http://demo.qooxdoo.org/%{version}/demobrowser/#widget~ComboBox.html>`_
* `Form demo <http://demo.qooxdoo.org/%{version}/demobrowser/#showcase~Form.html>`_

.. _pages/widget/combobox#api:

API
---
| Here is a link to the API of the Widget:
| `qx.ui.form.ComboBox <http://demo.qooxdoo.org/%{version}/apiviewer/#qx.ui.form.ComboBox>`_