GridViewRowInfo
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:
[TypeConverter(typeof(ExpandableObjectConverter))]
public abstract class GridViewRowInfo : IDataItem, IHierarchicalRow, INotifyPropertyChanged, INotifyPropertyChangingEx, IDisposable
Inheritance: objectGridViewRowInfo
Derived Classes:
Implements:
Constructors
Initializes a new instance of the GridViewRowInfo.
public GridViewRowInfo(GridViewInfo viewInfo)
An instance of GridViewInfo which the current row belongs to.
Fields
protected const int AllowResizeState = 64
protected const int IsAttachedState = 1
protected const int IsCurrentState = 4
protected const int IsExpandedState = 16
protected const int IsInitializedState = 256
protected const int IsModifiedState = 2
protected const int IsSelectedState = 8
protected const int IsVisibleState = 32
protected const int LastRowInfoState = 256
protected BitVector32 state
protected const int SuspendNotificationsState = 128
Properties
Gets the allowed states that this row can be in, determining what operations are permitted.
public virtual AllowedGridViewRowInfoStates AllowedStates { get; }
Gets or sets a value indicating whether the user can resize this row by dragging its border.
public virtual bool AllowResize { get; set; }
Gets the collection of GridViewCellInfo objects that represent the cells in this row.
public GridViewCellInfoCollection Cells { get; }
Gets the collection of child rows for this row in hierarchical structures.
public virtual GridViewChildRowCollection ChildRows { get; }
Implements:
Gets the data-bound object that populated the row.
public virtual object DataBoundItem { get; }
Gets or sets the error message text for row-level validation errors.
public string ErrorText { get; set; }
Gets the DataGroup that contains this row when data is grouped.
public virtual DataGroup Group { get; }
Gets a value indicating whether this row has expandable child views in hierarchical structures.
public virtual bool HasChildViews { get; }
Implements:
Gets the hierarchical level of this row in nested structures.
public virtual int HierarchyLevel { get; }
Implements:
Gets the zero-based index of the row in the GridViewRowCollection.
public virtual int Index { get; }
Gets a value indicating whether this row contains the currently selected cell in the RadGridView.
public bool IsCurrent { get; set; }
Gets or sets a value indicating whether this row is expanded in hierarchical or grouped views.
public virtual bool IsExpanded { get; set; }
Gets a value indicating whether this row's index is odd, which is used for alternating row coloring.
public bool IsOdd { get; }
Gets or sets a value indicating whether this row is pinned and remains in a fixed position during vertical scrolling.
public virtual bool IsPinned { get; set; }
Gets or sets a value indicating whether the row is selected.
public bool IsSelected { get; set; }
Determines whether the row is internally created by RadGridView and is used for displaying some dynamic information.
[Browsable(false)]
public virtual bool IsSystem { get; }
Gets or sets a value indicating whether the row is visible.
public bool IsVisible { get; set; }
Gets or sets the maximum height of the row in pixels.
public int MaxHeight { get; set; }
Gets or sets the minimum height of the row in pixels.
public int MinHeight { get; set; }
Gets the parent row in the hierarchical structure.
public virtual IHierarchicalRow Parent { get; }
Implements:
Gets or sets the pin position that determines where the row is positioned when pinned during vertical scrolling.
public virtual PinnedRowPosition PinPosition { get; set; }
Gets the type of the GridRowElement that will be used to visually represent this row.
public virtual Type RowElementType { get; }
Gets the instance of GridViewInfo which the row belongs to.
public virtual GridViewInfo ViewInfo { get; }
Gets the GridViewTemplate that this row belongs to.
public GridViewTemplate ViewTemplate { get; }
Methods
Clears the cached values for this row.
protected virtual void ClearCache()
Removes this row from the GridViewRowCollection.
public virtual void Delete()
Dispatches an event through the grid view's event system.
protected virtual void DispatchEvent(KnownEvents id, GridEventType type, GridEventDispatchMode dispatchMode, object originator, object[] arguments)
The event identifier.
typeGridEventTypeThe event type.
dispatchModeGridEventDispatchModeThe dispatch mode.
originatorobjectThe event originator.
argumentsobject[]The event arguments.
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
public void Dispose()
Implements:
Scrolls the grid view to make this row visible if it is currently outside the viewport.
public void EnsureVisible()
Scrolls the grid view to make this row visible, with an option to expand parent rows.
public void EnsureVisible(bool expandParentRows)
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.
public T FindParent<T>() where T : IHierarchicalRow
T
The first parent of type T, or the default value if no such parent is found.
Gets event information for property changes and determines the dispatch mode.
protected virtual GridEventType GetEventInfo(GridPropertyChangedEventArgs property, out GridEventDispatchMode dispatchMode)
The property change event arguments.
dispatchModeGridEventDispatchModeThe dispatch mode to use for the event.
Returns:The event type for the property change.
Determines whether this row has any child rows in hierarchical structures.
public virtual bool HasChildRows()
true if this row has child rows; otherwise, false.
Forces the visual representation of this row to be refreshed and redrawn.
public virtual void InvalidateRow()
Called when an edit operation begins on this row.
protected virtual bool OnBeginEdit()
true if the edit operation can proceed; otherwise, false.
Called when an edit operation ends on this row.
protected virtual bool OnEndEdit()
true if the edit operation completed successfully; otherwise, false.
protected virtual void OnPropertyChanged(PropertyChangedEventArgs args)
protected virtual void OnPropertyChanging(PropertyChangingEventArgsEx args)
Resumes property change notifications after they were suspended by SuspendPropertyNotifications().
public void ResumePropertyNotifications()
Sets a boolean property value and handles change notifications.
protected virtual bool SetBooleanProperty(string propertyName, int propertyKey, bool value)
The name of the property being changed.
propertyKeyintThe bit vector key for the property state.
valueboolThe new boolean value to set.
Returns:true if the property was successfully changed; otherwise, false.
Sets the parent row for this row in the hierarchical structure.
protected void SetParent(GridViewRowInfo parent)
The parent row to set.
Sets a property value in the row state and handles change notifications.
protected virtual bool SetRowStateProperty<T>(string propertyName, ref T propertyField, T value)
The name of the property being changed.
propertyFieldTA reference to the property field to update.
valueTThe new value to set.
Returns:true if the property was successfully changed; otherwise, false.
Temporarily suspends property change notifications for this row.
public void SuspendPropertyNotifications()
Events
Occurs when a property value has changed.
public event PropertyChangedEventHandler PropertyChanged
Implements:
Occurs when a property value is changing and can be cancelled.
public event PropertyChangingEventHandlerEx PropertyChanging
Implements: