New to Telerik UI for WinFormsStart a free 30-day trial

This class contains logical information about a row of tabular data which is presented in the RadGridView.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.GridView.dll

Syntax:

C#
[TypeConverter(typeof(ExpandableObjectConverter))]
public abstract class GridViewRowInfo : IDataItem, IHierarchicalRow, INotifyPropertyChanged, INotifyPropertyChangingEx, IDisposable

Inheritance: objectGridViewRowInfo

Derived Classes: GridViewDataRowInfoGridViewDetailsRowInfoGridViewGroupRowInfoGridViewSystemRowInfo

Implements: IDataItemIDisposableIHierarchicalRowINotifyPropertyChangedINotifyPropertyChangingEx

Constructors

Initializes a new instance of the GridViewRowInfo.

C#
public GridViewRowInfo(GridViewInfo viewInfo)
Parameters:viewInfoGridViewInfo

An instance of GridViewInfo which the current row belongs to.

Fields

C#
protected const int AllowResizeState = 64
C#
protected const int IsAttachedState = 1
C#
protected const int IsCurrentState = 4
C#
protected const int IsExpandedState = 16
C#
protected const int IsInitializedState = 256
C#
protected const int IsModifiedState = 2
C#
protected const int IsSelectedState = 8
C#
protected const int IsVisibleState = 32
C#
protected const int LastRowInfoState = 256
C#
protected BitVector32 state
C#
protected const int SuspendNotificationsState = 128

Properties

Gets the allowed states that this row can be in, determining what operations are permitted.

C#
public virtual AllowedGridViewRowInfoStates AllowedStates { get; }

Gets or sets a value indicating whether the user can resize this row by dragging its border.

C#
public virtual bool AllowResize { get; set; }

Gets the collection of GridViewCellInfo objects that represent the cells in this row.

C#
public GridViewCellInfoCollection Cells { get; }

Gets the collection of child rows for this row in hierarchical structures.

C#
public virtual GridViewChildRowCollection ChildRows { get; }

Implements: IHierarchicalRow.ChildRows

Gets the data-bound object that populated the row.

C#
public virtual object DataBoundItem { get; }

Gets or sets the error message text for row-level validation errors.

C#
public string ErrorText { get; set; }

Gets the DataGroup that contains this row when data is grouped.

C#
public virtual DataGroup Group { get; }

Gets a value indicating whether this row has expandable child views in hierarchical structures.

C#
public virtual bool HasChildViews { get; }

Implements: IHierarchicalRow.HasChildViews

Gets or sets the current height of the row in pixels.

C#
public int Height { get; set; }

Gets the hierarchical level of this row in nested structures.

C#
public virtual int HierarchyLevel { get; }

Implements: IHierarchicalRow.HierarchyLevel

Gets the zero-based index of the row in the GridViewRowCollection.

C#
public virtual int Index { get; }

Gets a value indicating whether this row contains the currently selected cell in the RadGridView.

C#
public bool IsCurrent { get; set; }

Gets or sets a value indicating whether this row is expanded in hierarchical or grouped views.

C#
public virtual bool IsExpanded { get; set; }

Gets a value indicating whether this row's index is odd, which is used for alternating row coloring.

C#
public bool IsOdd { get; }

Gets or sets a value indicating whether this row is pinned and remains in a fixed position during vertical scrolling.

C#
public virtual bool IsPinned { get; set; }

Gets or sets a value indicating whether the row is selected.

C#
public bool IsSelected { get; set; }

Determines whether the row is internally created by RadGridView and is used for displaying some dynamic information.

C#
[Browsable(false)]
public virtual bool IsSystem { get; }

Gets or sets a value indicating whether the row is visible.

C#
public bool IsVisible { get; set; }

Gets or sets the maximum height of the row in pixels.

C#
public int MaxHeight { get; set; }

Gets or sets the minimum height of the row in pixels.

C#
public int MinHeight { get; set; }

Gets the parent row in the hierarchical structure.

C#
public virtual IHierarchicalRow Parent { get; }

Implements: IHierarchicalRow.Parent

Gets or sets the pin position that determines where the row is positioned when pinned during vertical scrolling.

C#
public virtual PinnedRowPosition PinPosition { get; set; }

Gets the type of the GridRowElement that will be used to visually represent this row.

C#
public virtual Type RowElementType { get; }

Gets or sets custom data associated with this row.

C#
public object Tag { get; set; }

Gets the instance of GridViewInfo which the row belongs to.

