# UserComboBox

The UserComboBox control allows the creation of a custom template to use as the dropdown portion of the ComboBox.

{% 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.usercombobox).
{% endhint %}

## Features

### Custom Controls

The **DropDownControl** property of the UserComboBox control specifies which control to use as a template for the drop down panel of the combo box.

<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-954ced164bcce9e49759cf55a5b66219aba4052c%2Fimage.png?alt=media" alt=""></div>

### Label

The UserComboBox 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 UserComboBox 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). |
| Source code      | [https://github.com/iceteagroup/wisej-js](https://github.com/iceteagroup/wisej-js/blob/master/wisej.web.TextBox.js)                                                                                                                                                                                                                                                                |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wisej.com/docs/controls/lists/combobox/usercombobox.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.