Converters
Telerik controls provide a set of different built-in IValueConverters which can be used to perform conversion between different types.
To get access to these converters you can add reference to the Telerik.Windows.Controls.dll.
- BooleanToOpacityConverter
- InvertedBooleanToOpacityConverter
- BooleanToVisibilityConverter
- InvertedBooleanToVisibilityConverter
- EnumToVisibilityConverter
- ColorToBrushConverter
- NullToVisibilityConverter
- NumberToVisibilityConverter
- DateTimeTypeConverter
- UppercaseConverter
- BinaryImageConverter
- DoubleToThicknessConverter
- OpacityConverter
- StringToGlyphConverter
- ThicknessToOrientedThicknessConverter
Example 1: Specifying converters in XAML
<FrameworkElement>
<FrameworkElement.Resources>
<telerik:BooleanToOpacityConverter x:Key="BooleanToOpacityConverter"/>
<telerik:InvertedBooleanToOpacityConverter x:Key="InvertedBooleanToOpacityConverter"/>
<telerik:BooleanToVisibilityConverter x:Key="BooleanToVisibilityConverter"/>
<telerik:InvertedBooleanToVisibilityConverter x:Key="InvertedBooleanToVisibilityConverter"/>
<telerik:EnumToVisibilityConverter x:Key="EnumToVisibilityConverter"/>
<telerik:ColorToBrushConverter x:Key="ColorToBrushConverter"/>
<telerik:NullToVisibilityConverter x:Key="NullToVisibilityConverter"/>
<telerik:DateTimeTypeConverter x:Key="DateTimeTypeConverter"/>
<telerik:UppercaseConverter x:Key="UppercaseConverter"/>
<telerik:BinaryImageConverter x:Key="BinaryImageConverter"/>
<telerik:DoubleToThicknessConverter x:Key="DoubleToThicknessConverter"/>
<telerik:OpacityConverter x:Key="OpacityConverter"/>
<telerik:ThicknessToOrientedThicknessConverter x:Key="ThicknessToOrientedThicknessConverter"/>
<telerik:StringToGlyphConverter x:Key="StringToGlyphConverter"/>
</FrameworkElement.Resources>
</FrameworkElement>
BooleanToOpacityConverter
This converter converts Boolean values to 1 or 0 opacity. If the Boolean value is false the converter will return 0 opacity.
InvertedBooleanToOpacityConverter
This converter converts Boolean values to 1 or 0 opacity. If the Boolean value is false the converter will return 1 opacity.
BooleanToVisibilityConverter
This converter converts Boolean values to Visibility enumeration values. If the Boolean value is false the Convert() method will return Visibility.Collapsed.
InvertedBooleanToVisibilityConverter
This converter converts Boolean values to Visibility enumeration values. If the Boolean value is true the Convert() method will return Visibility.Collapsed.
EnumToVisibilityConverter
Converts an Enum value to Visibility enumeration values. If the enum value is one of the values specified in the converter parameter, the Convert() method will return Visibility.Visible, otherwise it will return Visibility.Collapsed. Multiple enum values could be specified in the converter parameter, separated using , or ;.
Example 2: Setting the view model
public class MainViewModel
{
public Gender Gender { get; set; }
}
public enum Gender
{
Female,
Male
}
Example 3: Setting the converter to the Visibility property
<telerik:RadRadioButton Visibility="{Binding MyGender, Converter={StaticResource EnumToVisibilityConverter}, ConverterParameter=Male}"/>
ColorToBrushConverter
This converter converts Color values to Brush values.
NullToVisibilityConverter
This converter converts Null or empty string values to Visibility enumeration values. If the input value is Null or empty string, the converter will return Visibility.Collapsed.
NumberToVisibilityConverter
This converter converts a number (double or integer) value to Visibility enumeration value. If the value is less than or equal to 0, returns Visibility.Collapsed, otherwise returns Visibility.Visible.
DateTimeTypeConverter
The converter converts string to a DateTime format value.
UppercaseConverter
This converter converts all lowcase to uppercase letters.
BinaryImageConverter
The converter converts byte array to System.Windows.Media.Imaging.BitmapImage object.
DoubleToThicknessConverter
The converter converts numeric value to Thickness based on the parameter.
Example 4: Setting the view model
public class MainViewModel
{
public double Thickness { get; set; }
}
Example 5: Setting the converter to the BorderThickness property
<Border Background="Green" BorderThickness="{Binding Thickness,Converter={StaticResource DoubleToThicknessConverter},ConverterParameter=LeftRight}" BorderBrush="Black"/>
OpacityConverter
The converter applies opacity to a Color or Brush value based on the parameter.
Example 6: Setting the view model
public class MainViewModel
{
public MainViewModel()
{
this.Color = Brushes.Red;
}
public SolidColorBrush Color { get; set; }
}
Example 7: Setting the converter to the Background property
<Border Background="{Binding Color, Converter={StaticResource OpacityConverter},ConverterParameter=8}" />
ThicknessToOrientedThicknessConverter
The converter applies Thickness to a property of type Thickness based on the parameter. The parameter expects string value which represents on which side you want to place border (LeftTopRightBottom). You can specify only two sides for example (LeftTop). The parameter is required.
Example 6: Setting the ViewModel
public class MainWindow
{
public MainWindow()
{
InitializeComponent();
this.DataContext = this;
Value = new Thickness(2, 3, 4, 5);
}
public Thickness Value { get; set; }
}
Example 7: Setting the converter to the BorderThickness property
<Border BorderThickness="{Binding Value,Converter={StaticResource ThicknessToOrientedThicknessConverter},ConverterParameter=LeftTop}" BorderBrush="Red" Width="200" Height="200" Background="Bisque"/>
StringToGlyphConverter
The converter accepts a glyph string value (ex: ) and converts it to the corresponding char represantation. The converter is useful when you store the glyph string value in your model and want to data bind it to the UI.
See all available glyphs in the Glyphs Reference Sheet article.
Example 8: Setting the view model
public class MainViewModel
{
public MainViewModel()
{
this.GlyphString = "";
}
public string GlyphString { get; set; }
}
Example 9: Using the StringToGlyphConverter converter
<telerik:RadGlyph Glyph="{Binding GlyphString, Converter={StaticResource StringToGlyphConverter}}" />