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.v23.2.dll
NuGet Package: DevExpress.Web
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>
...