ColumnView.InitNewRow Event

Enables you to initialize added rows.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Grid

Declaration

C#

[DXCategory("Data")]
public event InitNewRowEventHandler InitNewRow

VB.NET

<DXCategory("Data")>
Public Event InitNewRow As InitNewRowEventHandler

Event Data

The InitNewRow event's data class is InitNewRowEventArgs. The following properties provide information specific to this event:

Property	Description
RowHandle	Gets the handle of the added row.

Remarks

The InitNewRow event raises when a new row is added to a View. This occurs in the following cases:

• when the ColumnView.AddNewRow method is called in code;
• when the Append button of the data navigator is clicked by a user.
• when a user starts typing text in the New Item Row.

When this happens, you can handle the InitNewRow event to fill a newly added row (or some of its cells) with initial values. To do that, read the event’s RowHandle value and pass it to the ColumnView.SetRowCellValue method as a parameter (see the example below).

Note that some values within a new row can be automatically initialized by a data source. For example, the key field value may already be assigned.

Note

Do not call the ColumnView.UpdateCurrentRow and ColumnView.CancelUpdateCurrentRow methods from your InitNewRow event handler.

Online Video

WinForms Grid: Initialize New Rows.

Example

The following code shows how to initialize the “PurchaseDate” field of a new row via the ColumnView.InitNewRow event.

C#

using DevExpress.XtraGrid.Views.Grid;

private void gridView1_InitNewRow(object sender, InitNewRowEventArgs e) {
   GridView view = sender as GridView;
   view.SetRowCellValue(e.RowHandle, view.Columns["PurchaseDate"], DateTime.Today);
}

VB.NET

Imports DevExpress.XtraGrid.Views.Grid

Private Sub GridView1_InitNewRow(ByVal sender As Object, _
ByVal e As InitNewRowEventArgs) Handles GridView1.InitNewRow
    Dim view As GridView = CType(sender, GridView)
    view.SetRowCellValue(e.RowHandle, view.Columns("PurchaseDate"), DateTime.Today)
End Sub