# ComboBox Namespace: **Wisej.Web** Assembly: **Wisej.Framework** (4.0.0.0) * [Control](https://docs.wisej.com/api/wisej.web/general/control) * [ListControl](https://docs.wisej.com/api/wisej.web/lists-and-grids/listcontrol) * [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) Represents a combo box control. {% tabs %} {% tab title="C#" %} ```csharp public class ComboBox : ListControl, ILabel, IReadOnly ``` {% endtab %} {% tab title="VB.NET" %} ```visual-basic Public Class ComboBox Inherits ListControl Implements ILabel, IReadOnly ``` {% endtab %} {% endtabs %} ## Constructors ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ComboBox() Initializes an instance of ComboBox. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ComboBox(onSelectedIndexChanged) Initializes a new instance of [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) class with specific initial settings. | Name | Type | Description | | -------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------ | | **onSelectedIndexChanged** | [Action\](https://docs.microsoft.com/dotnet/api/system.action-2) | [SelectedIndexChanged](#selectedindexchanged) handler. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ComboBox(label, onSelectedIndexChanged) Initializes a new instance of [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) class with specific initial settings. | Name | Type | Description | | -------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **label** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The initial text to display in the [TextBox](https://docs.wisej.com/api/wisej.web/editors/wisej.web.textbox) label. | | **onSelectedIndexChanged** | [Action\](https://docs.microsoft.com/dotnet/api/system.action-2) | [SelectedIndexChanged](#selectedindexchanged) handler. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ComboBox(dataSource, displayMember, valueMember, iconMember, onSelectedIndexChanged) Initializes a new instance of [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) class with specific initial settings. | Name | Type | Description | | -------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | **dataSource** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Initial [DataSource](https://docs.wisej.com/api/wisej.web/listcontrol#datasource). | | **displayMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [DisplayMember](https://docs.wisej.com/api/wisej.web/listcontrol#displaymember). | | **valueMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [ValueMember](https://docs.wisej.com/api/wisej.web/listcontrol#valuemember). | | **iconMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [IconMember](https://docs.wisej.com/api/wisej.web/listcontrol#iconmember). | | **onSelectedIndexChanged** | [Action\](https://docs.microsoft.com/dotnet/api/system.action-2) | Optional [SelectedIndexChanged](#selectedindexchanged) handler. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ComboBox(location, size, onSelectedIndexChanged) Initializes an instance of [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) with the given datasource, size, location, and action. | Name | Type | Description | | -------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------- | | **location** | [Point](https://docs.microsoft.com/dotnet/api/system.drawing.point) | Initial location. | | **size** | [Size](https://docs.microsoft.com/dotnet/api/system.drawing.size) | Initial size. | | **onSelectedIndexChanged** | [Action\](https://docs.microsoft.com/dotnet/api/system.action-2) | Optional [SelectedIndexChanged](#selectedindexchanged) handler. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ComboBox(location, size, dataSource, displayMember, valueMember, iconMember, onSelectedIndexChanged) Initializes an instance of [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) with the given datasource, size, location, and action. | Name | Type | Description | | -------------------------- | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | **location** | [Point](https://docs.microsoft.com/dotnet/api/system.drawing.point) | Initial location. | | **size** | [Size](https://docs.microsoft.com/dotnet/api/system.drawing.size) | Initial size. | | **dataSource** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Initial [DataSource](https://docs.wisej.com/api/wisej.web/listcontrol#datasource). | | **displayMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [DisplayMember](https://docs.wisej.com/api/wisej.web/listcontrol#displaymember). | | **valueMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [ValueMember](https://docs.wisej.com/api/wisej.web/listcontrol#valuemember). | | **iconMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [IconMember](https://docs.wisej.com/api/wisej.web/listcontrol#iconmember). | | **onSelectedIndexChanged** | [Action\](https://docs.microsoft.com/dotnet/api/system.action-2) | Optional [SelectedIndexChanged](#selectedindexchanged) handler. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ComboBox(label, location, size, onSelectedIndexChanged) Initializes an instance of [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) with the given datasource, size, location, and action. | Name | Type | Description | | -------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **label** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The initial text to display in the [TextBox](https://docs.wisej.com/api/wisej.web/editors/wisej.web.textbox) label. | | **location** | [Point](https://docs.microsoft.com/dotnet/api/system.drawing.point) | Initial location. | | **size** | [Size](https://docs.microsoft.com/dotnet/api/system.drawing.size) | Initial size. | | **onSelectedIndexChanged** | [Action\](https://docs.microsoft.com/dotnet/api/system.action-2) | Optional [SelectedIndexChanged](#selectedindexchanged) handler. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ComboBox(label, location, size, dataSource, displayMember, valueMember, iconMember, onSelectedIndexChanged) Initializes an instance of [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) with the given datasource, size, location, and action. | Name | Type | Description | | -------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | **label** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The initial text to display in the [TextBox](https://docs.wisej.com/api/wisej.web/editors/wisej.web.textbox) label. | | **location** | [Point](https://docs.microsoft.com/dotnet/api/system.drawing.point) | Initial location. | | **size** | [Size](https://docs.microsoft.com/dotnet/api/system.drawing.size) | Initial size. | | **dataSource** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Initial [DataSource](https://docs.wisej.com/api/wisej.web/listcontrol#datasource). | | **displayMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [DisplayMember](https://docs.wisej.com/api/wisej.web/listcontrol#displaymember). | | **valueMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [ValueMember](https://docs.wisej.com/api/wisej.web/listcontrol#valuemember). | | **iconMember** | [String](https://docs.microsoft.com/dotnet/api/system.string) | Initial [IconMember](https://docs.wisej.com/api/wisej.web/listcontrol#iconmember). | | **onSelectedIndexChanged** | [Action\](https://docs.microsoft.com/dotnet/api/system.action-2) | Optional [SelectedIndexChanged](#selectedindexchanged) handler. | ## Properties ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AllowHtml [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets a value indicating that the control can display html in the Text property. (Default: `False`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AutoCompleteMode [AutoCompleteMode](https://docs.wisej.com/api/wisej.web/enumerations/wisej.web.autocompletemode): Returns or sets how automatic completion works for the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). (Default: `None`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AutoSize [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the height of the control is set automatically. (Default: `True`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) CharacterCasing [CharacterCasing](https://docs.wisej.com/api/wisej.web/editors/wisej.web.charactercasing): Returns or sets whether the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) control modifies the case of characters as they are typed. (Default: `Normal`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) DefaultSize [Size](https://docs.microsoft.com/dotnet/api/system.drawing.size): Returns the default size for the ComboBox control. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DropDownHeight [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns or sets the maximum height in pixels of the drop-down portion of the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). (Default: `400`) **Throws:** * [ArgumentException](https://docs.microsoft.com/dotnet/api/system.argumentexception) The specified value is less than one. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DropDownStyle [ComboBoxStyle](https://docs.wisej.com/api/wisej.web/enumerations/wisej.web.comboboxstyle): Returns or sets the drop down style of the combo box. (Default: `DropDown`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DropDownWidth [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns or sets the maximum width in pixels of the drop-down list of the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). When the value is 0, the drop-down list will grow to fit the largest item. (Default: `0`) **Throws:** * [ArgumentException](https://docs.microsoft.com/dotnet/api/system.argumentexception) The specified value is less than one. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DroppedDown [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the combo box is displaying its drop-down portion. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) EnableNativeContextMenu [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Enables or disables the browser's context menu. (Default: `True`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) IncrementalSelection [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether items are selected incrementally as the user types within a timeout of 1 second. (Default: `True`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ItemHeight [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Gets or sets the height of the list items in the drop-down list. When the value is -1, uses the value set in the theme. (Default: `-1`) **Throws:** * [ArgumentOutOfRangeException](https://docs.microsoft.com/dotnet/api/system.argumentoutofrangeexception) The assigned value is less than -1; or the assigned value is greater than 500. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Items [ObjectCollection](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox/wisej.web.combobox.objectcollection): Returns the collection of the items contained in this [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Label [LabelWrapper](https://docs.wisej.com/api/wisej.web/editors/wisej.web.labelwrapper): Provides a label related to the control. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) LabelText [String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the localizable label associated with this control. (Default: `""`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) LazyLoading [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the items are sent to the client the first time the list is opened and enables the [Load](#load) event. (Default: `False`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) MaxLength [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns or sets the number of characters a user can type into the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). (Default: `0`) **Throws:** * [ArgumentOutOfRangeException](https://docs.microsoft.com/dotnet/api/system.argumentoutofrangeexception) The value is less than 0. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ReadOnly [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the control is read-only. (Default: `False`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectedIndex [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns or sets the index of the currently selected item. **Throws:** * [ArgumentOutOfRangeException](https://docs.microsoft.com/dotnet/api/system.argumentoutofrangeexception) The specified index is less than -1; o the specified index is greater than the number of items in the combo box. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectedItem [Object](https://docs.microsoft.com/dotnet/api/system.object): Returns or sets currently selected item in the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectedText [String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the text that is selected in the editable portion of a [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectionLength [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns or sets the number of characters selected in the editable portion of the combo box. **Throws:** * [ArgumentException](https://docs.microsoft.com/dotnet/api/system.argumentexception) The value was less than zero. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectionStart [Int32](https://docs.microsoft.com/dotnet/api/system.int32): Returns or sets the starting index of text selected in the combo box. **Throws:** * [ArgumentException](https://docs.microsoft.com/dotnet/api/system.argumentexception) The value is less than zero. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Sorted [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the items in the combo box are sorted. (Default: `False`) **Throws:** * [ArgumentException](https://docs.microsoft.com/dotnet/api/system.argumentexception) An attempt was made to sort a [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) that is attached to a data source. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SpellCheck [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean): Returns or sets whether the text in the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) is spell checked by the browser. (Default: `False`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Text [String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the text associated with this control. (Default: `""`) ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Tools [ComponentToolCollection](https://docs.wisej.com/api/wisej.web/editors/wisej.web.componenttoolcollection): Returns the instance of [ComponentToolCollection](https://docs.wisej.com/api/wisej.web/editors/wisej.web.componenttoolcollection) associated with this control. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Watermark [String](https://docs.microsoft.com/dotnet/api/system.string): Returns or sets the text to show when the control is empty. (Default: `null`) ## Methods ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) BeginUpdate() Not used. Kept for compatibility. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Copy() Copies the current selection in the text box to the Clipboard. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) CreateItemCollection() Creates a new instance of the item collection. **Returns:** [ObjectCollection](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox/wisej.web.combobox.objectcollection). A [ObjectCollection](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox/wisej.web.combobox.objectcollection) that represents the new item collection. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Cut() Moves the current selection in the text box to the Clipboard. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) Dispose(disposing) Disposes the control. | Parameter | Type | Description | | ------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------- | | **disposing** | [Boolean](https://docs.microsoft.com/dotnet/api/system.boolean) | true when this method is called by the application rather than a finalizer. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) EndUpdate() Not used. Kept for compatibility. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) FindString(text) Returns the index of the first item in the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) that starts with the specified string. | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------- | | **text** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The [String](https://docs.microsoft.com/dotnet/api/system.string) to search for. | **Returns:** [Int32](https://docs.microsoft.com/dotnet/api/system.int32). The zero-based index of the first item found; returns -1 if no match is found. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) FindString(text, startIndex) Returns the index of the first item in the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) beyond the specified index that starts with the specified string. The search is not case sensitive. | Parameter | Type | Description | | -------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | **text** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The [String](https://docs.microsoft.com/dotnet/api/system.string) to search for. | | **startIndex** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The zero-based index of the item before the first item to be searched. Set to -1 to search from the beginning of the control. | **Returns:** [Int32](https://docs.microsoft.com/dotnet/api/system.int32). The zero-based index of the first item found; returns -1 if no match is found, or 0 if the *text* parameter specifies [Empty](https://docs.microsoft.com/dotnet/api/system.string.empty). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) FindStringExact(text) Finds the first item in the combo box that matches the specified string. | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | -------------------------------------------------------------------------------- | | **text** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The [String](https://docs.microsoft.com/dotnet/api/system.string) to search for. | **Returns:** [Int32](https://docs.microsoft.com/dotnet/api/system.int32). The zero-based index of the first item found; returns -1 if no match is found, or 0 if the *text* parameter specifies [Empty](https://docs.microsoft.com/dotnet/api/system.string.empty). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) FindStringExact(text, startIndex) Finds the first item after the specified index that matches the specified string. | Parameter | Type | Description | | -------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | **text** | [String](https://docs.microsoft.com/dotnet/api/system.string) | The [String](https://docs.microsoft.com/dotnet/api/system.string) to search for. | | **startIndex** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The zero-based index of the item before the first item to be searched. Set to -1 to search from the beginning of the control. | **Returns:** [Int32](https://docs.microsoft.com/dotnet/api/system.int32). The zero-based index of the first item found; returns -1 if no match is found, or 0 if the *text* parameter specifies [Empty](https://docs.microsoft.com/dotnet/api/system.string.empty). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnAutoComplete(e) Fires the [AutoComplete](#autocomplete) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | | **e** | [HandledEventArgs](https://docs.microsoft.com/dotnet/api/system.componentmodel.handledeventargs) | A [HandledEventArgs](https://docs.microsoft.com/dotnet/api/system.componentmodel.handledeventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnDataSourceChanged(e) Fires the [DataSourceChanged](https://docs.wisej.com/api/wisej.web/listcontrol#datasourcechanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnDisplayMemberChanged(e) Fires the [DisplayMemberChanged](https://docs.wisej.com/api/wisej.web/listcontrol#displaymemberchanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnDropDown(e) Fires the [DropDown](#dropdown) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnDropDownClosed(e) Fires the [DropDownClosed](#dropdownclosed) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnDropDownStyleChanged(e) Fires the [DropDownStyleChanged](#dropdownstylechanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnLoad(e) Fires the [Load](#load) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnReadOnlyChanged(e) Fires the [ReadOnlyChanged](#readonlychanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | An [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnSelectedIndexChanged(e) Fires the [SelectedIndexChanged](#selectedindexchanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnSelectedItemChanged(e) Fires the [SelectedItemChanged](#selecteditemchanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnSelectionChangeCommitted(e) Fires the [SelectionChangeCommitted](#selectionchangecommitted) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnSortedChanged(e) Fires the [SortedChanged](#sortedchanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnToolClick(e) Fires the ToolClick event. | Parameter | Type | Description | | --------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | **e** | [ToolClickEventArgs](https://docs.wisej.com/api/wisej.web/editors/wisej.web.toolclickeventargs) | A [ToolClickEventArgs](https://docs.wisej.com/api/wisej.web/editors/wisej.web.toolclickeventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnValidating(e) Fires the [Validating](https://docs.wisej.com/api/general/control#validating) event. | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [CancelEventArgs](https://docs.microsoft.com/dotnet/api/system.componentmodel.canceleventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnValueMemberChanged(e) Fires the [ValueMemberChanged](https://docs.wisej.com/api/wisej.web/listcontrol#valuememberchanged) event. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | **e** | [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) | A [EventArgs](https://docs.microsoft.com/dotnet/api/system.eventargs) that contains the event data. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnWebEvent(e) Processes the event from the client. | Parameter | Type | Description | | --------- | ------------------------------------------------------------------------------ | ---------------- | | **e** | [WisejEventArgs](https://docs.wisej.com/api/wisej.core/general/wisejeventargs) | Event arguments. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnWebRender(config) Renders the client component. | Parameter | Type | Description | | ---------- | ------------------------------------------------------------- | ----------------------------- | | **config** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Dynamic configuration object. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) OnWebUpdate(state) Updates the client component using the state information. | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | --------------------- | | **state** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | Dynamic state object. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Paste() Replaces the current selection in the text box with the contents of the Clipboard. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) RefreshItem(index) Refreshes the item contained at the specified location. | Parameter | Type | Description | | --------- | ----------------------------------------------------------- | ------------------------------------ | | **index** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The location of the item to refresh. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) RefreshItems() Reloads all the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) items from the data source. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Select(start, length) Selects a range of text in the editable portion of the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). | Parameter | Type | Description | | ---------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------- | | **start** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The position of the first character in the current text selection within the text box. | | **length** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The number of characters to select. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectAll() Selects all the text in the editable portion of the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) SetBoundsCore(x, y, width, height, specified) Sets the specified bounds of the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) control. | Parameter | Type | Description | | ------------- | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | **x** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The new [Left](https://docs.wisej.com/api/general/control#left) property value of the control. | | **y** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The new [Top](https://docs.wisej.com/api/general/control#top) property value of the control. | | **width** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The new [Width](https://docs.wisej.com/api/general/control#width) property value of the control. | | **height** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | Not used. | | **specified** | [BoundsSpecified](https://docs.wisej.com/api/wisej.web/enumerations/wisej.web.boundsspecified) | A combination of the [BoundsSpecified](https://docs.wisej.com/api/wisej.web/enumerations/wisej.web.boundsspecified) values. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) SetItemCore(index, value) Sets the object with the specified index in the derived class. | Parameter | Type | Description | | --------- | ------------------------------------------------------------- | ------------------------------ | | **index** | [Int32](https://docs.microsoft.com/dotnet/api/system.int32) | The array index of the object. | | **value** | [Object](https://docs.microsoft.com/dotnet/api/system.object) | The object. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) SetItemsCore(value) Sets the specified array of objects in a collection in the derived class. | Parameter | Type | Description | | --------- | ----------------------------------------------------------------------- | ------------------ | | **value** | [IList](https://docs.microsoft.com/dotnet/api/system.collections.ilist) | An array of items. | ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-9bf7fa01e02f4da0f9ef90d3b049ae43e664919e%2Fprotected.png?alt=media) Sort() Sorts the items in the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). ## Events ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) AutoComplete [HandledEventHandler](https://docs.microsoft.com/dotnet/api/system.componentmodel.handledeventhandler) Fired before the [Validating](https://docs.wisej.com/api/general/control#validating) event when [DropDownStyle](#dropdownstyle) is set to [DropDown](https://docs.wisej.com/api/enumerations/wisej.web.comboboxstyle#fields) or [Simple](https://docs.wisej.com/api/enumerations/wisej.web.comboboxstyle#fields). The application may implement a different way to select the item when the user types a text and the ComboBox is validated. Set e.Handled to true to override the standard behavior. ```csharp this.comboBox1.AutoComplete += (s, e) => { if (this.comboBox1.Text == "T") { this.compoBox1.SelectedIndex = 1; e.Handled = true; } } ``` ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DropDown [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the drop-down portion of a [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) is shown. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DropDownClosed [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the drop-down portion of the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) is no longer visible. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) DropDownStyleChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the [DropDownStyle](#dropdownstyle) property has changed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) Load [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the drop-down list is first opened and the [LazyLoading](#lazyloading) property is true. When [LazyLoading](#lazyloading) is true An application may fill the items at any time prior to the drop-down list being opened, or while processing the [DropDown](#dropdown) or [Load](#load) event. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ReadOnlyChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the value of the [ReadOnly](#readonly) property has changed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectedIndexChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the [SelectedIndex](#selectedindex) property has changed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectedItemChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the [SelectedItem](#selecteditem) property has changed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SelectionChangeCommitted [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the selected item has changed and that change is displayed in the [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox). ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) SortedChanged [EventHandler](https://docs.microsoft.com/dotnet/api/system.eventhandler) Fired when the [Sorted](#sorted) property has changed. ### ![](https://1075938901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2HvlWXJQMV7DxhGzw7Y1%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media) ToolClick [ToolClickEventHandler](https://docs.wisej.com/api/wisej.web/editors/wisej.web.toolclickeventhandler) Fired when a [ComponentTool](https://docs.wisej.com/api/wisej.web/editors/wisej.web.componenttool) is clicked. ## Inherited By | Name | Description | | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [DataGridViewComboBoxEditingControl](https://docs.wisej.com/api/wisej.web/lists-and-grids/datagridview/wisej.web.datagridviewcomboboxeditingcontrol) | Represents a [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) control that can be hosted in a [DataGridViewComboBoxCell](https://docs.wisej.com/api/wisej.web/lists-and-grids/datagridview/wisej.web.datagridviewcomboboxcell). | | [ListViewComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/wisej.web.listviewcombobox) | The TreeViewComboBox control represents a [UserComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/wisej.web.usercombobox) control with a [ListView](https://docs.wisej.com/api/wisej.web/lists-and-grids/listview) as the drop down panel. | | [TreeViewComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/wisej.web.treeviewcombobox) | The TreeViewComboBox control represents a [UserComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/wisej.web.usercombobox) control with a [TreeView](https://docs.wisej.com/api/wisej.web/lists-and-grids/treeview) as the drop down panel. | | [UserComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/wisej.web.usercombobox) | The UserComboBox control represents a [ComboBox](https://docs.wisej.com/api/wisej.web/lists-and-grids/combobox) control with a custom panel that drops down when the user clicks the down arrow. | ## Implements | Name | Description | | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [IUserData](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.iuserdata) | Provides access to the `UserData` and `Tag` properties associated to the component implementing this interface. | | [IBindableComponent](https://docs.wisej.com/api/wisej.web/data-binding/wisej.web.ibindablecomponent) | Bindable components implement this interface. | | [IDropTarget](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.idroptarget) | Controls that support drag & drop operations implement this interface. | | [ILabel](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.ilabel) | Provides access to the [LabelWrapper](https://docs.wisej.com/api/wisej.web/editors/wisej.web.labelwrapper) associated with the controls that implement this interface. | | [IReadOnly](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.ireadonly) | Provides access to the [ReadOnly](https://docs.wisej.com/api/interfaces/wisej.web.ireadonly#readonly) property for coontrols that support the read-only mode. | | [IModified](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.imodified) | Provides access to the [Modified](https://docs.wisej.com/api/interfaces/wisej.web.imodified#modified) property and [ModifiedChanged](https://docs.wisej.com/api/interfaces/wisej.web.imodified#modifiedchanged) event for controls that implement this interface. | | [IValidation](https://docs.wisej.com/api/wisej.web/interfaces/wisej.web.ivalidation) | Provides access to the validation events and properties property for controls that support validation. | | [IWisejComponent](https://docs.wisej.com/api/wisej.core/interfaces/wisej.core.iwisejcomponent) | All wisej components implement this interface. | | [IWisejControl](https://docs.wisej.com/api/wisej.core/interfaces/wisej.core.iwisejcontrol) | All wisej controls derived from the [Control](https://docs.wisej.com/api/wisej.web/general/control) class must implement this interface. | | [IWisejSerializable](https://docs.wisej.com/api/wisej.core/interfaces/wisej.core.iwisejserializable) | Allows an object to serialize itself. |