# FormDropDownListInsert Method

> Inserts a dropdown list form field at the input position with TAB-separated items, a selected index (-1 for none), a dropdown arrow and an empty width.

- **Product:** TX Text Control ActiveX
- **Section:** Documentation
- **Kind:** Method
- **Path:** TX Text Control ActiveX > API Reference > TXTextControl > FormDropDownListInsert Method
- **459 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formdropdownlistinsert-method/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formdropdownlistinsert-method/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formdropdownlistinsert-method/llms-full.txt

---

This method inserts a dropdown list into the document at the current text input position. It has the specified items, the SelectedIndex parameter determines which item is selected. The text field cannot be edited through the end-user.

Introduced: 28.0.

### Syntax

```vbscript
TXTextControl.FormDropDownListInsert Items, SelectedIndex, ShowDropDownArrow [, EmptyWidth]
```

### Parameters

| Parameter | Description |
|---|---|
| Items | Specifies the dropdown list's items. The items must be separated with 09 (TAB) control characters. |
| SelectedIndex | Specifies the zero-based index of the item which is currently selected. If this parameter is -1, no item is selected. |
| ShowDropDownArrow | Specifies whether the dropdown arrow is immediately shown after insertion. |
| EmptyWidth | Optional. Specifies the width of the dropdown list, in [twips](https://docs.textcontrol.com/tx-text-control-activex/document-editor/viewing/#measure-in-twips), when there is no item selected. If this parameter is omitted, a default width of 2000 twips is used. |

### Return Value

The method returns True if the dropdown list could be inserted, otherwise it returns False.

### Data Types

| Name | Data type |
|---|---|
| Items | String |
| SelectedIndex | Integer |
| ShowDropDownArrow | Boolean |
| EmptyWidth | Integer |
| Return value | Boolean |

### Remarks

Inserting a form field changes the value of the [FieldCurrent](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/fieldcurrent-property/llms-full.txt) property to the identifier of the newly created field.

### See Also

- [FormCheckBoxInsert Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formcheckboxinsert-method/llms-full.txt)
- [FormComboBoxInsert Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formcomboboxinsert-method/llms-full.txt)
- [FormDateFieldInsert Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formdatefieldinsert-method/llms-full.txt)
- [FormTextFieldInsert Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formtextfieldinsert-method/llms-full.txt)
- [Programming Category: Form Fields](https://docs.textcontrol.com/tx-text-control-activex/reference/categories/form-fields/llms-full.txt)

---

## Nearby

- **Previous:** [FormDateFieldInsert Method](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formdatefieldinsert-method/llms-full.txt)
- **Next:** [FormFieldCheckedChar Property](https://docs.textcontrol.com/tx-text-control-activex/reference/txtextcontrol/formfieldcheckedchar-property/llms-full.txt)