FormComboBoxInsert Method
This method inserts a combobox into the document at the current text input position. It has the specified items and the specified text.
Introduced: 28.0.
Syntax
TXTextControl.FormComboBoxInsert FieldText, Items, ShowDropDownArrow [, EmptyWidth]
Parameters
| Parameter | Description |
|---|---|
| FieldText | Specifies the text contents in the edit field of the combobox. |
| Items | Specifies the combobox's items. The items must be separated with 09 (TAB) control characters. |
| ShowDropDownArrow | Specifies whether the combobox's dropdown arrow is immediately shown after insertion. |
| EmptyWidth | Optional. Specifies the combobox's width, in twips, when its edit field is empty. If this parameter is omitted, a default width of 2000 twips is used. |
Return Value
The method returns True if the combobox could be inserted, otherwise it returns False.
Data Types
| Name | Data type |
|---|---|
| FieldText | String |
| Items | String |
| ShowDropDownArrow | Boolean |
| EmptyWidth | Integer |
| Return value | Boolean |
Remarks
Inserting a form field changes the value of the FieldCurrent property to the identifier of the newly created field.