# 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.                                       |

> note 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](https://msdn.microsoft.com/en-us/library/system.windows.forms.currencymanager\(v=vs.110\).aspx) 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**.

> caption Figure 1: Model With Attributes

![WinForms RadDataLayout Model With Attributes](https://www.telerik.com/products/winforms/documentation/assets/6941ba1e4ea3c5529026b97c5521caa6/datalayout-properties-event-and-attributes001.png)

### 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](https://www.telerik.com/products/winforms/documentation/controls/datalayout/structure)
* [Getting Started](https://www.telerik.com/products/winforms/documentation/controls/datalayout/getting-started)
* [Validation](https://www.telerik.com/products/winforms/documentation/controls/datalayout/validation)
* [Localization](https://www.telerik.com/products/winforms/documentation/controls/datalayout/localization)
* [Change the editor to RadDropDownList](https://www.telerik.com/products/winforms/documentation/controls/dataentry/how-to/change-the-editor-to-a-bound-raddropdownlist)
* [Customizing Appearance ](https://www.telerik.com/products/winforms/documentation/controls/datalayout/customizing-appearance/customizing-appearance)