LookUpEditBase.ItemTemplate Property
Gets or sets a template that defines the presentation of items contained within the dropdown list. This is a dependency property.
Namespace: DevExpress.Xpf.Editors
Assembly: DevExpress.Xpf.Core.v19.2.dll
Declaration
[Browsable(false)]
public DataTemplate ItemTemplate { get; set; }
<Browsable(False)>
Public Property ItemTemplate As DataTemplate
Property Value
Type | Description |
---|---|
DataTemplate | A DataTemplate object that represents the template which defines the presentation of items contained within the dropdown list. |
Remarks
To apply ItemTemplate to the selected item (displayed within the edit box), set the LookUpEditBase.ApplyItemTemplateToSelectedItem property to true.
NOTE
The ItemTemplate property cannot be used if combobox items are represented by the ComboBoxEditItem class.
Examples
The following example shows how to create an image combobox via templates.
NOTE
A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-an-image-combobox-e1970.
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:dxe="http://schemas.devexpress.com/winfx/2008/xaml/editors"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
x:Class="ComboBoxEdit_CreatingImageComboBox.Window1"
xmlns:sys="clr-namespace:System;assembly=mscorlib"
Title="Creating an Image ComboBox"
Height="300" Width="300">
<Grid>
<Grid.ColumnDefinitions>
<ColumnDefinition />
<ColumnDefinition Width="100" />
<ColumnDefinition />
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition />
<RowDefinition Height="22" />
<RowDefinition />
</Grid.RowDefinitions>
<dxe:ComboBoxEdit ApplyItemTemplateToSelectedItem="True" IsTextEditable="False"
Text="(None)" Grid.Row="1" Grid.Column="1" Padding="5,2,5,2">
<dxe:ComboBoxEdit.ItemTemplate>
<DataTemplate>
<Border Background="Transparent">
<StackPanel Orientation="Horizontal">
<Rectangle Width="10" Height="10" Fill="{Binding}"
RadiusX="2" RadiusY="2"
Margin="6,0,6,0" />
<TextBlock Text="{Binding}" />
</StackPanel>
</Border>
</DataTemplate>
</dxe:ComboBoxEdit.ItemTemplate>
<sys:String>Red</sys:String>
<sys:String>Green</sys:String>
<sys:String>Blue</sys:String>
</dxe:ComboBoxEdit>
</Grid>
</Window>