GridControl.NewItemRowHandle Field

Contains a value which represents the handle of the New Item Row/Card. For more information on row handles refer to the Rows section.

Namespace: DevExpress.XtraGrid

Assembly: DevExpress.XtraGrid.v24.1.dll

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

Declaration

C#

public const int NewItemRowHandle = -2147483647

VB.NET

Public Const NewItemRowHandle As Integer = -2147483647

Field Value

Type
Int32

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the NewItemRowHandle field.

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#

winforms-grid-add-new-row-by-typing-in-new-item-row/CS/WindowsApplication3/Main.cs#L35

{
    if(gridView.FocusedRowHandle == GridControl.NewItemRowHandle)
    {

winforms-grid-prevent-focusing-group-row/CS/Form1.cs#L28

int focusedRowHandle = -1;
if (e.FocusedRowHandle == GridControl.NewItemRowHandle || e.FocusedRowHandle == GridControl.AutoFilterRowHandle)
    return;

winforms-grid-crud-operations-odata/CS/DxSample/MainForm.cs#L24

private void GridView_RowUpdated(object sender, RowObjectEventArgs e) {
    if (e.RowHandle == GridControl.NewItemRowHandle)
        this.Context.AddToOrders((Order)e.Row);

winforms-grid-display-icons-in-data-cells/CS/Form1.cs#L243

private void GridView1_CustomDrawCell(object sender, DevExpress.XtraGrid.Views.Base.RowCellCustomDrawEventArgs e) {
    if (e.RowHandle != GridControl.NewItemRowHandle && e.Column.FieldName == "CustomDraw") {
        e.DisplayText = string.Empty;

VB.NET

winforms-grid-add-new-row-by-typing-in-new-item-row/VB/WindowsApplication3/Main.vb#L30

Private Sub OnEditValueChanged(ByVal sender As Object, ByVal e As EventArgs)
    If gridView.FocusedRowHandle = GridControl.NewItemRowHandle Then
        gridView.CloseEditor()

winforms-grid-prevent-focusing-group-row/VB/Form1.vb#L28

Dim focusedRowHandle As Integer = -1
If e.FocusedRowHandle = GridControl.NewItemRowHandle OrElse e.FocusedRowHandle = GridControl.AutoFilterRowHandle Then Return
Dim view As GridView = CType(sender, GridView)

winforms-grid-crud-operations-odata/VB/DxSample/MainForm.vb#L26

Private Sub GridView_RowUpdated(ByVal sender As Object, ByVal e As RowObjectEventArgs) Handles GridView.RowUpdated
    If e.RowHandle = GridControl.NewItemRowHandle Then
        Me.Context.AddToOrders(DirectCast(e.Row, Order))

winforms-grid-display-icons-in-data-cells/VB/Form1.vb#L215

Private Sub GridView1_CustomDrawCell(ByVal sender As Object, ByVal e As Views.Base.RowCellCustomDrawEventArgs)
    If e.RowHandle <> GridControl.NewItemRowHandle AndAlso Equals(e.Column.FieldName, "CustomDraw") Then
        e.DisplayText = String.Empty