ClassRadVirtualGridElement
Represent the main element of RadVirtualGrid.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.GridView.dll
Syntax:
public class RadVirtualGridElement : LightVisualElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadVirtualGridElement
Implements:
Inherited Members
Constructors
RadVirtualGridElement()
Initializes a new instance of the RadVirtualGridElement class.
Declaration
public RadVirtualGridElement()
Properties
ActiveEditor
Gets the currently active editor when the grid is in edit mode.
AllowAddNewRow
Gets or sets a value indicating whether the add new row is visible.
AllowCellContextMenu
Gets or sets a value indicating whether right-clicking on a data cell will show the default data cell context menu.
AllowColumnHeaderContextMenu
Gets or sets a value indicating whether right-clicking on a header cell will show the default header cell context menu.
Declaration
public bool AllowColumnHeaderContextMenu { get; set; }
Property Value
AllowColumnResize
Gets or sets a value indicating whether users can resize columns through the grid UI.
AllowCopy
Gets or sets a value indicating whether the Copy option in the context menu and the Ctrl+C shortcut will be available to the user.
AllowCut
Gets or sets a value indicating whether the Cut option in the context menu and the Ctrl+X shortcut will be available to the user.
AllowDelete
Gets or sets a value indicating whether users can delete rows.
AllowEdit
Gets or sets a value indicating whether users can edit the values in data cells.
AllowFiltering
Gets or sets a value indicating whether the filter row is visible.
AllowMultiColumnSorting
Gets or sets a value indicating whether the users can sort by more than one column.
AllowPaste
Gets or sets a value indicating whether the Paste option in the context menu and the Ctrl+V shortcut will be available to the user.
AllowRowResize
Gets or sets a value indicating whether users can resize rows through the grid UI.
AllowSorting
Gets or sets a value indicating whether users can sort columns by clicking the header or through the header context menu.
BeginEditMode
Gets or sets the method for entering edit mode.
Declaration
public RadVirtualGridBeginEditMode BeginEditMode { get; set; }
Property Value
ColumnCount
Gets or sets the total number of columns to be displayed in the grid.
ContextMenu
Gets or sets the default context menu.
Declaration
public RadDropDownMenu ContextMenu { get; set; }
Property Value
CurrentCell
Gets or sets the current cell.
Declaration
[Browsable(false)]
public VirtualGridCellInfo CurrentCell { get; set; }
Property Value
EnableAlternatingRowColor
Gets or sets a value indicating whether event and odd rows will have a different back color.
Declaration
public bool EnableAlternatingRowColor { get; set; }
Property Value
EnablePaging
Gets or sets a value indicating whether data is presented in chunks (pages) to the user.
EnterKeyMode
Gets or sets the behavior of the Enter key when pressed while in edit mode.
Declaration
public RadVirtualGridEnterKeyMode EnterKeyMode { get; set; }
Property Value
FilterDescriptors
Gets the filter descriptors currently applied to the grid.
Declaration
public FilterDescriptorCollection FilterDescriptors { get; }
Property Value
InputBehavior
Gets or sets an instance of VirtualGridInputBehavior which handles user input.
Declaration
public VirtualGridInputBehavior InputBehavior { get; set; }
Property Value
IsInEditMode
Gets a value indicating whether the grid is in edit mode.
MasterViewInfo
Gets the main VirtualGridViewInfo instance of the grid.
Declaration
public VirtualGridViewInfo MasterViewInfo { get; }
Property Value
MultiSelect
Gets or sets a value indicating whether multiple cells can be selected simultaneously.
PageIndex
Gets or sets the index of the page currently presented in the grid.
PageSize
Gets or sets the number of rows shown per page when paging is enabled.
RowCount
Gets or sets the total number of rows to be displayed in the grid.
Selection
Gets a VirtualGridSelection object which provides an API for manipulating the selection.
Declaration
[Browsable(false)]
public VirtualGridSelection Selection { get; }
Property Value
SelectionMode
Gets or sets a value indicating how cells are selected.
Declaration
public VirtualGridSelectionMode SelectionMode { get; set; }
Property Value
ShowHeaderRow
Gets or sets a value indicating whether the header row is visible.
ShowNoDataText
Gets or sets a value indicating whether a message should be displayed in the grid when no data is loaded.
SortDescriptors
Gets the sort descriptors currently applied to the grid.
Declaration
public SortDescriptorCollection SortDescriptors { get; }
Property Value
StandardTab
Gets or sets a value indicating whether the TAB key moves the focus to the next control in the tab order rather than moving the focus to the next cell in the control.
TableElement
Gets an instance of VirtualGridTableElement which holds all rows and columns.
Declaration
public VirtualGridTableElement TableElement { get; }
Property Value
TotalPages
Gets the total number of pages when paging is enabled.
UseScrollbarsInHierarchy
Gets or sets value indicating whether child views have fixed size [true] or depend on the number of rows they contain [false].
Declaration
public bool UseScrollbarsInHierarchy { get; set; }
Property Value
Methods
BeginEdit()
Starts the editing process for the current cell.
BeginEdit(VirtualGridCellElement)
Starts the editing process for the specified cell.
Declaration
public virtual bool BeginEdit(VirtualGridCellElement currentCell)
Parameters
currentCell
The cell to open for editing.
Returns
True if the operation is successful, otherwise false.
BestFitColumn(int)
Widens / shrinks the column at the specified index in the specified view info based on the space required by the text in the cells.
Declaration
public void BestFitColumn(int columnIndex)
Parameters
columnIndex
The index of the column.
BestFitColumn(int, VirtualGridViewInfo)
Widens / shrinks the column at the specified index in the specified view info based on the space required by the text in the cells.
Declaration
public void BestFitColumn(int columnIndex, VirtualGridViewInfo viewInfo)
Parameters
columnIndex
The index of the column.
viewInfo
The view info to perform the operation on.
BestFitColumns()
Widens / shrinks all columns based on the space required by the text in the cells.
Declaration
public void BestFitColumns()
BestFitColumns(VirtualGridViewInfo)
Widens / shrinks all columns in the specified view info based on the space required by the text in the cells.
Declaration
public void BestFitColumns(VirtualGridViewInfo viewInfo)
Parameters
viewInfo
The view info to perform the operation on.
CanEndEdit()
Returns a value indicating whether the current editor can be closed.
Declaration
public virtual bool CanEndEdit()
Returns
True if the editor can be closed, otherwise false.
CancelEdit()
Ends the editing process without committing any changes. Returns a value indicating whether the operation succeeded.
Declaration
public virtual bool CancelEdit()
Returns
Returns true if the operation is successful. Returns false if the operation is not successful e.g. the grid was not in edit mode.
CollapseRow(int)
Collapses the specified row.
CommitNewRow()
Commits the value in the new row by firing the event.
Declaration
public void CommitNewRow()
CopySelection()
Copies the content of the selected cells.
Declaration
public virtual bool CopySelection()
Returns
True if the operation was successful, otherwise false.
CopyToClipboard(int, int, int, int, VirtualGridViewInfo)
Copies the content of the specified cell region to the clipboard.
Declaration
public void CopyToClipboard(int startRow, int startColumn, int endRow, int endColumn, VirtualGridViewInfo viewInfo)
Parameters
startRow
The index of the row where the content copy should start.
startColumn
The index of the column where the content copy should start.
endRow
The index of the row where the content copy should end.
endColumn
The index of the column where the content copy should end.
viewInfo
The view info of the cell region.
CopyToClipboard(int, int, int, int, VirtualGridViewInfo, bool, bool)
Copies the content of the specified cell region to the clipboard.
Declaration
public void CopyToClipboard(int startRow, int startColumn, int endRow, int endColumn, VirtualGridViewInfo viewInfo, bool selectedOnly, bool cut)
Parameters
startRow
The index of the row where the content copy should start.
startColumn
The index of the column where the content copy should start.
endRow
The index of the row where the content copy should end.
endColumn
The index of the column where the content copy should end.
viewInfo
The view info of the cell region.
selectedOnly
Determines whether only selected cells are copied.
cut
Determines whether cell values should be cleared after the copy.
CreateChildElements()
Called by the element when constructed. Allows inheritors to build the element tree.
Declaration
protected override void CreateChildElements()
Overrides
CreateTableElement(RadVirtualGridElement, VirtualGridViewInfo)
Creates the table element.
Declaration
protected virtual VirtualGridTableElement CreateTableElement(RadVirtualGridElement virtualGridElement, VirtualGridViewInfo viewInfo)
Parameters
virtualGridElement
The virtual grid element.
viewInfo
The view info.
Returns
CutSelection()
Cuts the content of the selected cells.
Declaration
public virtual bool CutSelection()
Returns
True if the operation was successful, otherwise false.
DeleteRow(IEnumerable<int>, VirtualGridViewInfo)
Deletes the rows specified in the first parameter from the specified view info.
Declaration
public void DeleteRow(IEnumerable<int> rowIndices, VirtualGridViewInfo viewInfo)
Parameters
rowIndices
IEnumerable<int>
The indices of the rows to delete.
viewInfo
The view info from which to delete the rows.
DeleteSelectedRow()
Deletes the currently selected row.
Declaration
public bool DeleteSelectedRow()
Returns
True if the operations is successful, otherwise false.
DisposeManagedResources()
Disposes the managed resources.
Declaration
protected override void DisposeManagedResources()
Overrides
DpiScaleChanged(SizeF)
Fires when the DPI scale is changed.
Declaration
public override void DpiScaleChanged(SizeF scaleFactor)
Parameters
scaleFactor
The scale factor.
Overrides
EndEdit()
Ends the editing process and tries to commit any changes made to the edit value. Returns a value indicating whether the operation succeeded.
Declaration
public virtual bool EndEdit()
Returns
Returns true if the operation is successful. Returns false if the operation is not successful e.g. validation fails or the grid was not in edit mode.
EnsureCellVisible(int, int)
Ensures the cell defined by the row and column indices is visible in the current view.
EnsureCellVisible(int, int, VirtualGridTableElement)
Ensures the cell defined by the row and column indices is visible in the current view.
Declaration
public void EnsureCellVisible(int rowIndex, int columnIndex, VirtualGridTableElement tableElement)
Parameters
rowIndex
The row index of the cell.
columnIndex
The column index of the cell.
tableElement
The table element of the row.
EnsureCellVisible(int, int, VirtualGridViewInfo)
Ensures the cell defined by the row and column indices is visible in the current view.
Declaration
public void EnsureCellVisible(int rowIndex, int columnIndex, VirtualGridViewInfo viewInfo)
Parameters
rowIndex
The row index of the cell.
columnIndex
The column index of the cell.
viewInfo
The view info of the cell.
EnsureRowVisible(int)
Ensures the row at the specified row index is visible in the current view.
Declaration
public void EnsureRowVisible(int rowIndex)
Parameters
rowIndex
The index of the row.
EnsureRowVisible(int, VirtualGridTableElement)
Ensures the row at the specified row index is visible in the current view.
Declaration
public void EnsureRowVisible(int rowIndex, VirtualGridTableElement tableElement)
Parameters
rowIndex
The index of the row.
tableElement
The table element of the row.
EnsureRowVisible(int, VirtualGridViewInfo)
Ensures the row at the specified row index is visible in the current view.
Declaration
public void EnsureRowVisible(int rowIndex, VirtualGridViewInfo viewInfo)
Parameters
rowIndex
The index of the row.
viewInfo
The view info of the row.
ExpandRow(int)
Expands the specified row.
FindCellElement(int, int, VirtualGridViewInfo)
Attempts to find a visual cell element that represents the data on the specified row and column indices.
Declaration
public VirtualGridCellElement FindCellElement(int rowIndex, int columnIndex, VirtualGridViewInfo viewInfo)
Parameters
rowIndex
The row index of the cell.
columnIndex
The column index of the cell.
viewInfo
The view info of the cell.
Returns
The cell element if it is visible, otherwise null.
GetCellElement(int, int, VirtualGridTableElement)
Gets the cell element for the specified row and column indices and view info.
Declaration
public VirtualGridCellElement GetCellElement(int rowIndex, int columnIndex, VirtualGridTableElement tableElement)
Parameters
rowIndex
The row index of the cell.
columnIndex
The column index of the cell.
tableElement
The table element of the cell.
Returns
The cell element, if found, otherwise false.
GetCellElement(int, int, VirtualGridViewInfo)
Gets the cell element for the specified row and column indices and view info.
Declaration
public VirtualGridCellElement GetCellElement(int rowIndex, int columnIndex, VirtualGridViewInfo viewInfo)
Parameters
rowIndex
The row index of the cell.
columnIndex
The column index of the cell.
viewInfo
The view info of the cell.
Returns
The cell element, if found, otherwise false.
GetColumnScrollOffset(int, VirtualGridTableElement)
Gets the scroll offset from the beginning of the columns in the specified view to the left edge of the specified column.
Declaration
public int GetColumnScrollOffset(int columnIndex, VirtualGridTableElement tableElement)
Parameters
columnIndex
The index of the column.
tableElement
The table element of the column.
Returns
The distance to the column.
GetColumnScrollOffset(int, VirtualGridViewInfo)
Gets the scroll offset from the beginning of the columns in the specified view to the left edge of the specified column.
Declaration
public int GetColumnScrollOffset(int columnIndex, VirtualGridViewInfo viewInfo)
Parameters
columnIndex
The index of the column.
viewInfo
The view info of the column.
Returns
The distance to the column.
GetColumnWidth(int)
Gets the height of the column at the given column index.
GetDefaultEditor(object)
Gets an editor based on a cell value. Used when column data types are not defined.
Declaration
protected virtual IInputEditor GetDefaultEditor(object value)
Parameters
value
The value of the cell.
Returns
The editor to be used for editing the specified value.
GetEditor(Type)
Gets an editor based on the column data type.
Declaration
protected virtual IInputEditor GetEditor(Type dataType)
Parameters
dataType
The data type of the column.
Returns
The editor to be used for editing the specified data type.
GetRowElement(int, VirtualGridTableElement)
Gets the row element for the specified row index and view info.
Declaration
public VirtualGridRowElement GetRowElement(int rowIndex, VirtualGridTableElement tableElement)
Parameters
rowIndex
The index of the row.
tableElement
The table element of the row.
Returns
The row element displaying the data for the row, if found, otherwise null.
GetRowElement(int, VirtualGridViewInfo)
Gets the row element for the specified row index and view info.
Declaration
public VirtualGridRowElement GetRowElement(int rowIndex, VirtualGridViewInfo viewInfo)
Parameters
rowIndex
The index of the row.
viewInfo
The view info of the row.
Returns
The row element displaying the data for the row, if found, otherwise null.
GetRowHeight(int)
Gets the height of the row at the given row index.
GetRowScrollOffset(int, VirtualGridTableElement)
Gets the scroll offset from the beginning of the rows in the specified view to the top edge of the specified row.
Declaration
public int GetRowScrollOffset(int rowIndex, VirtualGridTableElement tableElement)
Parameters
rowIndex
The index of the row.
tableElement
The table element of the row.
Returns
The distance to the row.
GetRowScrollOffset(int, VirtualGridViewInfo)
Gets the scroll offset from the beginning of the rows in the specified view to the top edge of the specified row.
Declaration
public int GetRowScrollOffset(int rowIndex, VirtualGridViewInfo viewInfo)
Parameters
rowIndex
The index of the row.
viewInfo
The view info of the row.
Returns
The distance to the row.
GetTableElement(VirtualGridViewInfo)
Gets the table element displaying the info of the specified view info..
Declaration
public VirtualGridTableElement GetTableElement(VirtualGridViewInfo viewInfo)
Parameters
viewInfo
The view info.
Returns
The table element, if found, otherwise null.
InitializeEditor(IInputEditor, VirtualGridCellElement)
Initializes the editor for editing. Allows settings of the editor to be modified. Fires the event.
Declaration
protected virtual void InitializeEditor(IInputEditor activeEditor, VirtualGridCellElement cell)
Parameters
activeEditor
The editor that is being initialized.
cell
The cell that will be edited.
IsColumnPinned(int)
Returns a value indicating whether the specified column is pinned.
IsRowExpanded(int)
Returns a value indicating whether the specified row is expanded.
IsRowPinned(int)
Returns a value indicating whether the specified row is pinned.
MoveCurrent(int, int, bool)
Moves the current cell to the one defined by the row and column indices.
Declaration
public bool MoveCurrent(int rowOffset, int columnOffset, bool keepSelection)
Parameters
rowOffset
The new current cell row index.
columnOffset
The new current cell column index.
keepSelection
Determines if the current selection should be kept or discarded.
Returns
MoveCurrentDown(bool)
Moves the current cell to the one below its current position.
MoveCurrentLeft(bool)
Moves the current cell to the left of its current position.
MoveCurrentRight(bool)
Moves the current cell to the right of its current position.
MoveCurrentUp(bool)
Moves the current cell to the one above its current position.
OnCellClick(VirtualGridCellElementEventArgs)
Raises the event.
Declaration
protected virtual void OnCellClick(VirtualGridCellElementEventArgs args)
Parameters
args
VirtualGridCellElementEventArgs
The VirtualGridCellElementEventArgs instance containing the event data.
OnCellDoubleClick(VirtualGridCellElementEventArgs)
Raises the event.
Declaration
protected virtual void OnCellDoubleClick(VirtualGridCellElementEventArgs args)
Parameters
args
VirtualGridCellElementEventArgs
The VirtualGridCellElementEventArgs instance containing the event data.
OnCellEditorInitialized(VirtualGridCellEditorInitializedEventArgs)
Raises the event.
Declaration
protected virtual void OnCellEditorInitialized(VirtualGridCellEditorInitializedEventArgs args)
Parameters
args
VirtualGridCellEditorInitializedEventArgs
The VirtualGridCellEditorInitializedEventArgs instance containing the event data.
OnCellFormatting(VirtualGridCellElementEventArgs)
Raises the event.
Declaration
protected virtual void OnCellFormatting(VirtualGridCellElementEventArgs args)
Parameters
args
VirtualGridCellElementEventArgs
The VirtualGridCellElementEventArgs instance containing the event data.
OnCellMouseMove(VirtualGridCellElementMouseEventArgs)
Raises the event.
Declaration
protected virtual void OnCellMouseMove(VirtualGridCellElementMouseEventArgs args)
Parameters
args
VirtualGridCellElementMouseEventArgs
The VirtualGridCellElementMouseEventArgs instance containing the event data.
OnCellPaint(VirtualGridCellElement, IGraphics)
Raises the event.
Declaration
protected virtual void OnCellPaint(VirtualGridCellElement cell, IGraphics g)
Parameters
cell
The cell.
g
The g.
OnCellValidating(VirtualGridCellValidatingEventArgs)
Raises the event.
Declaration
protected virtual void OnCellValidating(VirtualGridCellValidatingEventArgs args)
Parameters
args
VirtualGridCellValidatingEventArgs
The VirtualGridCellValidatingEventArgs instance containing the event data.
OnCellValueNeeded(VirtualGridCellValueNeededEventArgs)
Fires the event.
Declaration
protected virtual void OnCellValueNeeded(VirtualGridCellValueNeededEventArgs args)
Parameters
args
VirtualGridCellValueNeededEventArgs
The event arguments.
OnCellValuePushed(VirtualGridCellValuePushedEventArgs)
Raises the event.
Declaration
protected virtual void OnCellValuePushed(VirtualGridCellValuePushedEventArgs args)
Parameters
args
VirtualGridCellValuePushedEventArgs
The VirtualGridCellValuePushedEventArgs instance containing the event data.
OnColumnWidthChanged(VirtualGridColumnEventArgs)
Raises the event.
Declaration
protected virtual void OnColumnWidthChanged(VirtualGridColumnEventArgs args)
Parameters
args
The VirtualGridColumnEventArgs instance containing the event data.
OnColumnWidthChanging(VirtualGridColumnWidthChangingEventArgs)
Raises the event.
Declaration
protected virtual bool OnColumnWidthChanging(VirtualGridColumnWidthChangingEventArgs args)
Parameters
args
VirtualGridColumnWidthChangingEventArgs
The VirtualGridColumnWidthChangingEventArgs instance containing the event data.
Returns
OnContextMenuOpening(VirtualGridContextMenuOpeningEventArgs)
Raises the event.
Declaration
protected virtual bool OnContextMenuOpening(VirtualGridContextMenuOpeningEventArgs args)
Parameters
args
VirtualGridContextMenuOpeningEventArgs
The VirtualGridContextMenuOpeningEventArgs instance containing the event data.
Returns
OnCopying(VirtualGridClipboardEventArgs)
Raises the event.
Declaration
protected virtual void OnCopying(VirtualGridClipboardEventArgs args)
Parameters
args
The VirtualGridClipboardEventArgs instance containing the event data.
OnCreateCellElement(VirtualGridCreateCellEventArgs)
Raises the event.
Declaration
protected virtual void OnCreateCellElement(VirtualGridCreateCellEventArgs e)
Parameters
e
VirtualGridCreateCellEventArgs
The VirtualGridCreateCellEventArgs instance containing the event data.
OnCreateRowElement(VirtualGridCreateRowEventArgs)
Raises the event.
Declaration
protected virtual void OnCreateRowElement(VirtualGridCreateRowEventArgs e)
Parameters
e
The VirtualGridCreateRowEventArgs instance containing the event data.
OnCurrentCellChanged(EventArgs)
Raises the event.
OnCurrentCellChanging(VirtualGridCellInfo)
Raises the event.
Declaration
protected virtual bool OnCurrentCellChanging(VirtualGridCellInfo cellInfo)
Parameters
cellInfo
The cell info.
Returns
OnEditorRequired(VirtualGridEditorRequiredEventArgs)
Raises the event.
Declaration
protected virtual void OnEditorRequired(VirtualGridEditorRequiredEventArgs args)
Parameters
args
VirtualGridEditorRequiredEventArgs
The VirtualGridEditorRequiredEventArgs instance containing the event data.
OnFilterDescriptorsChanged(VirtualGridViewInfo)
Raises the event.
Declaration
protected virtual void OnFilterDescriptorsChanged(VirtualGridViewInfo viewInfo)
Parameters
viewInfo
The view information.
OnPageIndexChanged(VirtualGridEventArgs)
Raises the event.
Declaration
protected virtual void OnPageIndexChanged(VirtualGridEventArgs args)
Parameters
args
The VirtualGridEventArgs instance containing the event data.
OnPageIndexChanging(VirtualGridPageChangingEventArgs)
Raises the event.
Declaration
protected virtual void OnPageIndexChanging(VirtualGridPageChangingEventArgs args)
Parameters
args
VirtualGridPageChangingEventArgs
The VirtualGridPageChangingEventArgs instance containing the event data.
OnPasting(VirtualGridClipboardEventArgs)
Raises the event.
Declaration
protected virtual void OnPasting(VirtualGridClipboardEventArgs args)
Parameters
args
The VirtualGridClipboardEventArgs instance containing the event data.
OnQueryHasChildRows(int, VirtualGridViewInfo)
Raises the event.
Declaration
protected virtual bool OnQueryHasChildRows(int rowIndex, VirtualGridViewInfo viewInfo)
Parameters
rowIndex
The index of the row.
viewInfo
The view info of the row.
Returns
OnRowCollapsed(VirtualGridRowExpandedEventArgs)
Raises the event.
Declaration
protected virtual void OnRowCollapsed(VirtualGridRowExpandedEventArgs args)
Parameters
args
VirtualGridRowExpandedEventArgs
The VirtualGridRowExpandedEventArgs instance containing the event data.
OnRowCollapsing(VirtualGridRowExpandingEventArgs)
Raises the event.
Declaration
protected virtual void OnRowCollapsing(VirtualGridRowExpandingEventArgs args)
Parameters
args
VirtualGridRowExpandingEventArgs
The VirtualGridRowExpandingEventArgs instance containing the event data.
OnRowExpanded(VirtualGridRowExpandedEventArgs)
Raises the event.
Declaration
protected virtual void OnRowExpanded(VirtualGridRowExpandedEventArgs args)
Parameters
args
VirtualGridRowExpandedEventArgs
The VirtualGridRowExpandedEventArgs instance containing the event data.
OnRowExpanding(VirtualGridRowExpandingEventArgs)
Raises the event.
Declaration
protected virtual void OnRowExpanding(VirtualGridRowExpandingEventArgs args)
Parameters
args
VirtualGridRowExpandingEventArgs
The VirtualGridRowExpandingEventArgs instance containing the event data.
OnRowFormatting(VirtualGridRowElementEventArgs)
Fires the event.
Declaration
protected virtual void OnRowFormatting(VirtualGridRowElementEventArgs args)
Parameters
args
VirtualGridRowElementEventArgs
The VirtualGridRowElementEventArgs instance containing the event data.
OnRowHeightChanged(VirtualGridRowEventArgs)
Raises the event.
Declaration
protected virtual void OnRowHeightChanged(VirtualGridRowEventArgs args)
Parameters
args
The VirtualGridRowEventArgs instance containing the event data.
OnRowHeightChanging(VirtualGridRowHeightChangingEventArgs)
Raises the event.
Declaration
protected virtual bool OnRowHeightChanging(VirtualGridRowHeightChangingEventArgs args)
Parameters
args
VirtualGridRowHeightChangingEventArgs
The VirtualGridRowHeightChangingEventArgs instance containing the event data.
Returns
OnRowPaint(VirtualGridRowElement, IGraphics)
Raises the event.
Declaration
protected virtual void OnRowPaint(VirtualGridRowElement row, IGraphics g)
Parameters
row
The row.
g
The g.
OnRowValidated(VirtualGridRowEventArgs)
Raises the event.
Declaration
protected virtual void OnRowValidated(VirtualGridRowEventArgs e)
Parameters
e
The VirtualGridRowEventArgs instance containing the event data.
OnRowValidating(VirtualGridRowValidatingEventArgs)
Raises the event.
Declaration
protected virtual void OnRowValidating(VirtualGridRowValidatingEventArgs e)
Parameters
e
VirtualGridRowValidatingEventArgs
The VirtualGridRowValidatingEventArgs instance containing the event data.
OnSelectionChanged(object, EventArgs)
Raises the event.
OnSelectionChanging(object, VirtualGridSelectionChangingEventArgs)
Raises the event.
Declaration
protected virtual void OnSelectionChanging(object sender, VirtualGridSelectionChangingEventArgs e)
Parameters
sender
The sender.
e
VirtualGridSelectionChangingEventArgs
The VirtualGridSelectionChangingEventArgs instance containing the event data.
OnSortDescriptorsChanged(VirtualGridViewInfo)
Raises the event.
Declaration
protected virtual void OnSortDescriptorsChanged(VirtualGridViewInfo viewInfo)
Parameters
viewInfo
The view info.
OnUserDeletedRow(VirtualGridRowsEventArgs)
Raises the event.
Declaration
protected virtual void OnUserDeletedRow(VirtualGridRowsEventArgs e)
Parameters
e
The VirtualGridRowsEventArgs instance containing the event data.
OnValueChanged(object, EventArgs)
Raises the event.
OnValueChanging(object, ValueChangingEventArgs)
Raises the event.
Declaration
protected virtual void OnValueChanging(object sender, ValueChangingEventArgs e)
Parameters
sender
The source of the event.
e
The ValueChangingEventArgs instance containing the event data.
OnViewInfoPropertyChanged(VirtualGridViewInfo, string)
Raises the event.
Declaration
protected virtual void OnViewInfoPropertyChanged(VirtualGridViewInfo viewInfo, string propertyName)
Parameters
viewInfo
The view info.
propertyName
Name of the property.
Paste()
Pastes the content of the clipboard into starting from the current cell and going on until either the available cells or the clipboard content ends.
Declaration
public virtual bool Paste()
Returns
True if the operation is successful, otherwise false.
ProcessContent(string, int, int, int, int, VirtualGridViewInfo, bool, bool)
Processes the content of the cells in the specified region and returns a string to be places in the clipboard.
Declaration
protected virtual string ProcessContent(string format, int startRow, int startColumn, int endRow, int endColumn, VirtualGridViewInfo viewInfo, bool selectedOnly, bool cut)
Parameters
format
The format of the data that should be returned.
startRow
The index of the row where the content processing should start.
startColumn
The index of the column where the content processing should start.
endRow
The index of the row where the content processing should end.
endColumn
The index of the column where the content processing should end.
viewInfo
The view info of the cell region.
selectedOnly
Determines whether only selected cells are processed.
cut
Determines whether cell values should be cleared after they are processed.
Returns
SetCellValue(object, int, int, VirtualGridViewInfo)
Sets the value of a given cell to the specified value.
Declaration
public void SetCellValue(object value, int rowIndex, int columnIndex, VirtualGridViewInfo viewInfo)
Parameters
value
The new value for the cell.
rowIndex
The row index of the cell.
columnIndex
The column index of the cell.
viewInfo
The view info of the cell.
SetColumnPinPosition(int, PinnedColumnPosition)
Sets the pin position of the specified column.
Declaration
public void SetColumnPinPosition(int columnIndex, PinnedColumnPosition pinPosition)
Parameters
columnIndex
The index of the column.
pinPosition
The new pin position.
SetColumnWidth(int, int)
Sets the width of the column at the specified column index in the master view info.
SetColumnWidth(int, params int[])
Sets the width of the columns at the specified column indices in the master view info.
SetCurrentCell(VirtualGridCellInfo)
Sets the specified cell as the current cell.
Declaration
protected virtual bool SetCurrentCell(VirtualGridCellInfo value)
Parameters
value
The cell to mark as current.
Returns
True if the operation is successful, otherwise false.
SetRowHeight(int, int)
Sets the height of the row at the specified row index in the master view info.
SetRowHeight(int, params int[])
Sets the height of the rows at the specified row indices in the master view info.
SetRowPinPosition(int, PinnedRowPosition)
Sets the pin position of the specified row.
Declaration
public void SetRowPinPosition(int rowIndex, PinnedRowPosition pinPosition)
Parameters
rowIndex
The index of the row.
pinPosition
The new pin position.
Events
CellClick
Occurs when a cell is clicked.
Declaration
public event VirtualGridCellElementEventHandler CellClick
Event Value
CellDoubleClick
Occurs when a cell is double clicked.
CellEditorInitialized
Occurs when the editor of a cell is initialized.
Declaration
public event VirtualGridCellEditorInitializedEventHandler CellEditorInitialized
Event Value
CellFormatting
Occurs when a cell is updated and needs formatting.
Declaration
public event VirtualGridCellElementEventHandler CellFormatting
Event Value
CellMouseMove
Occurs when the mouse is moved over a cell.
Declaration
public event VirtualGridCellElementMouseEventHandler CellMouseMove
Event Value
CellPaint
Occurs after a cell is painted allowing users to draw on top of it.
Declaration
public event VirtualGridCellPaintEventHandler CellPaint
Event Value
CellValidating
Occurs before a cell is validated.
Declaration
public event VirtualGridCellValidatingEventHandler CellValidating
Event Value
CellValueNeeded
Occurs when a cell is displayed and its content should be updated.
Declaration
public event VirtualGridCellValueNeededEventHandler CellValueNeeded
Event Value
CellValuePushed
Occurs when a cell value is edited and should be stored in the data source.
Declaration
public event VirtualGridCellValuePushedEventHandler CellValuePushed
Event Value
ColumnWidthChanged
Occurs after the width of a column changes.
Declaration
public event VirtualGridColumnEventHandler ColumnWidthChanged
Event Value
ColumnWidthChanging
Occurs before the width of a column changes.
Declaration
public event VirtualGridColumnWidthChangingEventHandler ColumnWidthChanging
Event Value
ContextMenuOpening
Occurs when the context menu is about to be opened.
Declaration
public event VirtualGridContextMenuOpeningEventHandler ContextMenuOpening
Event Value
Copying
Occurs when the content of cell(s) is copied. Allows users to modify the operation or content.
Declaration
public event VirtualGridClipboardEventHandler Copying
Event Value
CreateCellElement
Occurs when a new cell element has to be created.
Declaration
public event VirtualGridCreateCellEventHandler CreateCellElement
Event Value
CreateRowElement
Occurs when a new row element has to be created.
Declaration
public event VirtualGridCreateRowEventHandler CreateRowElement
Event Value
CurrentCellChanged
Occurs after the current cell changes.
CurrentCellChanging
Occurs before the current cell changes.
Declaration
public event VirtualGridCellInfoCancelEventHandler CurrentCellChanging
Event Value
EditorRequired
Occurs when an editor for a cell is required.
Declaration
public event VirtualGridEditorRequiredEventHandler EditorRequired
Event Value
FilterDescriptorsChanged
Occurs when the filter descriptors collection changes.
Declaration
public event VirtualGridEventHandler FilterDescriptorsChanged
Event Value
PageIndexChanged
Occurs after the current page index changes.
Declaration
public event VirtualGridEventHandler PageIndexChanged
Event Value
PageIndexChanging
Occurs before the current page index changes.
Declaration
public event VirtualGridPageChangingEventHandler PageIndexChanging
Event Value
Pasting
Occurs when the content of cell(s) is about to be pasted. Allows users to modify the operation or content.
Declaration
public event VirtualGridClipboardEventHandler Pasting
Event Value
QueryHasChildRows
Occurs when a row has to determine if it has child rows.
Declaration
public event VirtualGridQueryHasChildRowsEventHandler QueryHasChildRows
Event Value
RowCollapsed
Occurs after a row is collapsed.
Declaration
public event VirtualGridRowExpandedEventHandler RowCollapsed
Event Value
RowCollapsing
Occurs before a row is collapsed.
Declaration
public event VirtualGridRowExpandingEventHandler RowCollapsing
Event Value
RowExpanded
Occurs after a row is expanded.
Declaration
public event VirtualGridRowExpandedEventHandler RowExpanded
Event Value
RowExpanding
Occurs before a row is expanded.
Declaration
public event VirtualGridRowExpandingEventHandler RowExpanding
Event Value
RowFormatting
Occurs when a row is updated and needs formatting.
Declaration
public event VirtualGridRowElementEventHandler RowFormatting
Event Value
RowHeightChanged
Occurs after a row height changes.
Declaration
public event VirtualGridRowEventHandler RowHeightChanged
Event Value
RowHeightChanging
Occurs before a row height changes.
Declaration
public event VirtualGridRowHeightChangingEventHandler RowHeightChanging
Event Value
RowPaint
Occurs after a row is painted allowing users to draw on top of it.
Declaration
public event VirtualGridRowPaintEventHandler RowPaint
Event Value
RowValidated
Occurs after a row is validated.
Declaration
public event VirtualGridRowEventHandler RowValidated
Event Value
RowValidating
Occurs before a row is validated.
Declaration
public event VirtualGridRowValidatingEventHandler RowValidating
Event Value
SelectionChanged
Occurs after the selection changes.
SelectionChanging
Occurs before the selection changes.
Declaration
public event VirtualGridSelectionChangingEventHandler SelectionChanging
Event Value
SortDescriptorsChanged
Occurs when the sort descriptors collection changes.
Declaration
public event VirtualGridEventHandler SortDescriptorsChanged
Event Value
UserAddedRow
Occurs when a user adds a row.
Declaration
public event VirtualGridNewRowEventHandler UserAddedRow
Event Value
UserDeletedRow
Occurs when a user deletes a row.
Declaration
public event VirtualGridRowsEventHandler UserDeletedRow
Event Value
ValueChanged
Occurs after the value of a cell has been changed.
ValueChanging
Occurs before the value of a cell is changed.
Declaration
public event ValueChangingEventHandler ValueChanging
Event Value
ViewInfoPropertyChanged
Occurs when a property of the view info changes.
Declaration
public event VirtualGridViewInfoPropertyChangedEventHandler ViewInfoPropertyChanged
Event Value