ColumnView.InitNewRow Event

Enables you to initialize added rows.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v18.1.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

You can handle the InitNewRow event to initialize newly added rows. To initialize row cells call the ColumnView.SetRowCellValue method. Use the event’s RowHandle parameter as the row identifier, required by the ColumnView.SetRowCellValue method.

The InitNewRow event is raised 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 end-users.
• when an end-user starts typing text in the New Item Row.

Note that some values within the new row may be initialized automatically (depending upon the data source). For example, the key field value may already be assigned. Cells that are not initialized automatically will be displayed as empty.

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 snippets (auto-collected from DevExpress Examples) contain references 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.

VB.NET

implement-the-addnewnode-method-in-treelist-like-the-addnewrow-one-in-gridcontrol-e4190/VB/WindowsFormsApplication1/Form1.vb#L25

Private Sub gridView1_InitNewRow(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Grid.InitNewRowEventArgs) Handles gridView1.InitNewRow

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

how-to-automatically-expand-the-detail-view-when-new-master-row-is-added-e1436/VB/Q205071/Form1.vb#L40

Private newRow As Boolean = False
Private Sub OnGridViewInitNewRow(ByVal sender As Object, ByVal e As InitNewRowEventArgs) Handles gridView1.InitNewRow
    newRow = True

how-to-provide-a-new-row-with-initial-values-immediately-after-the-user-activates-a-grid-cell-e1146/VB/WindowsApplication73/Form1.vb#L18

Private Sub gridView1_InitNewRow(ByVal sender As Object, ByVal e As DevExpress.XtraGrid.Views.Grid.InitNewRowEventArgs) Handles gridView1.InitNewRow

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