C#
public virtual GridViewInfo ViewInfo { get; }

Gets the GridViewTemplate that this row belongs to.

C#
public GridViewTemplate ViewTemplate { get; }

Methods

Clears the cached values for this row.

C#
protected virtual void ClearCache()

Removes this row from the GridViewRowCollection.

C#
public virtual void Delete()

Dispatches an event through the grid view's event system.

C#
protected virtual void DispatchEvent(KnownEvents id, GridEventType type, GridEventDispatchMode dispatchMode, object originator, object[] arguments)
Parameters:idKnownEvents

The event identifier.

typeGridEventType

The event type.

dispatchModeGridEventDispatchMode

The dispatch mode.

originatorobject

The event originator.

argumentsobject[]

The event arguments.

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

C#
public void Dispose()

Implements: IDisposable.Dispose()

Scrolls the grid view to make this row visible if it is currently outside the viewport.

C#
public void EnsureVisible()

Scrolls the grid view to make this row visible, with an option to expand parent rows.

C#
public void EnsureVisible(bool expandParentRows)
Parameters:expandParentRowsbool

If set to true, expands all parent rows to make this row accessible.

Searches up the hierarchy to find the first parent of the specified type.

C#
public T FindParent<T>() where T : IHierarchicalRow
Returns:

T

The first parent of type T, or the default value if no such parent is found.

Calculates and returns the actual rendered height of the row.

C#
public virtual int GetActualHeight(IGridView gridView)
Parameters:gridViewIGridView

The grid view control that contains this row.

Returns:

int

The actual height of the row in pixels.

Gets the error text associated with the specified cell in this row.

C#
public string GetErrorText(string fieldName)
Parameters:fieldNamestring

The field name that identifies the cell.

Returns:

string

The error text for the specified cell, or empty string if no error exists.

Gets event information for property changes and determines the dispatch mode.

C#
protected virtual GridEventType GetEventInfo(GridPropertyChangedEventArgs property, out GridEventDispatchMode dispatchMode)
Parameters:propertyGridPropertyChangedEventArgs

The property change event arguments.

dispatchModeGridEventDispatchMode

The dispatch mode to use for the event.

Returns:

GridEventType

The event type for the property change.

Determines whether this row has any child rows in hierarchical structures.

C#
public virtual bool HasChildRows()
Returns:

bool

true if this row has child rows; otherwise, false.

Forces the visual representation of this row to be refreshed and redrawn.

C#
public virtual void InvalidateRow()

Called when an edit operation begins on this row.

C#
protected virtual bool OnBeginEdit()
Returns:

bool

true if the edit operation can proceed; otherwise, false.

Called when an edit operation ends on this row.

C#
protected virtual bool OnEndEdit()
Returns:

bool

true if the edit operation completed successfully; otherwise, false.

C#
protected virtual void OnPropertyChanged(PropertyChangedEventArgs args)
Parameters:argsPropertyChangedEventArgs
C#
protected virtual void OnPropertyChanging(PropertyChangingEventArgsEx args)
Parameters:argsPropertyChangingEventArgsEx

Resumes property change notifications after they were suspended by SuspendPropertyNotifications().

C#
public void ResumePropertyNotifications()

Sets a boolean property value and handles change notifications.

C#
protected virtual bool SetBooleanProperty(string propertyName, int propertyKey, bool value)
Parameters:propertyNamestring

The name of the property being changed.

propertyKeyint

The bit vector key for the property state.

valuebool

The new boolean value to set.

Returns:

bool

true if the property was successfully changed; otherwise, false.

Sets the parent row for this row in the hierarchical structure.

C#
protected void SetParent(GridViewRowInfo parent)
Parameters:parentGridViewRowInfo

The parent row to set.

Sets a property value in the row state and handles change notifications.

C#
protected virtual bool SetRowStateProperty<T>(string propertyName, ref T propertyField, T value)
Parameters:propertyNamestring

The name of the property being changed.

propertyFieldT

A reference to the property field to update.

valueT

The new value to set.

Returns:

bool

true if the property was successfully changed; otherwise, false.

Temporarily suspends property change notifications for this row.

C#
public void SuspendPropertyNotifications()

Events

Occurs when a property value has changed.

C#
public event PropertyChangedEventHandler PropertyChanged

Implements: INotifyPropertyChanged.PropertyChanged

Occurs when a property value is changing and can be cancelled.

C#
public event PropertyChangingEventHandlerEx PropertyChanging

Implements: INotifyPropertyChangingEx.PropertyChanging