Columns
RadMultiColumnComboBox is a dropdown that provides easy columns setup for its dropdown. You can define columns in the ColumnsCollection.
You can set which Field from the dataItem should be populated, set a Title, template, headerTemplate and Width.
Here is how the width of the columns and the dropdown behaves:
- If all columns'
Widthis defined in pixels, theDropDownWidthvalue (if set) is disregarded. - If not all of the columns
Widthvalue set, theDropDownWidthvalue is applied to the element. - You can set the
Widthonly of some columns and the rest will distribute the remaining width from theDropDownWidth. This means you can also set column widths in percent from theDropDownWidth.
You can also control the overall dropdown settings through the DropDownWidth and Height properties in the main RadMultiColumnComboBox tag. The inner AnimationSettings and PopupSettings expose additional settings.
Example 1: Columns in RadMultiColumnComboBox
<telerik:RadMultiColumnComboBox ID="RadMultiColumnComboBox4" runat="server" Skin="Default"
DataTextField="ContactName" DataValueField="CustomerID"
DropDownWidth="500" Height="400" Width="100%">
<ColumnsCollection>
<telerik:MultiColumnComboBoxColumn Field="CustomerID" Title="ID" />
<telerik:MultiColumnComboBoxColumn Field="ContactName" Title="Name" />
</ColumnsCollection>
<WebServiceSettings Select-ContentType="JSON" ServiceType="OData"
Select-Url="https://demos.telerik.com/kendo-ui/service/Northwind.svc/Customers">
</WebServiceSettings>
</telerik:RadMultiColumnComboBox>
You can also use the templates and all other functionality of the columns regardless of the data binding scenario, including with local data.
Example 2: Columns with local data and not having all widths set
<telerik:RadMultiColumnComboBox ID="RadMultiColumnComboBox4" runat="server" Skin="Default"
DataTextField="name" DataValueField="id"
Filter="Contains" FilterFields="name, color"
DropDownWidth="400" Height="400" Width="300px">
<ColumnsCollection>
<telerik:MultiColumnComboBoxColumn Field="id" Title="ID" Width="40px" />
<telerik:MultiColumnComboBoxColumn Field="name" Title="Name" />
<telerik:MultiColumnComboBoxColumn Field="color" Title="color" Width="100px">
<Template><span style="color: #=data.color#">#:data.color#</span></Template>
</telerik:MultiColumnComboBoxColumn>
</ColumnsCollection>
<ClientEvents OnLoad="OnLoad" />
</telerik:RadMultiColumnComboBox>
<script>
function OnLoad(sender, args) {
var data = [
{ id: 1, name: "one", color: "red" },
{ id: 2, name: "two", color: "green" },
{ id: 3, name: "three", color: "blue" }
];
sender.set_dataSource(data);
}
</script>