Change auto generated editor

Updated over 6 months ago

By default RadDataEntry generates several different editors according to the data type of the property that it should edit. The following table demonstrates the default editors that RadDataEntry can create.

enum	RadDropDownList
DateTime	RadDateTimePicker
Boolean	RadCheckBox
Color	RadColorBox
Image	PictureBox
string	RadTextBox
Byte, SByte, UInt16, UInt32, UInt64, Int16, Int32, Int64, Single, Double, Decimal	RadSpinEditor

For any type that is not represented in this table RadDataEntry generates RadTextBox .

In the following example it will be demonstrated how to change default editor with the custom one.

1. For the purpose of this tutorial, we will create a new class Employee with a couple of exposed properties. By binding RadDataEntry to object from this type we will generate several items.

Data Object

C#

private class Employee
{
    public string FirstName
    {
        get;
        set;
    }
    public string LastName
    {
        get;
        set;
    }
    public string Occupation
    {
        get;
        set;
    }
    public DateTime StartingDate
    {
        get;
        set;
    }
    public bool IsMarried
    {
        get;
        set;
    }
    public int Salary
    {
        get;
        set;
    }
    public Gender Gender
    {
        get;
        set;
    }
}
private enum Gender
{
    Female,
    Male
}

VB.NET

Private Class Employee
    Public Property FirstName() As String
        Get
            Return m_FirstName
        End Get
        Set(value As String)
            m_FirstName = Value
        End Set
    End Property
    Private m_FirstName As String
    Public Property LastName() As String
        Get
            Return m_LastName
        End Get
        Set(value As String)
            m_LastName = Value
        End Set
    End Property
    Private m_LastName As String
    Public Property Occupation() As String
        Get
            Return m_Occupation
        End Get
        Set(value As String)
            m_Occupation = Value
        End Set
    End Property
    Private m_Occupation As String
    Public Property StartingDate() As DateTime
        Get
            Return m_StartingDate
        End Get
        Set(value As DateTime)
            m_StartingDate = Value
        End Set
    End Property
    Private m_StartingDate As DateTime
    Public Property IsMarried() As Boolean
        Get
            Return m_IsMarried
        End Get
        Set(value As Boolean)
            m_IsMarried = Value
        End Set
    End Property
    Private m_IsMarried As Boolean
    Public Property Salary() As Integer
        Get
            Return m_Salary
        End Get
        Set(value As Integer)
            m_Salary = Value
        End Set
    End Property
    Private m_Salary As Integer
    Public Property Gender() As Gender
        Get
            Return m_Gender
        End Get
        Set(value As Gender)
            m_Gender = Value
        End Set
    End Property
    Private m_Gender As Gender
End Class
Private Enum Gender
    Female
    Male
End Enum

Data Binding

C#

this.radDataEntry1.DataSource = new Employee() 
{ 
    FirstName = "Sarah",
    LastName = "Blake",
    Occupation = "Supplied Manager", 
    StartingDate = new DateTime(2005, 04, 12),
    IsMarried = true, 
    Salary = 3500, Gender = Gender.Female 
};

VB.NET

Me.radDataEntry1.DataSource = New Employee() With { _
  .FirstName = "Sarah", _
  .LastName = "Blake", _
  .Occupation = "Supplied Manager", _
  .StartingDate = New DateTime(2005, 4, 12), _
  .IsMarried = True, _
  .Salary = 3500, _
  .Gender = Gender.Female _
 }

Figure 1: RadDataEntry Initializing.

2. To change the default RadTextBox editor of the “Salary” property with RadMaskedEditBox we will subscribe to EditorInitializing event of RadDataEntry.

C#

void radDataEntry1_EditorInitializing(object sender, Telerik.WinControls.UI.EditorInitializingEventArgs e)
{
    if (e.Property.Name == "Salary")
    {
        RadMaskedEditBox radMaskedEditBox = new RadMaskedEditBox();
        radMaskedEditBox.MaskType = MaskType.Numeric;
        radMaskedEditBox.MaskedEditBoxElement.StretchVertically = true;
        e.Editor = radMaskedEditBox;
    }
}

VB.NET

Private Sub radDataEntry1_EditorInitializing(sender As Object, e As Telerik.WinControls.UI.EditorInitializingEventArgs)
    If e.[Property].Name = "Salary" Then
        Dim radMaskedEditBox As New RadMaskedEditBox()
        radMaskedEditBox.MaskType = MaskType.Numeric
        radMaskedEditBox.MaskedEditBoxElement.StretchVertically = True
        e.Editor = radMaskedEditBox
    End If
End Sub

3. To achieve working binding for this new editor we should subscribe to the BindingCreated event where we will subscribe to the Parse event of the Binding object. You can read more about Format and Parse events of Binding object and why we should use them here.

Subscribe to Parse Event

C#

void radDataEntry1_BindingCreated(object sender, BindingCreatedEventArgs e)
{
    if (e.DataMember == "Salary")
    {
        e.Binding.Parse += new ConvertEventHandler(Binding_Parse);
    }
}
void Binding_Parse(object sender, ConvertEventArgs e)
{
    int salary = int.Parse(e.Value.ToString(), NumberStyles.Currency);
    e.Value = salary;
}

VB.NET

Private Sub radDataEntry1_BindingCreated(sender As Object, e As BindingCreatedEventArgs)
    If e.DataMember = "Salary" Then
        AddHandler e.Binding.Parse, AddressOf Binding_Parse
    End If
End Sub
Private Sub Binding_Parse(sender As Object, e As ConvertEventArgs)
    Dim salary As Integer = Integer.Parse(e.Value.ToString(), NumberStyles.Currency)
    e.Value = salary
End Sub

Figure 2: RadDataEntry MaskedEditBox.

RadSpinEditor Default Values

The spin editor is created with the default settings for Minimum/Maximum, DecimalPlaces, and Step. If a case, you are using fractional numbers, the decimal part will be lost so we need to change the above properties. You can do that in the EditorInitializing.

C#

void radDataEntry_EditorInitializing(object sender, EditorInitializingEventArgs e)
{
  var spinEditor = e.Editor as RadSpinEditor;

  if (spinEditor == null)
    return;

  spinEditor.Step = 0.01m;
  spinEditor.DecimalPlaces = 2;
  spinEditor.Maximum = Decimal.MaxValue;
}

VB.NET

Private Sub radDataEntry_EditorInitializing(ByVal sender As Object, ByVal e As EditorInitializingEventArgs)
    Dim spinEditor = TryCast(e.Editor, RadSpinEditor)
    If spinEditor Is Nothing Then Return
    spinEditor.[Step] = 0.01D
    spinEditor.DecimalPlaces = 2
    spinEditor.Maximum = Decimal.MaxValue
End Sub

See Also

• Structure
• Getting Started
• Properties, events and attributes
• Themes
• Change the editor to RadDropDownList
• How to Use RadSpinEditor for Nullable Numeric Fields in RadDataEntry