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

RadGridView is a complex data visualization control that displays and enables editing of tabular data from various data sources. It provides rich functionality including hierarchical data representation, sorting, filtering, grouping, data validation, and custom cell editing.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.GridView.dll

Syntax:

C#
[TelerikToolboxCategory("Data Controls")]
[ComplexBindingProperties("DataSource", "DataMember")]
public class RadGridView : RadControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, IPrintable, IFilterable, ISupportRootUIAutomation

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadGridView...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetIFilterableILayoutHandlerINotifyPropertyChangedIPrintableISupportInitializeISupportInitializeNotificationISupportRootUIAutomationISynchronizeInvokeIWin32Window...

Inherited Members RadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.SetBackColorThemeOverrides()RadControl.ResetBackColorThemeOverrides()RadControl.SetForeColorThemeOverrides()RadControl.ResetForeColorThemeOverrides()RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnClick(EventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseHover(EventArgs)RadControl.OnMouseCaptureChanged(EventArgs)RadControl.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnParentChanged(EventArgs)RadControl.OnVisibleChanged(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnEnabledChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.OnInvalidated(RadElement)RadControl.OnCaptureLosing()RadControl.OnThemeChanged()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.OnThemeNameChanged(ThemeNameChangedEventArgs)RadControl.ProcessMnemonic(char)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.ProcessAutoSizeChanged(bool)RadControl.GetInputElement()RadControl.OnNotifyPropertyChanged(string)RadControl.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadControl.GetPreferredSize(Size)RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.GetRootElementDesiredSize(int, int, int, int)RadControl.OnZoomGesture(ZoomGestureEventArgs)RadControl.OnRotateGesture(RotateGestureEventArgs)RadControl.OnPanGesture(PanGestureEventArgs)RadControl.OnTwoFingerTapGesture(GestureEventArgs)RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadControl.OnGesture(GestureEventArgs)RadControl.ProcessGesture(Message)RadControl.EnableGesture(GestureType)RadControl.DisableGesture(GestureType)RadControl.Refresh()RadControl.SuspendUpdate()RadControl.ResumeUpdate()RadControl.ResumeUpdate(bool)RadControl.InvokeLayoutCallback(LayoutCallback)RadControl.RegisterHostedControl(RadHostItem)RadControl.UnregisterHostedControl(RadHostItem, bool)RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)RadControl.GetPlainText()RadControl.ShouldSerializeProperty(RadProperty)RadControl.ShouldSerializeProperty(RadProperty, RadObject)RadControl.ResetProperty(RadProperty, RadObject)RadControl.CanEditElementAtDesignTime(RadElement)RadControl.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.TextRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.AllowShowFocusCuesRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.FontRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGestureScrollableControl.ScrollStateAutoScrollingScrollableControl.ScrollStateHScrollVisibleScrollableControl.ScrollStateVScrollVisibleScrollableControl.ScrollStateUserHasScrolledScrollableControl.ScrollStateFullDragScrollableControl.AdjustFormScrollbars(bool)ScrollableControl.GetScrollState(int)ScrollableControl.OnPaintBackground(PaintEventArgs)ScrollableControl.SetDisplayRectLocation(int, int)ScrollableControl.ScrollControlIntoView(Control)ScrollableControl.ScrollToControl(Control)ScrollableControl.OnScroll(ScrollEventArgs)ScrollableControl.SetAutoScrollMargin(int, int)ScrollableControl.SetScrollState(int, bool)ScrollableControl.AutoScrollScrollableControl.AutoScrollMarginScrollableControl.AutoScrollPositionScrollableControl.AutoScrollMinSizeScrollableControl.CreateParamsScrollableControl.DisplayRectangleScrollableControl.HScrollScrollableControl.HorizontalScrollScrollableControl.VScrollScrollableControl.VerticalScrollScrollableControl.ScrollControl.GetAccessibilityObjectById(int)Control.SetAutoSizeMode(AutoSizeMode)Control.GetAutoSizeMode()Control.AccessibilityNotifyClients(AccessibleEvents, int)Control.AccessibilityNotifyClients(AccessibleEvents, int, int)Control.BeginInvoke(Delegate)Control.BeginInvoke(Delegate, params object[])Control.BringToFront()Control.Contains(Control)Control.CreateControlsInstance()Control.CreateGraphics()Control.CreateHandle()Control.CreateControl()Control.DefWndProc(ref Message)Control.DestroyHandle()Control.DoDragDrop(object, DragDropEffects)Control.DrawToBitmap(Bitmap, Rectangle)Control.EndInvoke(IAsyncResult)Control.FindForm()Control.GetTopLevel()Control.RaiseKeyEvent(object, KeyEventArgs)Control.RaiseMouseEvent(object, MouseEventArgs)Control.Focus()Control.FromChildHandle(IntPtr)Control.FromHandle(IntPtr)Control.GetChildAtPoint(Point, GetChildAtPointSkip)Control.GetChildAtPoint(Point)Control.GetContainerControl()Control.GetScaledBounds(Rectangle, SizeF, BoundsSpecified)Control.GetNextControl(Control, bool)Control.GetStyle(ControlStyles)Control.Hide()Control.InitLayout()Control.Invalidate(Region)Control.Invalidate(Region, bool)Control.Invalidate()Control.Invalidate(bool)Control.Invalidate(Rectangle)Control.Invalidate(Rectangle, bool)Control.Invoke(Delegate)Control.Invoke(Delegate, params object[])Control.InvokePaint(Control, PaintEventArgs)Control.InvokePaintBackground(Control, PaintEventArgs)Control.IsKeyLocked(Keys)Control.IsInputChar(char)Control.IsMnemonic(char, string)Control.LogicalToDeviceUnits(int)Control.LogicalToDeviceUnits(Size)Control.ScaleBitmapLogicalToDevice(ref Bitmap)Control.NotifyInvalidate(Rectangle)Control.InvokeOnClick(Control, EventArgs)Control.OnBackgroundImageChanged(EventArgs)Control.OnBackgroundImageLayoutChanged(EventArgs)Control.OnCausesValidationChanged(EventArgs)Control.OnContextMenuChanged(EventArgs)Control.OnContextMenuStripChanged(EventArgs)Control.OnCursorChanged(EventArgs)Control.OnDockChanged(EventArgs)Control.OnNotifyMessage(Message)Control.OnParentBackColorChanged(EventArgs)Control.OnParentBackgroundImageChanged(EventArgs)Control.OnParentBindingContextChanged(EventArgs)Control.OnParentCursorChanged(EventArgs)Control.OnParentEnabledChanged(EventArgs)Control.OnParentFontChanged(EventArgs)Control.OnParentForeColorChanged(EventArgs)Control.OnParentRightToLeftChanged(EventArgs)Control.OnParentVisibleChanged(EventArgs)Control.OnPrint(PaintEventArgs)Control.OnTabIndexChanged(EventArgs)Control.OnTabStopChanged(EventArgs)Control.OnTextChanged(EventArgs)Control.OnClientSizeChanged(EventArgs)Control.OnControlAdded(ControlEventArgs)Control.OnControlRemoved(ControlEventArgs)Control.OnHandleCreated(EventArgs)Control.OnDragEnter(DragEventArgs)Control.OnDragOver(DragEventArgs)Control.OnDragLeave(EventArgs)Control.OnDragDrop(DragEventArgs)Control.OnGiveFeedback(GiveFeedbackEventArgs)Control.OnEnter(EventArgs)Control.InvokeGotFocus(Control, EventArgs)Control.OnHelpRequested(HelpEventArgs)Control.OnInvalidated(InvalidateEventArgs)Control.OnLeave(EventArgs)Control.InvokeLostFocus(Control, EventArgs)Control.OnMarginChanged(EventArgs)Control.OnDpiChangedBeforeParent(EventArgs)Control.OnDpiChangedAfterParent(EventArgs)Control.OnMove(EventArgs)Control.OnQueryContinueDrag(QueryContinueDragEventArgs)Control.OnRegionChanged(EventArgs)Control.OnSizeChanged(EventArgs)Control.OnChangeUICues(UICuesEventArgs)Control.OnStyleChanged(EventArgs)Control.OnSystemColorsChanged(EventArgs)Control.RescaleConstantsForDpi(int, int)Control.PerformLayout()Control.PerformLayout(Control, string)Control.PointToClient(Point)Control.PointToScreen(Point)Control.PreProcessMessage(ref Message)Control.PreProcessControlMessage(ref Message)Control.ProcessCmdKey(ref Message, Keys)Control.ProcessDialogChar(char)Control.ProcessKeyEventArgs(ref Message)Control.ProcessKeyMessage(ref Message)Control.ProcessKeyPreview(ref Message)Control.RaiseDragEvent(object, DragEventArgs)Control.RaisePaintEvent(object, PaintEventArgs)Control.RecreateHandle()Control.RectangleToClient(Rectangle)Control.RectangleToScreen(Rectangle)Control.ReflectMessage(IntPtr, ref Message)Control.ResetMouseEventArgs()Control.ResetText()Control.ResumeLayout()Control.ResumeLayout(bool)Control.Scale(SizeF)Control.Select()Control.Select(bool, bool)Control.SelectNextControl(Control, bool, bool, bool, bool)Control.SendToBack()Control.SetBounds(int, int, int, int)Control.SetBounds(int, int, int, int, BoundsSpecified)Control.SetClientSizeCore(int, int)Control.SizeFromClientSize(Size)Control.SetStyle(ControlStyles, bool)Control.SetTopLevel(bool)Control.SetVisibleCore(bool)Control.RtlTranslateAlignment(HorizontalAlignment)Control.RtlTranslateAlignment(LeftRightAlignment)Control.RtlTranslateAlignment(ContentAlignment)Control.RtlTranslateHorizontal(HorizontalAlignment)Control.RtlTranslateLeftRight(LeftRightAlignment)Control.RtlTranslateContent(ContentAlignment)Control.Show()Control.SuspendLayout()Control.Update()Control.UpdateBounds()Control.UpdateBounds(int, int, int, int)Control.UpdateBounds(int, int, int, int, int, int)Control.UpdateZOrder()Control.UpdateStyles()Control.OnImeModeChanged(EventArgs)Control.AccessibilityObjectControl.AccessibleDefaultActionDescriptionControl.AccessibleDescriptionControl.AccessibleNameControl.AccessibleRoleControl.AllowDropControl.AnchorControl.AutoScrollOffsetControl.LayoutEngineControl.BackgroundImageControl.BackgroundImageLayoutControl.BindingContextControl.BottomControl.BoundsControl.CanFocusControl.CanRaiseEventsControl.CanSelectControl.CaptureControl.CheckForIllegalCrossThreadCallsControl.ClientRectangleControl.ClientSizeControl.CompanyNameControl.ContainsFocusControl.ContextMenuControl.ContextMenuStripControl.ControlsControl.CreatedControl.CursorControl.DataBindingsControl.DefaultBackColorControl.DefaultCursorControl.DefaultFontControl.DefaultForeColorControl.DefaultMarginControl.DefaultMaximumSizeControl.DefaultMinimumSizeControl.DefaultPaddingControl.DeviceDpiControl.IsDisposedControl.DisposingControl.DockControl.DoubleBufferedControl.EnabledControl.FocusedControl.FontHeightControl.HandleControl.HasChildrenControl.HeightControl.IsHandleCreatedControl.InvokeRequiredControl.IsAccessibleControl.IsMirroredControl.LeftControl.LocationControl.MarginControl.ModifierKeysControl.MouseButtonsControl.MousePositionControl.NameControl.ParentControl.ProductNameControl.ProductVersionControl.RecreatingHandleControl.RegionControl.RenderRightToLeftControl.ResizeRedrawControl.RightControl.RightToLeftControl.ScaleChildrenControl.SizeControl.TabIndexControl.TabStopControl.TagControl.TopControl.TopLevelControlControl.ShowKeyboardCuesControl.ShowFocusCuesControl.UseWaitCursorControl.VisibleControl.WidthControl.PreferredSizeControl.CanEnableImeControl.DefaultImeModeControl.ImeModeControl.ImeModeBaseControl.PropagatingImeModeControl.BackColorChangedControl.BackgroundImageChangedControl.BackgroundImageLayoutChangedControl.BindingContextChangedControl.CausesValidationChangedControl.ClientSizeChangedControl.ContextMenuChangedControl.ContextMenuStripChangedControl.CursorChangedControl.DockChangedControl.EnabledChangedControl.FontChangedControl.ForeColorChangedControl.LocationChangedControl.MarginChangedControl.RegionChangedControl.RightToLeftChangedControl.SizeChangedControl.TabIndexChangedControl.TabStopChangedControl.TextChangedControl.VisibleChangedControl.ClickControl.ControlAddedControl.ControlRemovedControl.DragDropControl.DragEnterControl.DragOverControl.DragLeaveControl.GiveFeedbackControl.HandleCreatedControl.HandleDestroyedControl.HelpRequestedControl.InvalidatedControl.PaddingChangedControl.PaintControl.QueryContinueDragControl.QueryAccessibilityHelpControl.DoubleClickControl.EnterControl.GotFocusControl.KeyDownControl.KeyPressControl.KeyUpControl.LayoutControl.LeaveControl.LostFocusControl.MouseClickControl.MouseDoubleClickControl.MouseCaptureChangedControl.MouseDownControl.MouseEnterControl.MouseLeaveControl.DpiChangedBeforeParentControl.DpiChangedAfterParentControl.MouseHoverControl.MouseMoveControl.MouseUpControl.MouseWheelControl.MoveControl.PreviewKeyDownControl.ResizeControl.ChangeUICuesControl.StyleChangedControl.SystemColorsChangedControl.ValidatingControl.ValidatedControl.ParentChangedControl.ImeModeChangedComponent.Dispose()Component.GetService(Type)Component.ToString()Component.EventsComponent.ContainerComponent.DesignModeComponent.DisposedMarshalByRefObject.MemberwiseClone(bool)MarshalByRefObject.GetLifetimeService()MarshalByRefObject.InitializeLifetimeService()MarshalByRefObject.CreateObjRef(Type)...

Constructors

Initializes a new instance of the RadGridView class. Creates a new grid view control with default settings and initializes the print style.

C#
public RadGridView()

Properties

Gets the active editor

C#
[Browsable(false)]
public IInputEditor ActiveEditor { get; }

Gets or sets a value indicating the location of the new row in the view template.

C#
[Browsable(true)]
public SystemRowPosition AddNewRowPosition { get; set; }

Gets or sets a value indicating whether the user can add new rows through the grid.

C#
[Browsable(true)]
public bool AllowAddNewRow { get; set; }
Remarks:

When set to true an empty row is added in which the user can enter data for the new record. Set to false to hide the row.
The row position is controlled through AddNewRowPosition

Gets or sets a value indicating whether user can automatically resize a column to fit its content by double-clicking the right border of header cell.

C#
[Browsable(false)]
public bool AllowAutoSizeColumns { get; set; }

Gets or sets a value indicating whether context menu is displayed when user right clicks on a data cell.

C#
[Browsable(true)]
public bool AllowCellContextMenu { get; set; }

Gets or sets a value indicating whether GridViewColumnChooser is available to the user for this instance of GridViewTemplate.

C#
[Browsable(true)]
public bool AllowColumnChooser { get; set; }

Gets or sets a value indicating whether context menu is displayed when user right clicks on a column header.

C#
[Browsable(true)]
public bool AllowColumnHeaderContextMenu { get; set; }

Gets or sets a value indicating whether user can reorder Columns.

C#
[Browsable(true)]
public bool AllowColumnReorder { get; set; }

Gets or sets a value indicating whether user can resize columns.

C#
[Browsable(true)]
public bool AllowColumnResize { get; set; }
Remarks:

This property does not prevent developer from setting Width

Gets or sets a value indicating whether user can delete rows.

C#
[Browsable(true)]
public bool AllowDeleteRow { get; set; }

Gets or sets a value indicating whether user can drag a column header to grouping panel.

C#
[Browsable(true)]
public bool AllowDragToGroup { get; set; }

Gets or sets a value indicating whether user can edit rows.

C#
[Browsable(true)]
public bool AllowEditRow { get; set; }

Gets or sets a value indicating whether the end-user can sort by more than one column.

C#
[Browsable(false)]
public bool AllowMultiColumnSorting { get; set; }

Gets or sets a value indicating whether context menu is displayed when user right clicks on a row header.

C#
[Browsable(true)]
public bool AllowRowHeaderContextMenu { get; set; }

Gets or sets a value indicating whether the user is able to reorder rows in the grid

C#
[Browsable(true)]
public bool AllowRowReorder { get; set; }

Gets or sets a value indicating whether user can resize a row.

C#
[Browsable(true)]
public bool AllowRowResize { get; set; }
Remarks:

This property does not prevent developer from setting Height

Gets or sets a value indicating whether the user can search through the data of the grid.

C#
[Browsable(true)]
public bool AllowSearchRow { get; set; }
Remarks:

When set to true a search row is added in which the user can enter search criteria. Set to false to hide the row.
The row position is controlled through SearchRowPosition

Sets or gets a value indicating the initial state of group rows when data is grouped.

C#
[Browsable(true)]
public bool AutoExpandGroups { get; set; }

Gets or sets a value indicating whether columns are created automatically when the or properties are set.

C#
[Browsable(true)]
public bool AutoGenerateColumns { get; set; }
Property Value:

true if the columns should be created automatically; otherwise, false. The default is true.

Gets or sets a value indicating whether the RadGridView will automatically build hierarchy from DataSource.

C#
[Browsable(true)]
public bool AutoGenerateHierarchy { get; set; }

Gets or sets a value indicating whether the control is automatically resized to display its entire contents.

C#
[Browsable(true)]
public override bool AutoSize { get; set; }

Overrides: RadControl.AutoSize

Gets or sets a value indicating how column widths are determined.

C#
[Browsable(true)]
public GridViewAutoSizeColumnsMode AutoSizeColumnsMode { get; set; }

Gets or sets a value indicating whether row height in a RataGridView will expand for multiline cell text

C#
[Browsable(true)]
public bool AutoSizeRows { get; set; }

Gets or sets value indicating how user begins editing a cell.

C#
[Browsable(true)]
public RadGridViewBeginEditMode BeginEditMode { get; set; }

Gets or sets a value indicating how bottom pinned rows are laid out.

C#
[Browsable(true)]
public GridViewBottomPinnedRowsMode BottomPinnedRowsMode { get; set; }

Indicates whether string comparisons of data are case-sensitive.

C#
[Browsable(true)]
public bool CaseSensitive { get; set; }

Gets the child rows.

C#
[Browsable(false)]
public GridViewChildRowCollection ChildRows { get; }
Property Value:

The child rows.

Gets or sets the position to place tabs for child views related with this template.

C#
[Browsable(true)]
public TabPositions ChildViewTabsPosition { get; set; }

Gets or sets a value that indicates whether users can copy cell text values to the System.Windows.Forms.Clipboard and whether row and column header text is included.

C#
[Browsable(true)]
public GridViewClipboardCopyMode ClipboardCopyMode { get; set; }

Gets or sets a value that indicates whether users can cut cell text values to the System.Windows.Forms.Clipboard and whether row and column header text is included.

C#
[Browsable(true)]
public GridViewClipboardCutMode ClipboardCutMode { get; set; }

Gets or sets a value that indicates whether users can paste Clipboard values to the RadGridView control.

C#
[Browsable(true)]
public GridViewClipboardPasteMode ClipboardPasteMode { get; set; }

Gets or sets a value indicating whether the active editor should be closed when validation process fails.

C#
[Browsable(true)]
public bool CloseEditorWhenValidationFails { get; set; }

Gets the current column chooser

C#
[Browsable(false)]
public GridViewColumnChooser ColumnChooser { get; }

Gets or sets the column chooser sort order.

C#
[Browsable(true)]
public RadSortOrder ColumnChooserSortOrder { get; set; }
Property Value:

The column chooser sort order.

Gets or sets the number of columns displayed.

C#
[Browsable(false)]
public int ColumnCount { get; set; }

Gets the columns.

C#
public GridViewColumnCollection Columns { get; }
Property Value:

The columns.

Gets an instance of GridViewContextMenuManager or the instance that implements IContextMenuManager interface.

C#
[Browsable(false)]
public virtual IContextMenuManager ContextMenuManager { get; }

Gets the currently active cell in the grid.

C#
[Browsable(false)]
public GridDataCellElement CurrentCell { get; }

Gets the row and column indexes of the currently active cell.

C#
[Browsable(false)]
public Point CurrentCellAddress { get; }

Gets or sets the current column of the currently active view containing the current cell.

C#
[Browsable(false)]
public GridViewColumn CurrentColumn { get; set; }

Gets or sets the current row of the currently active view containing the current cell.

C#
[Browsable(false)]
public GridViewRowInfo CurrentRow { get; set; }

Gets the currently active view in the RadGridView

C#
[Browsable(false)]
public IRowView CurrentView { get; set; }

Gets or sets the name of the list or table in the data source for which the GridViewTemplate is displaying data.

C#
[Browsable(true)]
public string DataMember { get; set; }

Gets or sets the data source that the RadGridView is displaying data for. This property can be set to various data sources including DataTable, DataSet, IList, or any object that implements IListSource or IEnumerable.

C#
[Browsable(true)]
public object DataSource { get; set; }

Implements: IFilterable.DataSource

Gets the default size of the control.

C#
protected override Size DefaultSize { get; }
Property Value:

The default Size of the control.

Overrides: Control.DefaultSize

Gets an instance of GridViewEditManager that defines how to initialize and create cells and editors.

C#
[Browsable(false)]
public GridViewEditManager EditorManager { get; }

Gets or sets a value indicating whether alternating row color is enabled.

C#
[Browsable(true)]
public virtual bool EnableAlternatingRowColor { get; set; }

Gets or sets a value specifying if the custom drawing (e.g. CellPaint and RowPaint) is enabled

C#
[Browsable(true)]
public bool EnableCustomDrawing { get; set; }

Gets or sets a value indicating whether the custom filtering functionality should be enabled. Use the CustomFiltering event to apply the desired filters.

C#
[Browsable(true)]
public bool EnableCustomFiltering { get; set; }

Gets or sets a value indicating whether the custom grouping functionality should be enabled. Use the CustomGrouping event to group the data.

C#
[Browsable(true)]
public bool EnableCustomGrouping { get; set; }

Gets or sets a value indicating whether the custom sorting functionality should be enabled. Use the CustomSorting event to apply the desired sorting.

C#
[Browsable(true)]
public bool EnableCustomSorting { get; set; }

Gets or sets value indicating if fast scrolling mode is turned on.

C#
[Browsable(true)]
public bool EnableFastScrolling { get; set; }

Gets or sets value indicating whether users can filter data in the master view template.

C#
[Browsable(true)]
public bool EnableFiltering { get; set; }

Gets or sets value indicating whether users can group data in the master view template.

C#
[Browsable(true)]
public bool EnableGrouping { get; set; }

Gets or sets value indicating whether hot tracking is enabled.

C#
[Browsable(true)]
public bool EnableHotTracking { get; set; }

Gets or sets a value indicating whether the kinetic scrolling function is enabled.

C#
[Browsable(true)]
public bool EnableKineticScrolling { get; set; }

Gets or sets value indicating whether users can paginate data in the master view template.

C#
[Browsable(true)]
public bool EnablePaging { get; set; }

Gets or sets value indicating whether users can sort data in master view template.

C#
[Browsable(true)]
public bool EnableSorting { get; set; }

Gets or sets a value indicating whether the UI Automation functionality is enabled or disabled for this control.

C#
public override bool EnableUIAutomation { get; set; }

Overrides: RadControl.EnableUIAutomation

Implements: ISupportRootUIAutomation.EnableUIAutomation

Gets or sets value indicating the behavior when the user presses Enter.

C#
[Browsable(true)]
public RadGridViewEnterKeyMode EnterKeyMode { get; set; }

Gets the filter descriptors of master template.

C#
[Browsable(true)]
public FilterDescriptorCollection FilterDescriptors { get; }
Property Value:

The filter descriptors of master template.

Implements: IFilterable.FilterDescriptors

Gets or sets an instance of BaseGridBehavior or the instance that implements IGridBehavior interface.

C#
[Browsable(false)]
public virtual IGridBehavior GridBehavior { get; set; }

Gets an instance of BaseGridNavigator or the instance that implements IGridNavigator interface.

C#
[Browsable(false)]
public virtual IGridNavigator GridNavigator { get; }

Gets the instance of GridVisualElement. This instance is wrapped by this control and the main element in the hierarchy tree and encapsulates the actual functionality of RadGridView.

C#
[Browsable(false)]
public RadGridViewElement GridViewElement { get; }

Gets the group descriptors of master template.

C#
[Browsable(true)]
public GroupDescriptorCollection GroupDescriptors { get; }
Property Value:

The group descriptors of master template.

Gets or set a value indicating the animation effect that will be used when expanding/collapsing groups.

C#
[Browsable(true)]
public GridExpandAnimationType GroupExpandAnimationType { get; set; }

Gets a collection that contains the all groups in the MasterTemplate.

C#
[Browsable(false)]
public DataGroupCollection Groups { get; }

Gets or sets a value indicating whether the selected item in the control remains highlighted when the control loses focus.

Returns: true if the selected item does not appear highlighted when the control loses focus; false if the selected item still appears highlighted when the control loses focus. The default is true.

C#
[Browsable(true)]
public bool HideSelection { get; set; }

Gets or sets the display state of grid horizontal scrollbars.

C#
[Browsable(true)]
public ScrollState HorizontalScrollState { get; set; }

Gets whether the grid is disposing.

C#
protected virtual bool IsDisposing { get; }
Property Value:

The is disposing.

Gets a value indicating whether the cell is in edit mode.

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

Gets the MasterGridViewTemplate representing the top-most level of the hierarchical data in the grid. The MasterTemplate provides access to columns, rows, and all data operations for the main grid view.

C#
[Browsable(false)]
public MasterGridViewTemplate MasterTemplate { get; }

Gets the top-most GridViewInfo level of the grid.

C#
[Browsable(false)]
public GridViewInfo MasterView { get; }

Gets or sets a value indicating how the merged cells will be edited.

C#
[Browsable(true)]
public MergeCellsEditMode MergeCellsEditMode { get; set; }

Indicates whether and how the cells will be merged.

C#
[Browsable(true)]
public MergeCellsMode MergeCellsMode { get; set; }

Gets or sets a value indicating whether the user is allowed to select more than one cell, row, or column of the RadGridView at a time.

C#
[Browsable(true)]
public bool MultiSelect { get; set; }

Gets or sets value indicating the behavior when the user presses Enter while adding new row.

C#
[Browsable(true)]
public RadGridViewNewRowEnterKeyMode NewRowEnterKeyMode { get; set; }

Gets or sets value indicating the number of rows in the master view template when paging is enabled.

C#
[Browsable(true)]
public int PageSize { get; set; }

Gets or sets the print settings dialog factory.

C#
[Browsable(false)]
public IPrintSettingsDialogFactory PrintSettingsDialogFactory { get; set; }
Property Value:

The print settings dialog factory.

Gets or sets a value indicating how the RadGridView is printed.

C#
[Browsable(true)]
public GridPrintStyle PrintStyle { get; set; }

Gets or sets a value indicating whether the user can edit the cells of the RadGridView control.

C#
[Browsable(true)]
public bool ReadOnly { get; set; }

Gets collection of GridViewRelation instances that represent the hierarchical structure.

C#
[Browsable(true)]
public GridViewRelationCollection Relations { get; }

Gets or sets the number of rows contained in the current GridViewTemplate.

C#
[Browsable(false)]
public int RowCount { get; set; }

Gets a collection that contains the all rows in the MasterTemplate.

C#
[Browsable(false)]
public GridViewRowCollection Rows { get; }

Gets or sets a value indicating the location of the search row.

C#
[Browsable(true)]
public SystemRowPosition SearchRowPosition { get; set; }

Gets the collection of cells selected by the user.

C#
[Browsable(false)]
public GridViewSelectedCellsCollection SelectedCells { get; }

Gets the collection of rows selected by the user.

C#
[Browsable(false)]
public GridViewSelectedRowsCollection SelectedRows { get; }

Gets or sets a value indicating how the cells of the RadGridView can be selected.

C#
[Browsable(true)]
public GridViewSelectionMode SelectionMode { get; set; }

Gets or sets a value indicating whether to show cell errors.

C#
[Browsable(true)]
public bool ShowCellErrors { get; set; }

Gets or sets a value indicating whether to show child view captions.

C#
[Browsable(true)]
public bool ShowChildViewCaptions { get; set; }

Indicates whether summary rows of collapsed groups will be visible. If true the summary rows will not be hidden when the group is collapsed. Note that the GridViewGroupRowInfo has the same property and it has higher priority. If you need different behavior for different groups/group levels, you can use the CreateRowInfo event and set the ShowCollapsedGroupSummaries of each group individually.

C#
[Browsable(true)]
public bool ShowCollapsedGroupSummaries { get; set; }

Gets or sets a value indicating whether the column headers are visible.

C#
[Browsable(true)]
public bool ShowColumnHeaders { get; set; }

Gets or sets a value indicating whether the filtering row should be visible.

C#
[Browsable(true)]
public bool ShowFilteringRow { get; set; }

Gets or sets a value indicating whether the columns by which the data is grouped are visible.

C#
[Browsable(true)]
public bool ShowGroupedColumns { get; set; }
Remarks:

Set to false, and each column contained in the GroupDescriptors, will get hidden. Set to true to see all columns. If some column is still not visible, check IsVisible.

Gets or sets value indicating whether the GridGroupPanel is visible.

C#
[Browsable(true)]
public bool ShowGroupPanel { get; set; }

Gets or sets a value indicating whether the group panel will show scroll bars or it will expand to show all group headers.

C#
[Browsable(true)]
public bool ShowGroupPanelScrollbars { get; set; }

Gets or sets a value indicating whether the header cell buttons are visible.

C#
[Browsable(true)]
public bool ShowHeaderCellButtons { get; set; }

Gets or sets the text to use when there is no data.

C#
[Browsable(true)]
public bool ShowNoDataText { get; set; }

Gets or sets a value indicating whether to show row errors.

C#
[Browsable(true)]
public bool ShowRowErrors { get; set; }

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

C#
[Browsable(true)]
public bool ShowRowHeaderColumn { get; set; }

Gets or sets a value indicating whether the select column is visible. The select column in only supported for the GridViewSelectionMode.FullRowSelect.

C#
[Browsable(true)]
public bool ShowSelectColumn { get; set; }

Gets the sort descriptors of master template.

C#
[Browsable(true)]
public SortDescriptorCollection SortDescriptors { get; }
Property Value:

The sort descriptors.

Gets or sets a value indicating how to split RadGridView.

C#
[Browsable(true)]
public RadGridViewSplitMode SplitMode { get; set; }

Gets or sets a value indicating whether the TAB key moves the focus to the next control in the tab order rather than moving focus to the next cell in the control.

C#
[Browsable(true)]
public bool StandardTab { get; set; }

Gets the collection containing summary rows placed at the bottom of each DataGroup.

C#
[Browsable(true)]
public GridViewSummaryRowItemCollection SummaryRowsBottom { get; }

Gets the collection containing summary rows placed on top of each DataGroup.

C#
[Browsable(true)]
public GridViewSummaryRowItemCollection SummaryRowsTop { get; }

Gets or sets whether when changing the current row in one split view the same row in the other split view will be brought into view.

C#
[Browsable(true)]
public bool SynchronizeCurrentRowInSplitMode { get; set; }

Gets the instance of GridTableElement

C#
[Browsable(false)]
public GridTableElement TableElement { get; }

Gets the child templates of master template.

C#
[Browsable(true)]
public GridViewTemplateCollection Templates { get; }
Property Value:

The child templates of master template.

Gets or sets a value indicating the position of the title.

C#
[Browsable(true)]
public Dock TitlePosition { get; set; }

Gets or set the text of the grid title.

C#
[Browsable(true)]
public string TitleText { get; set; }

Gets or sets a value indicating whether to use dedicated vertical scrollbars in hierarchy.

C#
[Browsable(true)]
public bool UseScrollbarsInHierarchy { get; set; }

Gets or sets the display state of grid vertical scrollbars.

C#
[Browsable(true)]
public ScrollState VerticalScrollState { get; set; }

Gets or sets the IGridViewDefinition associated with the MasterTemplate.

C#
[Browsable(false)]
public IGridViewDefinition ViewDefinition { get; set; }

Gets or sets a value indicating whether you have provided your own data-management operations for the RadGridView control.

C#
[Browsable(true)]
public bool VirtualMode { get; set; }
Property Value:

The virtual mode.

Gets the serialization info for RadGridView used by Save/Load layout methods to persist grid settings to/from XML. By default, or when set to null the ComponentXmlSerializationInfo provided by GetDefaultXmlSerializationInfo() will be used.

C#
[Browsable(false)]
public ComponentXmlSerializationInfo XmlSerializationInfo { get; set; }

Methods

Puts the current cell in edit mode.

C#
public virtual bool BeginEdit()
Returns:

bool

Returns true if the process is successful.

Suspends layout during initialization.

C#
public override void BeginInit()

Overrides: RadControl.BeginInit()

Suspends the drawing and layout logic of the grid. Call this method before performing multiple operations on the grid to improve performance, and call EndUpdate() when finished.

C#
public void BeginUpdate()

Widens / shrinks all columns based on the space required by the text in the columns.

C#
public void BestFitColumns()

Widens / shrinks all columns based on the space required by the text in the columns.

C#
public void BestFitColumns(BestFitColumnMode mode)
Parameters:modeBestFitColumnMode

The mode.

Close the currently active editor and discard changes.

C#
public virtual bool CancelEdit()
Returns:

bool

true on successful cancellation.

Clears the current selection by deselecting all selected cells (rows).

C#
public void ClearSelection()

Ends the edit operation without committing the changes

C#
public virtual bool CloseEditor()
Returns:

bool

true on success.

Gets whether the control defines the theme for the specific element.

C#
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters:elementRadElement

The element.

Returns:

bool

Overrides: RadControl.ControlDefinesThemeForElement(RadElement)

Copy the formatted values that represent the contents of the selected cells to the System.Windows.Forms.Clipboard.

C#
public virtual void Copy()

Creates a new accessibility object for the control.

C#
protected override AccessibleObject CreateAccessibilityInstance()
Returns:

AccessibleObject

A new AccessibleObject for the control.

Overrides: Control.CreateAccessibilityInstance()

Creates the child items.

C#
protected override void CreateChildItems(RadElement parent)
Parameters:parentRadElement

The parent.

Overrides: RadControl.CreateChildItems(RadElement)

Creates the grid view element.

C#
protected virtual RadGridViewElement CreateGridViewElement()
Returns:

RadGridViewElement

Creates the grid view layout serializer.

C#
protected virtual GridViewLayoutSerializer CreateGridViewLayoutSerializer(ComponentXmlSerializationInfo info)
Parameters:infoComponentXmlSerializationInfo

The info.

Returns:

GridViewLayoutSerializer

Moves the current selection in the to the Clipboard.

C#
public virtual void Cut()

Calls internally BeginUpdate.

C#
public IDisposable DeferRefresh()
Returns:

IDisposable

Gets the displayed column count.

C#
public int DisplayedColumnCount(bool includePartialColumn)
Parameters:includePartialColumnbool

The include partial column.

Returns:

int

Gets the displayed row count.

C#
public int DisplayedRowCount(bool includePartialRow)
Parameters:includePartialRowbool

The include partial row.

Returns:

int

Releases the unmanaged resources used by the RadGridView and optionally releases the managed resources.

C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Overrides: RadControl.Dispose(bool)

Commits any changes and ends the edit operation on the current cell.

C#
public virtual bool EndEdit()
Returns:

bool

true on success.

Resumes layout.

C#
public override void EndInit()

Overrides: RadControl.EndInit()

Resumes the drawing and layout logic of the grid after a call to BeginUpdate(). This method raises all appropriate change notifications.

C#
public void EndUpdate()

Resumes the drawing and layout logic of the grid after a call to BeginUpdate().

C#
public void EndUpdate(bool notify)
Parameters:notifybool

When true, raises appropriate change notifications after resuming updates.

Evaluates the specified expression.

C#
public object Evaluate(string expression, IEnumerable<GridViewRowInfo> rows)
Parameters:expressionstring

The expression.

rowsIEnumerable<GridViewRowInfo>

The rows.

Returns:

object

Retrieves the formatted values that represent the contents of the selected cells for copying to the System.Windows.Forms.Clipboard.

C#
public virtual DataObject GetClipboardContent()
Returns:

DataObject

Gets the default serialization info for RadGridView used by Save/Load layout methods to persist grid settings to/from XML.

C#
public virtual ComponentXmlSerializationInfo GetDefaultXmlSerializationInfo()
Returns:

ComponentXmlSerializationInfo

Remarks:

You can use the serialization info to include/exclude properties of RadGridView and related objects from XML serialization. Example:
ComponentXmlSerializationInfo serializationInfo = radGridView1. info.SerializationMetadata.Add();

C#
public void HideColumnChooser()

Invalidates the multi selection.

C#
protected virtual void InvalidateMultiSelection()

Determines whether the specified key data is input key.

C#
protected override bool IsInputKey(Keys keyData)
Parameters:keyDataKeys

The key data.

Returns:

bool

Overrides: RadControl.IsInputKey(Keys)

Unbound load the IDatareader data and reset current DataSource for MasterTemplate

C#
public void LoadFrom(IDataReader dataReader)
Parameters:dataReaderIDataReader

Loads RadGridView properties, sub-objects and their properties from XML stream, using the serialization information provided by the XmlSerializationInfo property

C#
public virtual void LoadLayout(Stream stream)
Parameters:streamStream

Loads RadGridView properties, sub-objects and their properties from XML file, using the serialization information provided by the XmlSerializationInfo property

C#
public virtual void LoadLayout(string fileName)
Parameters:fileNamestring

Loads RadGridView properties, sub-objects and their properties from XML reader, using the serialization information provided by the XmlSerializationInfo property

C#
public virtual void LoadLayout(XmlReader xmlReader)
Parameters:xmlReaderXmlReader

Called when a new column is automatically generated.

C#
protected virtual void OnAutoGeneratingColumn(object sender, GridViewAutoGeneratingColumnEventArgs e)
Parameters:senderobject

The sender.

eGridViewAutoGeneratingColumnEventArgs

The GridViewAutoGeneratingColumnEventArgs instance containing the event data.

Raises the BindingContextChanged event.

C#
protected override void OnBindingContextChanged(EventArgs e)
Parameters:eEventArgs

An EventArgs that contains the event data.

Overrides: RadControl.OnBindingContextChanged(EventArgs)

Called when the row editing is canceled.

C#
protected virtual void OnCancelRowEdit(object sender, QuestionEventArgs e)
Parameters:senderobject

The sender.

eQuestionEventArgs

The QuestionEventArgs instance containing the event data.

Called when the cell begins editing.

C#
protected virtual void OnCellBeginEdit(object sender, GridViewCellCancelEventArgs e)
Parameters:senderobject

The sender.

eGridViewCellCancelEventArgs

The GridViewCellCancelEventArgs instance containing the event data.

Called when [cell click].

C#
protected virtual void OnCellClick(object sender, GridViewCellEventArgs e)
Parameters:senderobject

The sender.

eGridViewCellEventArgs

The GridViewCellEventArgs instance containing the event data.

Called when the cell is double clicked.

C#
protected void OnCellDoubleClick(object sender, GridViewCellEventArgs e)
Parameters:senderobject

The sender.

eGridViewCellEventArgs

The GridViewCellEventArgs instance containing the event data.

Raises the CellEditorInitialized event.

C#
protected virtual void OnCellEditorInitialized(object sender, GridViewCellEventArgs e)
Parameters:senderobject

The cell that is to be edited.

eGridViewCellEventArgs

A GridViewCellEventArgs instance containing event data.

Called when the cell ends editing.

C#
protected virtual void OnCellEndEdit(object sender, GridViewCellEventArgs e)
Parameters:senderobject

The sender.

eGridViewCellEventArgs

The GridViewCellEventArgs instance containing the event data.

Raises the CellFormatting event

C#
protected void OnCellFormatting(object sender, CellFormattingEventArgs e)
Parameters:senderobject

The cell that needs formatting.

eCellFormattingEventArgs

A CellFormattingEventArgs instance containing event data.

Raises the CellMerging event

C#
protected void OnCellMerging(GridViewCellMergingEventArgs e)
Parameters:eGridViewCellMergingEventArgs

A GridViewCellMergingEventArgsinstance containing event data.

Raises the CellMouseMove event

C#
protected void OnCellMouseMove(object sender, MouseEventArgs e)
Parameters:senderobjecteMouseEventArgs

Raises the CellPaint event.

C#
protected virtual void OnCellPaint(object sender, GridViewCellPaintEventArgs e)
Parameters:senderobject

The owner control.

eGridViewCellPaintEventArgs

An instance of GridViewCellPaintEventArgs containing event data.

Raises the CellValidated event.

C#
protected virtual void OnCellValidated(object sender, CellValidatedEventArgs e)
Parameters:senderobjecteCellValidatedEventArgs

Raises the CellValidating event.

C#
protected virtual void OnCellValidating(object sender, CellValidatingEventArgs e)
Parameters:senderobjecteCellValidatingEventArgs

Called when the cell value is changed.

C#
protected virtual void OnCellValueChanged(object sender, GridViewCellEventArgs e)
Parameters:senderobject

The sender.

eGridViewCellEventArgs

The GridViewCellEventArgs instance containing the event data.

Raises the CellValueNeeded event.

C#
protected virtual void OnCellValueNeeded(object sender, GridViewCellValueEventArgs e)
Parameters:senderobject

The owner control.

eGridViewCellValueEventArgs

An instance of GridViewRowEventArgs containing event data.

Raises the CellValuePushed event.

C#
protected virtual void OnCellValuePushed(object sender, GridViewCellValueEventArgs e)
Parameters:senderobject

The owner control.

eGridViewCellValueEventArgs

An instance of GridViewRowEventArgs containing event data.

Called when the child view is expanded.

C#
protected virtual void OnChildViewExpanded(object sender, ChildViewExpandedEventArgs e)
Parameters:senderobject

The sender.

eChildViewExpandedEventArgs

The ChildViewExpandedEventArgs instance containing the event data.

Called when the child view is expanding.

C#
protected virtual void OnChildViewExpanding(object sender, ChildViewExpandingEventArgs e)
Parameters:senderobject

The sender.

eChildViewExpandingEventArgs

The ChildViewExpandingEventArgs instance containing the event data.

Occurs for hierarchy rows with more than one child views.

C#
protected virtual void OnChildViewPrinting(object sender, ChildViewPrintingEventArgs e)
Parameters:senderobject

The print renderer that is currently printing the grid.

eChildViewPrintingEventArgs

The ChildViewPrintingEventArgs

Called when the column chooser item element is creating.

C#
protected virtual void OnColumnChooserItemElementCreating(object sender, ColumnChooserItemElementCreatingEventArgs e)
Parameters:senderobject

The sender.

eColumnChooserItemElementCreatingEventArgs

The ColumnChooserItemElementCreatingEventArgs instance containing the event data.

Called when the column width is changed.

C#
protected virtual void OnColumnWidthChanged(object sender, ColumnWidthChangedEventArgs args)
Parameters:senderobject

The sender.

argsColumnWidthChangedEventArgs

The ColumnWidthChangedEventArgs instance containing the event data.

Called when the column width is changing.

C#
protected virtual void OnColumnWidthChanging(object sender, ColumnWidthChangingEventArgs args)
Parameters:senderobject

The sender.

argsColumnWidthChangingEventArgs

The ColumnWidthChangingEventArgs instance containing the event data.

Called when the command cell is clicked.

C#
protected virtual void OnCommandCellClick(object sender, GridViewCellEventArgs args)
Parameters:senderobject

The sender.

argsGridViewCellEventArgs

The GridViewCellEventArgs instance containing the event data.

C#
protected virtual void OnConditionalFormattingFormShown(object sender, EventArgs e)
Parameters:senderobject

The sender.

eEventArgs

The EventArgs instance containing the event data.

Called when the context menu is opening.

C#
protected virtual void OnContextMenuOpening(object sender, ContextMenuOpeningEventArgs args)
Parameters:senderobject

The sender.

argsContextMenuOpeningEventArgs

The ContextMenuOpeningEventArgs instance containing the event data.

Called when RadGridView has prepared appropriate data formats that represent the copy selection, added the copy selection formats to a DataObject, and is ready to either place the DataObject on the Clipboard.

C#
protected virtual void OnCopying(object sender, GridViewClipboardEventArgs e)
Parameters:senderobject

The sender.

eGridViewClipboardEventArgs

The GridViewClipboardEventArgs instance containing the event data.

Called when the cell clipboard content is being copied.

C#
protected virtual void OnCopyingCellClipboardContent(object sender, GridViewCellValueEventArgs e)
Parameters:senderobject

The sender.

eGridViewCellValueEventArgs

The GridViewCellValueEventArgs instance containing the event data.

Raises the CreateCell event.

C#
protected virtual void OnCreateCell(object sender, GridViewCreateCellEventArgs e)
Parameters:senderobject

The owner control.

eGridViewCreateCellEventArgs

An instance of GridViewCreateCellEventArgs containing event data.

Raises the CreateCompositeFilterDialog event.

C#
protected virtual void OnCreateCompositeFilterDialog(object sender, GridViewCreateCompositeFilterDialogEventArgs e)
Parameters:senderobject

The sender.

eGridViewCreateCompositeFilterDialogEventArgs

The GridViewCreateCompositeFilterDialogEventArgs instance containing the event data.

Raises the CreateRow event.

C#
protected virtual void OnCreateRow(object sender, GridViewCreateRowEventArgs e)
Parameters:senderobject

The owner control.

eGridViewCreateRowEventArgs

An instance of GridViewCreateRowEventArgs containing event data.

Called when the row info is created.

C#
protected virtual void OnCreateRowInfo(object sender, GridViewCreateRowInfoEventArgs e)
Parameters:senderobject

The sender.

eGridViewCreateRowInfoEventArgs

The GridViewCreateRowInfoEventArgs instance containing the event data.

Called when the current cell is changed.

C#
protected virtual void OnCurrentCellChanged(object sender, CurrentCellChangedEventArgs e)
Parameters:senderobject

The sender.

eCurrentCellChangedEventArgs

The CurrentCellChangedEventArgs instance containing the event data.

Raises the CurrentColumnChanged event.

C#
protected virtual void OnCurrentColumnChanged(object sender, CurrentColumnChangedEventArgs e)
Parameters:senderobjecteCurrentColumnChangedEventArgs

A CurrentColumnChangedEventArgs that contains the event data.

Called when the current row is changed.

C#
protected virtual void OnCurrentRowChanged(object sender, CurrentRowChangedEventArgs e)
Parameters:senderobject

The sender.

eCurrentRowChangedEventArgs

The CurrentRowChangedEventArgs instance containing the event data.

Called when the current row is changing.

C#
protected virtual void OnCurrentRowChanging(object sender, CurrentRowChangingEventArgs e)
Parameters:senderobject

The sender.

eCurrentRowChangingEventArgs

The CurrentRowChangingEventArgs instance containing the event data.

Raises the CustomFiltering event.

C#
protected virtual void OnCustomFiltering(object sender, GridViewCustomFilteringEventArgs e)
Parameters:senderobject

The owner control.

eGridViewCustomFilteringEventArgs

An instance of GridViewCustomFilteringEventArgs containing event data.

Raises the CustomGrouping event.

C#
protected virtual void OnCustomGrouping(object sender, GridViewCustomGroupingEventArgs e)
Parameters:senderobject

The owner control.

eGridViewCustomGroupingEventArgs

An instance of GridViewCustomGroupingEventArgs containing event data.

Raises the CustomSorting event.

C#
protected virtual void OnCustomSorting(object sender, GridViewCustomSortingEventArgs e)
Parameters:senderobject

The owner control.

eGridViewCustomSortingEventArgs

An instance of GridViewCustomSortingEventArgs containing event data.

Raises the DataBindingComplete event.

C#
protected virtual void OnDataBindingComplete(object sender, GridViewBindingCompleteEventArgs e)
Parameters:senderobjecteGridViewBindingCompleteEventArgs

An GridViewBindingCompleteEventArgs instance that contains the event data.

Called when a data error occurs.

C#
protected virtual void OnDataError(object sender, GridViewDataErrorEventArgs e)
Parameters:senderobject

The sender.

eGridViewDataErrorEventArgs

The GridViewDataErrorEventArgs instance containing the event data.

Fires when the data group requires in virtual mode..

C#
protected virtual void OnDataGroupNeeded(object sender, GridViewDataGroupEventArgs e)
Parameters:senderobject

The sender.

eGridViewDataGroupEventArgs

The GridViewDataGroupEventArgs instance containing the event data.

Raises the DefaultValuesNeeded event.

C#
protected virtual void OnDefaultValuesNeeded(object sender, DefaultValuesNeededEventArgs e)
Parameters:senderobject

The owner control.

eDefaultValuesNeededEventArgs

An instance of DefaultValuesNeededEventArgs containing event data.

Fires when an element for editing a cell is showing.

C#
protected virtual void OnEditorRequired(object sender, EditorRequiredEventArgs e)
Parameters:senderobject

The sender.

eEditorRequiredEventArgs

The EditorRequiredEventArgs instance containing the event data.

Fires when a new expression editor form is created.

C#
protected virtual void OnExpressionEditorFormCreated(object sender, ExpressionEditorFormCreatedEventArgs e)
Parameters:senderobject

The sender.

eExpressionEditorFormCreatedEventArgs

The ExpressionEditorFormCreatedEventArgs instance containing the event data.

Fires when the filter is changed.

C#
protected void OnFilterChanged(object sender, GridViewCollectionChangedEventArgs e)
Parameters:senderobject

The sender.

eGridViewCollectionChangedEventArgs

The GridViewCollectionChangedEventArgs instance containing the event data.

Called when the filter is changing.

C#
protected void OnFilterChanging(object sender, GridViewCollectionChangingEventArgs e)
Parameters:senderobject

The sender.

eGridViewCollectionChangingEventArgs

The GridViewCollectionChangingEventArgs instance containing the event data.

Called when the filter expression is changed.

C#
protected void OnFilterExpressionChanged(object sender, FilterExpressionChangedEventArgs args)
Parameters:senderobject

The sender.

argsFilterExpressionChangedEventArgs

The FilterExpressionChangedEventArgs instance containing the event data.

Raises the FilterPopupInitialized event.

C#
protected virtual void OnFilterPopupInitialized(object sender, FilterPopupInitializedEventArgs e)
Parameters:senderobject

The sender.

eFilterPopupInitializedEventArgs

The FilterPopupInitializedEventArgs instance containing the event data.

Raises the FilterPopupRequired event.

C#
protected virtual void OnFilterPopupRequired(object sender, FilterPopupRequiredEventArgs e)
Parameters:senderobject

The sender.

eFilterPopupRequiredEventArgs

The FilterPopupRequiredEventArgs instance containing the event data.

Raises the GotFocus event.

C#
protected override void OnGotFocus(EventArgs e)
Parameters:eEventArgs

An EventArgs that contains the event data.

Overrides: RadControl.OnGotFocus(EventArgs)

Fires when grouping is changed.

C#
protected virtual void OnGroupByChanged(object sender, GridViewCollectionChangedEventArgs e)
Parameters:senderobject

The sender.

eGridViewCollectionChangedEventArgs

The GridViewCollectionChangedEventArgs instance containing the event data.

Fires when grouping is changing.

C#
protected virtual void OnGroupByChanging(object sender, GridViewCollectionChangingEventArgs e)
Parameters:senderobject

The sender.

eGridViewCollectionChangingEventArgs

The GridViewCollectionChangingEventArgs instance containing the event data.

Fires when the DataGroup is expanded or collapsed.

C#
protected virtual void OnGroupExpanded(object sender, GroupExpandedEventArgs e)
Parameters:senderobject

The sender.

eGroupExpandedEventArgs

The GroupExpandedEventArgs instance containing the event data.

Fires when the DataGroup is expanding or collapsing. This behavior is valid when grouping or hierarchy mode is applied.

C#
protected virtual void OnGroupExpanding(object sender, GroupExpandingEventArgs e)
Parameters:senderobject

The sender.

eGroupExpandingEventArgs

The GroupExpandingEventArgs instance containing the event data.

Fires after the user has changed the sorting of the group.

C#
protected virtual void OnGroupSortChanged(object sender, GridViewGroupSortChangedEventArgs e)
Parameters:senderobject

The sender.

eGridViewGroupSortChangedEventArgs

The GridViewGroupSortChangedEventArgs instance containing the event data.

Fires when the user changes the sorting of the group. The action can be canceled.

C#
protected virtual void OnGroupSortChanging(object sender, GridViewGroupSortChangingEventArgs e)
Parameters:senderobject

The sender.

eGridViewGroupSortChangingEventArgs

The GridViewGroupSortChangingEventArgs instance containing the event data.

Fires when evaluation of group summary is undergoing.

C#
protected virtual void OnGroupSummaryEvaluate(object sender, GroupSummaryEvaluationEventArgs e)
Parameters:senderobject

The sender.

eGroupSummaryEvaluationEventArgs

The GroupSummaryEvaluationEventArgs instance containing the event data.

Fires when a toggle state changed of RadCheckBoxElement in header cell.

C#
protected virtual void OnHeaderCellToggleStateChanged(object sender, GridViewHeaderCellEventArgs args)
Parameters:senderobject

The sender.

argsGridViewHeaderCellEventArgs

The GridViewHeaderCellEventArgs instance containing the event data.

Fires when a link from a GridViewHyperlinkColumn is opened.

C#
protected void OnHyperlinkOpened(object sender, HyperlinkOpenedEventArgs e)
Parameters:senderobject

The sender.

eHyperlinkOpenedEventArgs

The HyperlinkOpenedEventArgs instance containing the event data.

Called when the hyperlink is opening.

C#
protected void OnHyperlinkOpening(object sender, HyperlinkOpeningEventArgs e)
Parameters:senderobject

The sender.

eHyperlinkOpeningEventArgs

The HyperlinkOpeningEventArgs instance containing the event data.

Raises the KeyDown event.

C#
protected override void OnKeyDown(KeyEventArgs e)
Parameters:eKeyEventArgs

A KeyEventArgs that contains the event data.

Overrides: RadControl.OnKeyDown(KeyEventArgs)

Raises the event.

C#
protected override void OnKeyPress(KeyPressEventArgs e)
Parameters:eKeyPressEventArgs

The KeyPressEventArgs instance containing the event data.

Overrides: RadControl.OnKeyPress(KeyPressEventArgs)

Raises the KeyUp event.

C#
protected override void OnKeyUp(KeyEventArgs e)
Parameters:eKeyEventArgs

A KeyEventArgs that contains the event data.

Overrides: RadControl.OnKeyUp(KeyEventArgs)

Fires when the layout is loaded.

C#
protected void OnLayoutLoaded(object sender, LayoutLoadedEventArgs e)
Parameters:senderobject

The sender.

eLayoutLoadedEventArgs

The LayoutLoadedEventArgs instance containing the event data.

Notifies that the control is about to be visualized.

C#
protected override void OnLoad(Size desiredSize)
Parameters:desiredSizeSize

Overrides: RadControl.OnLoad(Size)

Raises the event.

C#
protected override void OnLostFocus(EventArgs e)
Parameters:eEventArgs

The EventArgs instance containing the event data.

Overrides: RadControl.OnLostFocus(EventArgs)

Raises the MouseClick event.

C#
protected override void OnMouseClick(MouseEventArgs e)
Parameters:eMouseEventArgs

An MouseEventArgs that contains the event data.

Overrides: Control.OnMouseClick(MouseEventArgs)

Raises the MouseDoubleClick event.

C#
protected override void OnMouseDoubleClick(MouseEventArgs e)
Parameters:eMouseEventArgs

An MouseEventArgs that contains the event data.

Overrides: Control.OnMouseDoubleClick(MouseEventArgs)

Raises the event.

C#
protected override void OnMouseDown(MouseEventArgs e)
Parameters:eMouseEventArgs

The MouseEventArgs instance containing the event data.

Overrides: RadControl.OnMouseDown(MouseEventArgs)

Raises the event.

C#
protected override void OnMouseEnter(EventArgs e)
Parameters:eEventArgs

The EventArgs instance containing the event data.

Overrides: RadControl.OnMouseEnter(EventArgs)

Raises the event.

C#
protected override void OnMouseLeave(EventArgs e)
Parameters:eEventArgs

The EventArgs instance containing the event data.

Overrides: RadControl.OnMouseLeave(EventArgs)

Raises the MouseMove event.

C#
protected override void OnMouseMove(MouseEventArgs e)
Parameters:eMouseEventArgs

A MouseEventArgs that contains the event data.

Overrides: RadControl.OnMouseMove(MouseEventArgs)

Raises the MouseUp event.

C#
protected override void OnMouseUp(MouseEventArgs e)
Parameters:eMouseEventArgs

A MouseEventArgs that contains the event data.

Overrides: RadControl.OnMouseUp(MouseEventArgs)

Raises the MouseWheel event.

C#
protected override void OnMouseWheel(MouseEventArgs e)
Parameters:eMouseEventArgs

A MouseEventArgs that contains the event data.

Overrides: RadControl.OnMouseWheel(MouseEventArgs)

Fires when the unbound cell requires a value for a cell in order to format and display the cell.

C#
protected virtual void OnNewRowNeeded(object sender, GridViewRowEventArgs e)
Parameters:senderobject

The sender.

eGridViewRowEventArgs

The GridViewRowEventArgs instance containing the event data.

Fires when the current page is changed.

C#
protected virtual void OnPageChanged(object sender, EventArgs e)
Parameters:senderobject

The sender.

eEventArgs

The EventArgs instance containing the event data.

Fires when the current page is changing.

C#
protected virtual void OnPageChanging(object sender, PageChangingEventArgs e)
Parameters:senderobject

The sender.

ePageChangingEventArgs

The PageChangingEventArgs instance containing the event data.

Occurs when the RadGridView is ready to paste data.

C#
protected virtual void OnPasting(object sender, GridViewClipboardEventArgs e)
Parameters:senderobject

The sender.

eGridViewClipboardEventArgs

The GridViewClipboardEventArgs instance containing the event data.

Occurs when the RadGridView is ready to paste data to individual cells.

C#
protected virtual void OnPastingCellClipboardContent(object sender, GridViewCellValueEventArgs e)
Parameters:senderobject

The sender.

eGridViewCellValueEventArgs

The GridViewCellValueEventArgs instance containing the event data.

Raises the PrintCellFormatting event

C#
protected virtual void OnPrintCellFormatting(object sender, PrintCellFormattingEventArgs e)
Parameters:senderobject

The grid cell that needs formatting.

ePrintCellFormattingEventArgs

A PrintCellFormattingEventArgsinstance containing event data.

Raises the PrintCellPaint event

C#
protected virtual void OnPrintCellPaint(object sender, PrintCellPaintEventArgs e)
Parameters:senderobject

The grid cell that is painted.

ePrintCellPaintEventArgs

A PrintCellPaintEventArgsinstance containing event data.

Raises the Resize event.

C#
protected override void OnResize(EventArgs e)
Parameters:eEventArgs

An EventArgs that contains the event data.

Overrides: Control.OnResize(EventArgs)

Fires when an unbound cell requires a value for a cell in order to format and display the cell.

C#
protected virtual void OnRowDirtyStateNeeded(object sender, QuestionEventArgs e)
Parameters:senderobject

The sender.

eQuestionEventArgs

The QuestionEventArgs instance containing the event data.

Raises the RowFormatting event.

C#
protected void OnRowFormatting(object sender, RowFormattingEventArgs e)
Parameters:senderobject

The row that needs formatting.

eRowFormattingEventArgs

A RowFormattingEventArgs instance containing event data.

Fires after the height of a row changes.

C#
protected virtual void OnRowHeightChanged(object sender, RowHeightChangedEventArgs args)
Parameters:senderobject

The sender.

argsRowHeightChangedEventArgs

The RowHeightChangedEventArgs instance containing the event data.

Fires before the height of a row changes.

C#
protected virtual void OnRowHeightChanging(object sender, RowHeightChangingEventArgs args)
Parameters:senderobject

The sender.

argsRowHeightChangingEventArgs

The RowHeightChangingEventArgs instance containing the event data.

Fires after the IsVisible property of a row changes.

C#
protected virtual void OnRowIsVisibleChanged(object sender, EventArgs e)
Parameters:senderobject

The sender.

eEventArgs

The EventArgs instance containing the event data.

Raises the RowMouseMove event.

C#
protected void OnRowMouseMove(object sender, MouseEventArgs e)
Parameters:senderobject

The row under the mouse pointer.

eMouseEventArgs

A MouseEventArgs instance containing event data.

Raises the RowPaint event.

C#
protected virtual void OnRowPaint(object sender, GridViewRowPaintEventArgs e)
Parameters:senderobject

The owner control.

eGridViewRowPaintEventArgs

An instance of GridViewRowPaintEventArgs containing event data.

Fires when the Rows collection of a GridViewTemplate changes.

C#
protected virtual void OnRowsChanged(object sender, GridViewCollectionChangedEventArgs args)
Parameters:senderobject

The sender.

argsGridViewCollectionChangedEventArgs

The GridViewCollectionChangedEventArgs instance containing the event data.

Fires before the Rows collection of a GridViewTemplate changes.

C#
protected virtual void OnRowsChanging(object sender, GridViewCollectionChangingEventArgs args)
Parameters:senderobject

The sender.

argsGridViewCollectionChangingEventArgs

The GridViewCollectionChangingEventArgs instance containing the event data.

Fires the RowSourceNeeded event.

C#
protected virtual void OnRowSourceNeeded(object sender, GridViewRowSourceNeededEventArgs e)
Parameters:senderobject

The sender.

eGridViewRowSourceNeededEventArgs

The GridViewRowSourceNeededEventArgs instance containing the event data.

Raises the RowValidated event.

C#
protected virtual void OnRowValidated(object sender, RowValidatedEventArgs e)
Parameters:senderobjecteRowValidatedEventArgs

An instance of RowValidatedEventArgs containing event data.

Raises the RowValidating event.

C#
protected virtual void OnRowValidating(object sender, RowValidatingEventArgs e)
Parameters:senderobjecteRowValidatingEventArgs

An instance of RowValidatingEventArgs containing event data.

Fires when the current selection changes.

C#
protected virtual void OnSelectionChanged(object sender, EventArgs e)
Parameters:senderobject

The sender.

eEventArgs

The EventArgs instance containing the event data.

Fires when the current selection is changing.

C#
protected virtual void OnSelectionChanging(object sender, GridViewSelectionCancelEventArgs e)
Parameters:senderobject

The sender.

eGridViewSelectionCancelEventArgs

The GridViewSelectionCancelEventArgs instance containing the event data.

Fires when sorting is changed.

C#
protected virtual void OnSortChanged(object sender, GridViewCollectionChangedEventArgs e)
Parameters:senderobject

The sender.

eGridViewCollectionChangedEventArgs

The GridViewCollectionChangedEventArgs instance containing the event data.

Fires when sorting is changing.

C#
protected virtual void OnSortChanging(object sender, GridViewCollectionChangingEventArgs e)
Parameters:senderobject

The sender.

eGridViewCollectionChangingEventArgs

The GridViewCollectionChangingEventArgs instance containing the event data.

Occurs when the user has finished adding a row to the RadGridView.

C#
protected virtual void OnUserAddedRow(object sender, GridViewRowEventArgs e)
Parameters:senderobject

The sender.

eGridViewRowEventArgs

The GridViewRowEventArgs instance containing the event data.

Occurs when the user adding new row to the RadGridView.

C#
protected virtual void OnUserAddingRow(object sender, GridViewRowCancelEventArgs e)
Parameters:senderobject

The sender.

eGridViewRowCancelEventArgs

The GridViewRowCancelEventArgs instance containing the event data.

Occurs when the user has finished deleting a row from the RadGridView.

C#
protected virtual void OnUserDeletedRow(object sender, GridViewRowEventArgs e)
Parameters:senderobject

The sender.

eGridViewRowEventArgs

The GridViewRowEventArgs instance containing the event data.

Occurs when the user deletes a row from the RadGridView.

C#
protected virtual void OnUserDeletingRow(object sender, GridViewRowCancelEventArgs e)
Parameters:senderobject

The sender.

eGridViewRowCancelEventArgs

The GridViewRowCancelEventArgs instance containing the event data.

Raises the Validated event.

C#
protected override void OnValidated(EventArgs e)
Parameters:eEventArgs

An EventArgs that contains the event data.

Overrides: Control.OnValidated(EventArgs)

Raises the Validating event.

C#
protected override void OnValidating(CancelEventArgs e)
Parameters:eCancelEventArgs

A CancelEventArgs that contains the event data.

Overrides: Control.OnValidating(CancelEventArgs)

Fires when the value of a cell changes.

C#
protected virtual void OnValueChanged(object sender, EventArgs e)
Parameters:senderobject

The sender.

eEventArgs

The EventArgs instance containing the event data.

Fires before the value in a cell is changing.

C#
protected virtual void OnValueChanging(object sender, ValueChangingEventArgs e)
Parameters:senderobject

The sender.

eValueChangingEventArgs

The ValueChangingEventArgs instance containing the event data.

Raises the ViewCellFormatting event

C#
protected void OnViewCellFormatting(object sender, CellFormattingEventArgs e)
Parameters:senderobject

The grid cell that needs formatting.

eCellFormattingEventArgs

A CellFormattingEventArgsinstance containing event data.

Raises the ViewRowFormatting event.

C#
protected void OnViewRowFormatting(object sender, RowFormattingEventArgs e)
Parameters:senderobject

The row that needs formatting.

eRowFormattingEventArgs

A RowFormattingEventArgs instance containing event data.

Paste the contents of the System.Windows.Forms.Clipboard to the current view.

C#
public virtual void Paste()

Directly prints the RadGridView to the default printer without showing a print dialog.

C#
public virtual void Print()

Directly prints the RadGridView to the default printer or shows printer settings and then prints the RadGridView.

C#
public virtual void Print(bool showPrinterSettings, RadPrintDocument document)
Parameters:showPrinterSettingsbool

Indicates whether printer settings dialog should be shown.

documentRadPrintDocument

As instance of RadPrintDocument used to control the print process.

Directly prints the RadGridView to the default printer or shows printer settings and then prints the RadGridView.

C#
public virtual void Print(bool showPrinterSettings)
Parameters:showPrinterSettingsbool

Indicates whether printer settings dialog should be shown.

Shows a print preview dialog for editing the RadGridView print settings and previewing how the grid will appear when printed.

C#
public virtual void PrintPreview()

Shows a print preview dialog for editing the RadGridView print settings and previewing how the grid will appear when printed, using the provided print document.

C#
public virtual void PrintPreview(RadPrintDocument document)
Parameters:documentRadPrintDocument

An instance of RadPrintDocument used to control the print process.

Processes the coded UI message.

C#
protected override void ProcessCodedUIMessage(ref IPCMessage request)
Parameters:requestIPCMessage

The request.

Overrides: RadControl.ProcessCodedUIMessage(ref IPCMessage)

Processes a dialog key.

C#
protected override bool ProcessDialogKey(Keys keyData)
Parameters:keyDataKeys

One of the Keys values that represents the key to process.

Returns:

bool

true if the key was processed by the control; otherwise, false.

Overrides: Control.ProcessDialogKey(Keys)

Stores to a stream RadGridView properties, sub-objects and their properties in XML format, using the serialization information provided by the XmlSerializationInfo property

C#
public virtual void SaveLayout(Stream stream)
Parameters:streamStream

Stores to a file RadGridView properties, sub-objects and their properties in XML format, using the serialization information provided by the XmlSerializationInfo property

C#
public virtual void SaveLayout(string fileName)
Parameters:fileNamestring

Stores RadGridView properties, sub-objects and their properties in XML format, using the serialization information provided by the XmlSerializationInfo property

C#
public virtual void SaveLayout(XmlWriter xmlWriter)
Parameters:xmlWriterXmlWriter

XmlWriter to use by the built-in serializer

Select all cells (rows) in RadGriView

C#
public void SelectAll()

Shows the GridViewColumnChooser for the columns of the master view template.

C#
public void ShowColumnChooser()
C#
public void ShowColumnChooser(GridViewTemplate template)
Parameters:templateGridViewTemplate

The template which columns will be shown for.

Unsubscribe from the handled events.

C#
protected virtual void UnWireEvents()

Subscribe to events handling the basic features in RadGridView.

C#
protected virtual void WireEvents()

Processes Windows messages.

C#
protected override void WndProc(ref Message m)
Parameters:mMessage

The Windows Message to process.

Overrides: RadControl.WndProc(ref Message)

Events

Fires each time a new column is automatically generated and is about to be added to the columns of RadGridView. Occurs one time for each public, non-static property in the bound data type when the DataSource property is changed and the AutoGenerateColumns property is true.

C#
[Browsable(true)]
public event GridViewAutoGeneratingColumnEventHandler AutoGeneratingColumn

Fires when the cell is entering edit mode. The action can be canceled.

C#
[Browsable(true)]
public event GridViewCellCancelEventHandler CellBeginEdit

Fires when a cell is clicked.

C#
[Browsable(true)]
public event GridViewCellEventHandler CellClick

Fires when a cell is double clicked.

C#
[Browsable(true)]
public event GridViewCellEventHandler CellDoubleClick

Fires when an element for editing a cell is initialized and visible.

C#
[Browsable(true)]
public event GridViewCellEventHandler CellEditorInitialized

Fires when the cell editing is finished.

C#
[Browsable(true)]
public event GridViewCellEventHandler CellEndEdit

Fires when the content of a data cell needs to be formatted for display.

C#
[Browsable(true)]
public event CellFormattingEventHandler CellFormatting

Fires when the two neighbor cells are compared and about to be merged.

C#
[Browsable(true)]
public event GridViewCellMergingEventHandler CellMerging

Fires when the mouse pointer moves over the cell.

C#
[Browsable(true)]
public event CellMouseMoveEventHandler CellMouseMove

Fires when a cell needs to be painted.

C#
[Browsable(true)]
public event GridViewCellPaintEventHandler CellPaint

Fires when a row has finished validating.

C#
public event CellValidatedEventHandler CellValidated

Fires when Cell is validating.

C#
public event CellValidatingEventHandler CellValidating

Fires when the value of a cell changes.

C#
[Browsable(true)]
public event GridViewCellEventHandler CellValueChanged

Fires when the unbound cell requires a value for a cell in order to format and display the cell.

C#
[Browsable(true)]
public event GridViewCellValueEventHandler CellValueNeeded

Fires when the unbound cell changed and requires storage in the underlying data source.

C#
[Browsable(true)]
public event GridViewCellValueEventHandler CellValuePushed

Fires when the child view is expanded or collapsed.

C#
[Browsable(true)]
public event ChildViewExpandedEventHandler ChildViewExpanded

Fires when the child view is expanded or collapsed.

C#
[Browsable(true)]
public event ChildViewExpandingEventHandler ChildViewExpanding

Fires for hierarchy rows with more than one child views.

C#
[Browsable(true)]
public event ChildViewPrintingEventHandler ChildViewPrinting

Fires when a ColumnChooserCreated is created.

C#
[Browsable(true)]
public event ColumnChooserCreatedEventHandler ColumnChooserCreated

Fires when a new column chooser item element is being created.

C#
[Browsable(true)]
public event ColumnChooserItemElementCreatingEventHandler ColumnChooserItemElementCreating

Fires when the width of a column changes.

C#
[Browsable(true)]
public event ColumnWidthChangedEventHandler ColumnWidthChanged

Fires before the width of a column changes.

C#
[Browsable(true)]
public event ColumnWidthChangingEventHandler ColumnWidthChanging

Fires when a command cell is clicked.

C#
[Browsable(true)]
public event CommandCellClickEventHandler CommandCellClick
C#
public event EventHandler ConditionalFormattingFormShown

Fires before a context menu is shown.

C#
[Browsable(true)]
public event ContextMenuOpeningEventHandler ContextMenuOpening

Occurs when the RadGridView has prepared appropriate data formats that represent the copy selection, added the copy selection formats to a DataObject, and is ready to either place the DataObject on the Clipboard.

C#
[Browsable(true)]
public event GridViewClipboardEventHandler Copying

Occurs when the RadGridView prepares each cell's value to be placed on the Clipboard.

C#
[Browsable(true)]
public event GridViewCellValueEventHandler CopyingCellClipboardContent

Fires when a cell needs to be created.

C#
[Browsable(true)]
public event GridViewCreateCellEventHandler CreateCell

Occurs when a composite filter dialog is being created.

C#
[Browsable(true)]
public event GridViewCreateCompositeFilterDialogEventHandler CreateCompositeFilterDialog

Fires when a row needs to be created.

C#
[Browsable(true)]
public event GridViewCreateRowEventHandler CreateRow

Occurs when the instance of GridViewRowInfo is created.

C#
public event GridViewCreateRowInfoEventHandler CreateRowInfo

Fires after the current cell has changed.

C#
[Browsable(true)]
public event CurrentCellChangedEventHandler CurrentCellChanged

Fires when the current column has changed.

C#
[Browsable(true)]
public event CurrentColumnChangedEventHandler CurrentColumnChanged

Fires when current row is changed.

C#
[Browsable(true)]
public event CurrentRowChangedEventHandler CurrentRowChanged

Fires when the current row is changing. The action can be canceled.

C#
[Browsable(true)]
public event CurrentRowChangingEventHandler CurrentRowChanging

Fires when the current view in RadGridView has changed.

C#
[Browsable(true)]
public event GridViewCurrentViewChangedEventHandler CurrentViewChanged

Fires for custom filtering operation.

C#
[Browsable(true)]
public event GridViewCustomFilteringEventHandler CustomFiltering

Fires for custom grouping operation.

C#
[Browsable(true)]
public event GridViewCustomGroupingEventHandler CustomGrouping

Fires for custom sorting operation.

C#
[Browsable(true)]
public event GridViewCustomSortingEventHandler CustomSorting

Fires after data binding operation has finished.

C#
[Browsable(true)]
public event GridViewBindingCompleteEventHandler DataBindingComplete

Fires when an external data-parsing or validation operation throws an exception, or when an attempt to commit data to a data source fails.

C#
[Browsable(true)]
public event GridViewDataErrorEventHandler DataError

Fires when the data group is required in virtual mode.

C#
[Browsable(true)]
public event GridViewDataGroupEventHandler DataGroupNeeded

Fires when the user enters the row for new records, so that it can be populated with default values.

C#
[Browsable(true)]
public event GridViewRowEventHandler DefaultValuesNeeded

Fires after CellBeginEdit.

C#
[Browsable(true)]
public event EditorRequiredEventHandler EditorRequired

Fires when a new expression editor form is created.

C#
[Browsable(true)]
public event ExpressionEditorFormCreatedEventHandler ExpressionEditorFormCreated

Occurs when the filter is changed.

C#
[Browsable(true)]
public event GridViewCollectionChangedEventHandler FilterChanged

Occurs when the filter is changing.

C#
[Browsable(true)]
public event GridViewCollectionChangingEventHandler FilterChanging

Occurs when the filter expression is changed.

C#
[Browsable(true)]
public event GridViewFilterExpressionChangedEventHandler FilterExpressionChanged

Occurs when the filter popup has been initialized.

C#
[Browsable(true)]
public event FilterPopupInitializedEventHandler FilterPopupInitialized

Occurs when a filter popup is required.

C#
[Browsable(true)]
public event FilterPopupRequiredEventHandler FilterPopupRequired

Fires when grouping is changed.

C#
public event GridViewCollectionChangedEventHandler GroupByChanged

Fires when grouping is changing. The action can be canceled.

C#
public event GridViewCollectionChangingEventHandler GroupByChanging

Fires when the DataGroup is expanded or collapsed.

C#
[Browsable(true)]
public event GroupExpandedEventHandler GroupExpanded

Fires when the DataGroup is expanding or collapsing. This behavior is valid when grouping or hierarchy mode is applied.

C#
[Browsable(true)]
public event GroupExpandingEventHandler GroupExpanding

Fires after the user has changed the sorting of the group.

C#
public event GridViewGroupSortChangedEventHandler GroupSortChanged

Fires when the user changes the sorting of the group. The action can be canceled.

C#
public event GridViewGroupSortChangingEventHandler GroupSortChanging

Fires when evaluation of group summary is undergoing.

C#
[Browsable(true)]
public event GroupSummaryEvaluateEventHandler GroupSummaryEvaluate
Remarks:

Allows modification of the result by providing access to the currently evaluated value and the data group.

Fires when a toggle state changed of RadCheckBoxElement in header cell.

C#
[Browsable(true)]
public event HeaderCellToggleStateChangedEventHandler HeaderCellToggleStateChanged

Occurs when the hyperlink is opened.

C#
public event HyperlinkOpenedEventHandler HyperlinkOpened

Occurs when the hyperlink is opening.

C#
public event HyperlinkOpeningEventHandler HyperlinkOpening

Occurs when the layout is loaded.

C#
[Browsable(true)]
public event LayoutLoadedEventHandler LayoutLoaded

Fires after the current page has changed.

C#
[Browsable(true)]
public event EventHandler<EventArgs> PageChanged

Fires when the current page is changing.

C#
[Browsable(true)]
public event EventHandler<PageChangingEventArgs> PageChanging

Occurs when the RadGridView is ready to paste data.

C#
[Browsable(true)]
public event GridViewClipboardEventHandler Pasting

Occurs when the RadGridView is ready to paste data to individual cells.

C#
[Browsable(true)]
public event GridViewCellValueEventHandler PastingCellClipboardContent

Fires when the content of any grid cell needs to be formatted for printing.

C#
[Browsable(true)]
public event PrintCellFormattingEventHandler PrintCellFormatting

Fires when the content of any grid cell needs to be formatted for printing.

C#
[Browsable(true)]
public event PrintCellPaintEventHandler PrintCellPaint

Fires when a data row is invalidated and needs to be formatted.

C#
[Browsable(true)]
public event RowFormattingEventHandler RowFormatting

Fires after the height of a row changes.

C#
[Browsable(true)]
public event RowHeightChangedEventHandler RowHeightChanged

Fires before the height of a row changes.

C#
[Browsable(true)]
public event RowHeightChangingEventHandler RowHeightChanging

Fires when the mouse pointer moves over a row.

C#
[Browsable(true)]
public event RowMouseMoveEventHandler RowMouseMove

Fires when a row needs to be painted.

C#
[Browsable(true)]
public event GridViewRowPaintEventHandler RowPaint

Fires when the Rows collection of a GridViewTemplate changes.

C#
[Browsable(true)]
public event GridViewCollectionChangedEventHandler RowsChanged

Fires before the Rows collection of a GridViewTemplate changes.

C#
[Browsable(true)]
public event GridViewCollectionChangingEventHandler RowsChanging

Provides data for the parent row in RadGridView Hierarchy Mode

C#
[Browsable(true)]
public event GridViewRowSourceNeededEventHandler RowSourceNeeded

Fires when a row is validated.

C#
public event RowValidatedEventHandler RowValidated

Fires before a row is validated.

C#
public event RowValidatingEventHandler RowValidating

Fires when the current selection is changed.

C#
[Browsable(true)]
public event EventHandler SelectionChanged

Fires when the current selection is changing.

C#
[Browsable(true)]
public event GridViewSelectionCancelEventHandler SelectionChanging

Fires when the sorting is changed.

C#
public event GridViewCollectionChangedEventHandler SortChanged

Fires when the sorting is changing. The action can be canceled.

C#
public event GridViewCollectionChangingEventHandler SortChanging

Occurs when the user has finished adding a row to the RadGridView

C#
[Browsable(true)]
public event GridViewRowEventHandler UserAddedRow

Occurs when the user adding new row to the RadGridView

C#
[Browsable(true)]
public event GridViewRowCancelEventHandler UserAddingRow

Occurs when the user has finished deleting a row from the RadGridView.

C#
[Browsable(true)]
public event GridViewRowEventHandler UserDeletedRow

Occurs when the user deletes a row from the RadGridView.

C#
[Browsable(true)]
public event GridViewRowCancelEventHandler UserDeletingRow

Fires when the value of an editor changes.

C#
[Browsable(true)]
public event EventHandler ValueChanged

Fires before the value in an editor is being changed. The action can be canceled.

C#
[Browsable(true)]
public event ValueChangingEventHandler ValueChanging

Fires when the content of any grid cell needs to be formatted for display.

C#
[Browsable(true)]
public event CellFormattingEventHandler ViewCellFormatting

Fires when a grid row is invalidated and needs to be formatted.

C#
[Browsable(true)]
public event RowFormattingEventHandler ViewRowFormatting
In this article
DefinitionConstructorsRadGridView()PropertiesActiveEditorAddNewRowPositionAllowAddNewRowAllowAutoSizeColumnsAllowCellContextMenuAllowColumnChooserAllowColumnHeaderContextMenuAllowColumnReorderAllowColumnResizeAllowDeleteRowAllowDragToGroupAllowEditRowAllowMultiColumnSortingAllowRowHeaderContextMenuAllowRowReorderAllowRowResizeAllowSearchRowAutoExpandGroupsAutoGenerateColumnsAutoGenerateHierarchyAutoSizeAutoSizeColumnsModeAutoSizeRowsBeginEditModeBottomPinnedRowsModeCaseSensitiveChildRowsChildViewTabsPositionClipboardCopyModeClipboardCutModeClipboardPasteModeCloseEditorWhenValidationFailsColumnChooserColumnChooserSortOrderColumnCountColumnsContextMenuManagerCurrentCellCurrentCellAddressCurrentColumnCurrentRowCurrentViewDataMemberDataSourceDefaultSizeEditorManagerEnableAlternatingRowColorEnableCustomDrawingEnableCustomFilteringEnableCustomGroupingEnableCustomSortingEnableFastScrollingEnableFilteringEnableGroupingEnableHotTrackingEnableKineticScrollingEnablePagingEnableSortingEnableUIAutomationEnterKeyModeFilterDescriptorsGridBehaviorGridNavigatorGridViewElementGroupDescriptorsGroupExpandAnimationTypeGroupsHideSelectionHorizontalScrollStateIsDisposingIsInEditModeMasterTemplateMasterViewMergeCellsEditModeMergeCellsModeMultiSelectNewRowEnterKeyModePageSizePrintSettingsDialogFactoryPrintStyleReadOnlyRelationsRowCountRowsSearchRowPositionSelectedCellsSelectedRowsSelectionModeShowCellErrorsShowChildViewCaptionsShowCollapsedGroupSummariesShowColumnHeadersShowFilteringRowShowGroupedColumnsShowGroupPanelShowGroupPanelScrollbarsShowHeaderCellButtonsShowNoDataTextShowRowErrorsShowRowHeaderColumnShowSelectColumnSortDescriptorsSplitModeStandardTabSummaryRowsBottomSummaryRowsTopSynchronizeCurrentRowInSplitModeTableElementTemplatesTitlePositionTitleTextUseScrollbarsInHierarchyVerticalScrollStateViewDefinitionVirtualModeXmlSerializationInfoMethodsBeginEdit()BeginInit()BeginUpdate()BestFitColumns()BestFitColumns(BestFitColumnMode)CancelEdit()ClearSelection()CloseEditor()ControlDefinesThemeForElement(RadElement)Copy()CreateAccessibilityInstance()CreateChildItems(RadElement)CreateGridViewElement()CreateGridViewLayoutSerializer(ComponentXmlSerializationInfo)Cut()DeferRefresh()DisplayedColumnCount(bool)DisplayedRowCount(bool)Dispose(bool)EndEdit()EndInit()EndUpdate()EndUpdate(bool)Evaluate(string, IEnumerable<GridViewRowInfo>)GetClipboardContent()GetDefaultXmlSerializationInfo()HideColumnChooser()InvalidateMultiSelection()IsInputKey(Keys)LoadFrom(IDataReader)LoadLayout(Stream)LoadLayout(string)LoadLayout(XmlReader)OnAutoGeneratingColumn(object, GridViewAutoGeneratingColumnEventArgs)OnBindingContextChanged(EventArgs)OnCancelRowEdit(object, QuestionEventArgs)OnCellBeginEdit(object, GridViewCellCancelEventArgs)OnCellClick(object, GridViewCellEventArgs)OnCellDoubleClick(object, GridViewCellEventArgs)OnCellEditorInitialized(object, GridViewCellEventArgs)OnCellEndEdit(object, GridViewCellEventArgs)OnCellFormatting(object, CellFormattingEventArgs)OnCellMerging(GridViewCellMergingEventArgs)OnCellMouseMove(object, MouseEventArgs)OnCellPaint(object, GridViewCellPaintEventArgs)OnCellValidated(object, CellValidatedEventArgs)OnCellValidating(object, CellValidatingEventArgs)OnCellValueChanged(object, GridViewCellEventArgs)OnCellValueNeeded(object, GridViewCellValueEventArgs)OnCellValuePushed(object, GridViewCellValueEventArgs)OnChildViewExpanded(object, ChildViewExpandedEventArgs)OnChildViewExpanding(object, ChildViewExpandingEventArgs)OnChildViewPrinting(object, ChildViewPrintingEventArgs)OnColumnChooserItemElementCreating(object, ColumnChooserItemElementCreatingEventArgs)OnColumnWidthChanged(object, ColumnWidthChangedEventArgs)OnColumnWidthChanging(object, ColumnWidthChangingEventArgs)OnCommandCellClick(object, GridViewCellEventArgs)OnConditionalFormattingFormShown(object, EventArgs)OnContextMenuOpening(object, ContextMenuOpeningEventArgs)OnCopying(object, GridViewClipboardEventArgs)OnCopyingCellClipboardContent(object, GridViewCellValueEventArgs)OnCreateCell(object, GridViewCreateCellEventArgs)OnCreateCompositeFilterDialog(object, GridViewCreateCompositeFilterDialogEventArgs)OnCreateRow(object, GridViewCreateRowEventArgs)OnCreateRowInfo(object, GridViewCreateRowInfoEventArgs)OnCurrentCellChanged(object, CurrentCellChangedEventArgs)OnCurrentColumnChanged(object, CurrentColumnChangedEventArgs)OnCurrentRowChanged(object, CurrentRowChangedEventArgs)OnCurrentRowChanging(object, CurrentRowChangingEventArgs)OnCustomFiltering(object, GridViewCustomFilteringEventArgs)OnCustomGrouping(object, GridViewCustomGroupingEventArgs)OnCustomSorting(object, GridViewCustomSortingEventArgs)OnDataBindingComplete(object, GridViewBindingCompleteEventArgs)OnDataError(object, GridViewDataErrorEventArgs)OnDataGroupNeeded(object, GridViewDataGroupEventArgs)OnDefaultValuesNeeded(object, DefaultValuesNeededEventArgs)OnEditorRequired(object, EditorRequiredEventArgs)OnExpressionEditorFormCreated(object, ExpressionEditorFormCreatedEventArgs)OnFilterChanged(object, GridViewCollectionChangedEventArgs)OnFilterChanging(object, GridViewCollectionChangingEventArgs)OnFilterExpressionChanged(object, FilterExpressionChangedEventArgs)OnFilterPopupInitialized(object, FilterPopupInitializedEventArgs)OnFilterPopupRequired(object, FilterPopupRequiredEventArgs)OnGotFocus(EventArgs)OnGroupByChanged(object, GridViewCollectionChangedEventArgs)OnGroupByChanging(object, GridViewCollectionChangingEventArgs)OnGroupExpanded(object, GroupExpandedEventArgs)OnGroupExpanding(object, GroupExpandingEventArgs)OnGroupSortChanged(object, GridViewGroupSortChangedEventArgs)OnGroupSortChanging(object, GridViewGroupSortChangingEventArgs)OnGroupSummaryEvaluate(object, GroupSummaryEvaluationEventArgs)OnHeaderCellToggleStateChanged(object, GridViewHeaderCellEventArgs)OnHyperlinkOpened(object, HyperlinkOpenedEventArgs)OnHyperlinkOpening(object, HyperlinkOpeningEventArgs)OnKeyDown(KeyEventArgs)OnKeyPress(KeyPressEventArgs)OnKeyUp(KeyEventArgs)OnLayoutLoaded(object, LayoutLoadedEventArgs)OnLoad(Size)OnLostFocus(EventArgs)OnMouseClick(MouseEventArgs)OnMouseDoubleClick(MouseEventArgs)OnMouseDown(MouseEventArgs)OnMouseEnter(EventArgs)OnMouseLeave(EventArgs)OnMouseMove(MouseEventArgs)OnMouseUp(MouseEventArgs)OnMouseWheel(MouseEventArgs)OnNewRowNeeded(object, GridViewRowEventArgs)OnPageChanged(object, EventArgs)OnPageChanging(object, PageChangingEventArgs)OnPasting(object, GridViewClipboardEventArgs)OnPastingCellClipboardContent(object, GridViewCellValueEventArgs)OnPrintCellFormatting(object, PrintCellFormattingEventArgs)OnPrintCellPaint(object, PrintCellPaintEventArgs)OnResize(EventArgs)OnRowDirtyStateNeeded(object, QuestionEventArgs)OnRowFormatting(object, RowFormattingEventArgs)OnRowHeightChanged(object, RowHeightChangedEventArgs)OnRowHeightChanging(object, RowHeightChangingEventArgs)OnRowIsVisibleChanged(object, EventArgs)OnRowMouseMove(object, MouseEventArgs)OnRowPaint(object, GridViewRowPaintEventArgs)OnRowsChanged(object, GridViewCollectionChangedEventArgs)OnRowsChanging(object, GridViewCollectionChangingEventArgs)OnRowSourceNeeded(object, GridViewRowSourceNeededEventArgs)OnRowValidated(object, RowValidatedEventArgs)OnRowValidating(object, RowValidatingEventArgs)OnSelectionChanged(object, EventArgs)OnSelectionChanging(object, GridViewSelectionCancelEventArgs)OnSortChanged(object, GridViewCollectionChangedEventArgs)OnSortChanging(object, GridViewCollectionChangingEventArgs)OnUserAddedRow(object, GridViewRowEventArgs)OnUserAddingRow(object, GridViewRowCancelEventArgs)OnUserDeletedRow(object, GridViewRowEventArgs)OnUserDeletingRow(object, GridViewRowCancelEventArgs)OnValidated(EventArgs)OnValidating(CancelEventArgs)OnValueChanged(object, EventArgs)OnValueChanging(object, ValueChangingEventArgs)OnViewCellFormatting(object, CellFormattingEventArgs)OnViewRowFormatting(object, RowFormattingEventArgs)Paste()Print()Print(bool, RadPrintDocument)Print(bool)PrintPreview()PrintPreview(RadPrintDocument)ProcessCodedUIMessage(ref IPCMessage)ProcessDialogKey(Keys)SaveLayout(Stream)SaveLayout(string)SaveLayout(XmlWriter)SelectAll()ShowColumnChooser()ShowColumnChooser(GridViewTemplate)UnWireEvents()WireEvents()WndProc(ref Message)EventsAutoGeneratingColumnCellBeginEditCellClickCellDoubleClickCellEditorInitializedCellEndEditCellFormattingCellMergingCellMouseMoveCellPaintCellValidatedCellValidatingCellValueChangedCellValueNeededCellValuePushedChildViewExpandedChildViewExpandingChildViewPrintingColumnChooserCreatedColumnChooserItemElementCreatingColumnWidthChangedColumnWidthChangingCommandCellClickConditionalFormattingFormShownContextMenuOpeningCopyingCopyingCellClipboardContentCreateCellCreateCompositeFilterDialogCreateRowCreateRowInfoCurrentCellChangedCurrentColumnChangedCurrentRowChangedCurrentRowChangingCurrentViewChangedCustomFilteringCustomGroupingCustomSortingDataBindingCompleteDataErrorDataGroupNeededDefaultValuesNeededEditorRequiredExpressionEditorFormCreatedFilterChangedFilterChangingFilterExpressionChangedFilterPopupInitializedFilterPopupRequiredGroupByChangedGroupByChangingGroupExpandedGroupExpandingGroupSortChangedGroupSortChangingGroupSummaryEvaluateHeaderCellToggleStateChangedHyperlinkOpenedHyperlinkOpeningLayoutLoadedPageChangedPageChangingPastingPastingCellClipboardContentPrintCellFormattingPrintCellPaintRowFormattingRowHeightChangedRowHeightChangingRowMouseMoveRowPaintRowsChangedRowsChangingRowSourceNeededRowValidatedRowValidatingSelectionChangedSelectionChangingSortChangedSortChangingUserAddedRowUserAddingRowUserDeletedRowUserDeletingRowValueChangedValueChangingViewCellFormattingViewRowFormatting
Not finding the help you need?
Contact Support