# TreeViewComboBox

Based upon the UserComboBox, the TreeViewComboBox control allows users to select options from a TreeView 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.treeviewcombobox).
{% endhint %}

## Features

### Label

The TreeViewComboBox 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 TreeViewComboBox 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 %}

### Select on Enter

The TreeViewComboBox control can be customized to specify whether users are allowed to select an item when it's first clicked or if an additional action should be performed such as double-clicking or clicking on the checkbox.

## 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 | "treeview", 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)                                                                                                                                                                                                                                                                |