# ListViewComboBox

Based upon the UserComboBox, the ListViewComboBox control allows users to select options from a ListView control embedded into the drop down panel of a ComboBox control.

{% hint style="info" %}
For a full list of properties, methods and events see the [API documentation](https://docs.wisej.com/api/wisej.web/lists-and-grids/wisej.web.listviewcombobox).
{% endhint %}

## Features

### Label

The ListViewComboBox control supports the inline [Label ](https://docs.wisej.com/docs/controls/general/labels)property. This allows an application to set a label in relation to a ListViewComboBox control without having to create an additional Label control.

<div align="left"><img src="https://553579532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MF1D11gPs_az3xaKusw%2Fuploads%2Fgit-blob-da8caf672de01a8bb9c62e8800bd74b78b95eb7e%2Fimage.png?alt=media" alt=""></div>

{% content-ref url="../../general/labels" %}
[labels](https://docs.wisej.com/docs/controls/general/labels)
{% endcontent-ref %}

## Advanced

### JavaScript Widget

| Item                | Description                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Class name          | "wisej.web.UserComboBox"                                                                                                                                                                                                                                                                                                                                                           |
| Theme appearance    | "combobox", "listitem" for the items in the drop down, see [Themes](https://docs.wisej.com/theme-builder/theme-elements/elements).                                                                                                                                                                                                                                                 |
| Child components    | "textfield" is the inner \<input> widget, "button" is the drop down button, "list" is the drop down list, "popup" is the container of the drop down list, "labelfield" is the inner content when the ComboBox is not editable, and "icon" is the icon for the selected item when it shows an icon. See [JavaScript](https://docs.wisej.com/docs/concepts/javascript-object-model). |
| ToolContainer state | "listview", see [Embedded Tools](https://docs.wisej.com/docs/controls/general/embedded-tools).                                                                                                                                                                                                                                                                                     |
| Source code         | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)                                                                                                                                                                                                                                                                |