ComboBoxProperties.DropDownStyle Property
Gets or sets a value that specifies the manner in which end users can change the edit value of the dropdown list editor.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v24.2.dll
Declaration
[DefaultValue(DropDownStyle.DropDownList)]
public DropDownStyle DropDownStyle { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| DropDownStyle | DropDownList | One of the DropDownStyle enumeration values. |
Available values:
| Name | Description |
|---|---|
| DropDown | End users are allowed to change the editor’s edit value by either selecting an item from the dropdown list or entering new values into the edit box. |
| DropDownList | End users are allowed to change the editor’s edit value only by selecting an item from the dropdown list. |
Remarks
Use the DropDownStyle property to control the manner in which the combo box editor allows end users to manipulate its edit value.
The DropDownStyle property can be set to one of the following values.
| Value | Description |
|---|---|
| DropDown | End users can select the editor’s value from the dropdown list or enter new values into the edit box. |
| DropDownList | End users can select the editor’s value from the dropdown list. |
The DropDownStyle property value set to DropDownStyle.DropDown is in effect if the ASPxAutoCompleteBoxBase.DataSecurityMode=DataSecurityMode.Default.
Note
The DropDownStyle property synchronizes its value with the editor’s ASPxComboBox.DropDownStyle property.
Example
The following part of the ASPxComboBox (Multiple Columns) online demo illustrates how to represent the ASPxComboBox list data in several columns.
...
<dxe:ASPxComboBox ID="CmbCustomers" runat="server" Width="170px"
DropDownWidth="550" DropDownStyle="DropDownList"
DataSourceID="dsCustomers" ValueField="CustomerID"
ValueType="System.String" TextFormatString="{0}"
EnableCallbackMode="true" EnableIncrementalFiltering="True" CallbackPageSize="30">
<Columns>
<dxe:ListBoxColumn FieldName="ContactName" Width="130px" />
<dxe:ListBoxColumn FieldName="CompanyName" Width="100%" />
<dxe:ListBoxColumn FieldName="Country" Width="60px" />
<dxe:ListBoxColumn FieldName="Phone" Width="100px" />
</Columns>
</dxe:ASPxComboBox>
...
<asp:AccessDataSource ID="dsCustomers" runat="server" DataFile="~/App_Data/nwind.mdb"
SelectCommand="SELECT [CustomerID], [ContactName], [Phone], [CompanyName],
[Country] FROM [Customers] ORDER BY [ContactName], [CompanyName]">
</asp:AccessDataSource>
...
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the DropDownStyle property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.