ColumnView.InitNewRow Event

Enables you to initialize added rows.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v19.2.dll

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

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the InitNewRow event.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-implement-simple-copy-paste-operations-in-the-gridview-from-a-toolbar-menu-e4528/CS/DXGridCRUDoperations/Main.cs#L41

    gridView1.OptionsClipboard.PasteMode = DevExpress.Export.PasteMode.Update;
    gridView1.InitNewRow += new DevExpress.XtraGrid.Views.Grid.InitNewRowEventHandler(gridView1_InitNewRow);
}

VB.NET

how-to-implement-simple-copy-paste-operations-in-the-gridview-from-a-toolbar-menu-e4528/VB/DXGridCRUDoperations/Main.vb#L39

    gridView1.OptionsClipboard.PasteMode = DevExpress.Export.PasteMode.Update
    AddHandler gridView1.InitNewRow, AddressOf gridView1_InitNewRow
End Sub