Properties, Events and Attributes

Updated over 6 months ago

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

Using attributes.

C#

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; }
}

VB.NET

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

• Structure
• Getting Started
• Validation
• Localization
• Change the editor to RadDropDownList
• Customizing Appearance