ColumnView.IsNewItemRow(Int32) Method

Indicates whether the specified row/card is the New Item Row/Card.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v20.1.dll

Declaration

public bool IsNewItemRow(
    int rowHandle
)
Public Function IsNewItemRow(
    rowHandle As Integer
) As Boolean

Parameters

Name Type Description
rowHandle Int32

The handle of the inspected row/card.

Returns

Type Description
Boolean

true if the specified row/card is used to enter a new record; otherwise, false.

Remarks

The new item row is used to enter a new record within a View. The handle of the new item row is identified by the static GridControl.NewItemRowHandle field. For more information on row handles, refer to the Rows document.

For Grid Views, the new item row can be displayed by setting the GridOptionsView.NewItemRowPosition option to NewItemRowPosition.Top or NewItemRowPosition.Bottom.

If the new item row is hidden within a Grid View or Card View this row will be displayed when the ColumnView.AddNewRow method is called or the "+" button within the data navigator is clicked.

NOTE

Detail pattern Views do not contain data and they are never displayed within XtraGrid. So, the IsNewItemRow member must not be invoked for these Views. The IsNewItemRow member can only be used with real Views that are displayed within the Grid Control. The real Views with which an end-user interacts at runtime can be accessed using the following methods.

See Also