GridViewNewRowInfo
Represents a row that enables adding of new rows in RadGridView.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.GridView.dll
Syntax:
public class GridViewNewRowInfo : GridViewSystemRowInfo, IDataItem, IHierarchicalRow, INotifyPropertyChanged, INotifyPropertyChangingEx, IDisposable, IComparable<GridViewSystemRowInfo>Inheritance: objectGridViewRowInfoGridViewSystemRowInfoGridViewNewRowInfo
Implements:
Inherited Members
Constructors
Initializes a new instance of the GridViewNewRowInfo.
public GridViewNewRowInfo(GridViewInfo gridViewInfo)An instance of GridViewInfo which the current row belongs to.
Properties
Gets the allowed states for this new row, which is limited to only the Current state.
public override AllowedGridViewRowInfoStates AllowedStates { get; }The Current state only.
Overrides:
Gets the data-bound object that populated the row. For new rows, this returns the data-bound item of the bound row if one exists, otherwise returns the base implementation.
public override object DataBoundItem { get; }The data-bound object associated with this row, or null if no data binding exists.
Overrides:
Gets the type of the GridRowElement that represents this row in the user interface.
public override Type RowElementType { get; }The Type of GridNewRowElement.
Overrides:
Methods
Cancels the new row addition process and reverts any changes made during the editing session. This method removes any bound row from the data source and resets the new row to its initial state.
public void CancelAddNewRow()Compares this new row with another system row to determine their relative ordering. New rows are positioned after table header rows but before filtering rows.
protected override int CompareToSystemRowInfo(GridViewSystemRowInfo row)The GridViewSystemRowInfo to compare with.
Returns:A value indicating the relative order: 1 if this row should come after the specified row, -1 if this row should come before the specified row, or 0 if they are equivalent.
Overrides:
Completes the process of adding a new row to the grid by validating the data, committing changes to the data source, and raising appropriate events.
public GridViewRowInfo EndAddNewRow()The GridViewRowInfo that was successfully added to the grid, or null if the operation was canceled or failed.
Initializes the new row for user input by setting up default values and preparing the row for editing. This method handles both data-bound and virtual scenarios, creates bound rows when necessary, and raises the DefaultValuesNeeded event to allow setting default values.
public void InitializeNewRow()Called when the edit operation begins on this new row. Initializes the new row for editing by calling InitializeNewRow() to prepare it for user input.
protected override bool OnBeginEdit()True if the edit operation was successfully started; otherwise, false.
Overrides:
Called when the edit operation ends on this new row. Attempts to complete the new row addition by calling EndAddNewRow() to commit the changes to the data source.
protected override bool OnEndEdit()True if the new row was successfully added; otherwise, false.
Overrides:
Called when a property value changes on this new row. Handles special logic for current state changes and row position updates, including cleanup of bound rows when the row loses focus.
protected override void OnPropertyChanged(PropertyChangedEventArgs e)The PropertyChangedEventArgs containing information about the changed property.
Overrides: