New to Telerik UI for WinForms? Download free 30-day trial

Properties, Events and Attributes

RadDataLayout exposes properties and events which are similar to the ones provided by the RadDataEntry control.

Properties

Property Description
DataSource Through this property user can set the business object or a collection of objects that should be edited. When this property is set RadDataLayout generates editors for each public property which does not have its Browsable attribute set to false.
ColumnCount Controls the amount of columns that RadDataLayout will use to arrange the generated controls. Default value is one.
FlowDirection Defines the direction the editors will be generated.
ItemDefaultHeight Sets the height that generated items should have, the default value is 26.
AutoSizeLabels By default, the property value is false and the labels width will equals the longest label width. If you set this property to true, the labels will be sized according to their content.
ShowValidationPanel Gets or sets a value indicating whether the validation panel should appear.
ItemDefaultHeight Sets the height that generated items should have.

Events

There are several events that you will find useful in the context of RadDataLayout:

Event Description
EditorInitializing Occurs when editor is being initialized. In this event you can change the default editors with custom ones.
EditorInitialized Raised when the editor is initialized.
BindingCreating Occurs when a binding object for an editor is about to be created. This event is cancelable.
BindingCreated Occurs when binding object is created.
ItemInitializing This event is fired when the panel that contains the label, editor and validation label is about to be initialized. This event is cancelable.
ItemInitialized Fires when the item is already initialized.
ItemValidating This event is raised when any of the generated editors fires its Validating event.
ItemValidated Occurs when any of the generated editors fires its Validated event.

Attributes

RadDataLayout has support for several attributes that can be used to change the behavior of the control.

Attribute Description
Browsable Defines which properties should be displayed.
DisplayName Determines what text should be displayed in the label that is associated with the editor.
RadRangeAttribute Defines a range that can be used into validation process. This attribute is provided in validation events.
__ReadOnlyAttribute __ Determines whether a property can be edited in RadDataLayout or not.

The Browsable attribute set to false will make the property on which it is used not bindable. This will prevent other controls which use the CurrencyManager object for extracting properties to bind to such a class. A suitable solution for this scenario is to leave the property Browsable set to true and handle the RadDataLayout.ItemInitializing setting the e.Cancel property to true for items which need to hidden in RadDataLayout.

Figure 1: Model With Attributes

WinForms RadDataLayout Model With Attributes

Using attributes.

public class Employee
{
    public string FirstName { get; set; }
    [DisplayName("Family Name")]
    public string LastName { get; set; }
    [Browsable(false)]
    public string Occupation { get; set; }
    [RadRange(2000, 3000)]
    public int Salary { get; set; }
    public DateTime StartingDate { get; set; }
}

Public 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
    <DisplayName("Family Name")> _
    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
    <Browsable(False)> _
    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
    <RadRange(2000, 3000)> _
    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 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
End Class

See Also

In this article