Tab

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.v21.1.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>
...
See Also