Divelements.SandGrid

Provides functionality for integrating with the clipboard.

Imports data into the grid from the clipboard, starting from the specified element.

The element to start from.

Copies the contents of the specified rows to the clipboard.

The grid to which all rows belong. The rows whose data will be copied.

Copies the contents of the specified cells to the clipboard.

The grid to which all cells belong. The cells whose data will be copied. Whether to include column headers in the data copied.

Provides a fully-functioning grid control.

A control for displaying data in hierarchical grid form.

Initializes a new instance of the SandGrid control.

Overridden.

Raises the BeforeExpand event.

The arguments associated with the event.

Raises the BeforeCollapse event.

The arguments associated with the event.

Raises the SortChanged event.

The arguments associated with the event.

Raises the PopulateVirtualRow event.

The arguments assocated with the event.

Raises the ElementsMoved event.

The arguments associated with the event.

Raises the ColumnResized event.

The arguments associated with the event.

Raises the ColumnsReordered event.

The arguments associated with the event.

Raises the ChooseEditor event.

The arguments associated with the event.

Raises the DataBindingComplete event.

The arguments associated with the event.

Raises the BeforeCheck event.

The arguments associated with the event.

Raises the AfterCheck event.

The arguments associated with the event.

Raises the AfterEdit event.

The arguments associated with the event.

Raises the AfterExpand event.

The arguments associated with the event.

Raises the AfterCollapse event.

The arguments associated with the event.

Raises the ItemDrag event.

The arguments associated with the event.

Raises the ValueParsing event.

The arguments associated with the event.

Raises the ValueFormatting event.

The arguments associated with the event.

Creates a new row populated with cells of the appropriate type for the columns in the grid.

A new instance of the GridRow class.

Locates the element lying under the specified cursor position.

The position at which to look. The element containing the position.

Overridden.

Scrolls the viewport so that the specified element is visible.

The element to make visible in the viewport.

Overridden.

Causes the grid to layout all its elements synchronously.

By default SandGrid queues layout operations until they are needed, so it can do them all in one batch. This is a substantial performance gain. However in situations where you need to force this to happen at once, e.g. you have added a batch of rows and want one to become visible by calling ScrollElementIntoView, this method forces all pending layout operations to complete.

Overridden.

Raises the DataError event.

Whether to show a dialog if no event handler is registered. The arguments associated with the event.

Raises the BeforeEdit event.

The arguments associated with the event.

Ends an edit operation if one is taking place.

Whether to commit the edit. Whether to reset focus to the grid after removing the editor control. A value indicating whether the edit was successfully ended.

Starts an edit operation on a grid cell.

The row intersecting the cell. The column intersecting the cell. Whether to select the contents of the cell once being edited. A boolean value indicating whether the edit operation started.

Translates a position from client coordinates to grid coordinates.

A client position. A grid position. Because of scrolling, elements in a grid are laid out in grid coordinate space which is different from control client coordinate space. Use this method to translate a position in client coordinates into a position in grid coordinates, suitable for passing to the GetElementAt method.

Translates a point from grid coordinates to client coordinates.

A grid position. A client position.

Overridden.

Finds all selected cells, whether selected directly or under a selected column or row.

An array of GridCell instances.

Selects the specified element after unselecting any other selected elements, and sets the focus to the element.

The element to select.

Selects the specified row after unselecting any other selected elements, and sets the focus to the row.

Unselects all grid elements that are selected.

Raises the RowActivated event.

The arguments associated with the event.

Raises the SelectionChanged event.

The arguments associated with the event.

Raises the ColumnHeaderClick event.

The argument associated with the event.

Raises the ActiveGridChanged event.

The arguments associated with the event.

Selects all expanded rows in the grid.

Overridden.

Gets the column whose value should be edited, given a row.

The row on which an edit operation will commence. The column whose value should be edited. The default implementation of this method returns the primary column.

Overridden.

Shows the Page Setup dialog ready to print the grid.

Prints the contents of the grid.

Indicates whether to show the print dialog before printing.

Shows the Print Preview dialog, from which it is possible to print.

Returns the state of the grid as a string that can be restored later.

A string containing XML.

Sets the state of the grid based on a state previously saved with the SerializeState method.

The state to restore.

Occurs when the selection changes in the grid.

Occurs when a row is double-clicked or otherwise activated.

Occurs when an element is about to be edited.

Occurs when an error is encountered while dealing with data.

Occurs when the focus moves from one grid to another.

Occurs when a value is about to be formatted.

Occurs when the user drags an item in the grid.

Occurs when a value is about to be parsed.

Occurs as an edit operation is about to be committed.

Occurs when databinding on a grid has finished.

Occurs when an editor needs to be selected for a cell.

Occurs when the sorting on the grid changes.

Overridden.

Indicates how key presses can initiate an edit.

Indicates how mouse actions can initiate an edit.

If true, causes the Tab key to have the standard Win32 behavior of moving between controls.

Indicates whether checkboxes are present on rows.

The text to show when there are no items in the grid.

The color of text to show when there are no items in the grid.

The alignment of the text shown when there are no items in the grid.

Indicates whether GDI+ text rendering is used for standard drawing.

The grid that last had the focus. Unless a nested grid scenario is in operation, this will always be the primary grid.

Indicates whether the user can start typing to search through rows in the grid.

Indicates whether columns corresponding to properties on bound objects will be automatically generated if they do not already exist.

Gets or sets the data source that the grid is bound to.

Gets or sets the name of the list or table in the data source that the grid is bound to.

The row being edited.

The column being edited.

The renderer in use by the grid.

Indicates whether an edit operation should be committed when focus leaves the control.

Indicates whether the user can paste data from the clipboard into the grid.

Indicates whether an editor is currently active in the grid.

Indicates whether the value being edited has changed in the editor.

Indicates whether the selection is hidden when the grid does not have focus.

Obtains the primary DataHost being displayed by the grid.

Indicates whether the primary grid is stretched horizontally if needed.

The type of border that is drawn around the control.

Specifies how the page underneath the last row is made available.

Specifies how the page to the right of the last column is made available.

The area of the grid that is scrollable and contains data.

This is the total area of the control minus the size of any fixed headers or data.

The grid elements that are selected.

The vertical scroll position in the grid.

The horizontal scroll position in the grid.

Indicates whether the user is able to select multiple elements.

The rows of data contained in the control.

An IEnumerable that can be used to enumerate through a hierarchical layout of visible rows as if they were flat.

An IEnumerable that can be used to enumerate through a hierarchical layout of rows as if they were flat.

An IEnumerable that can be used to enumerate through all visible rows in the grid.

An IEnumerable that can be used to enumerate through all visible columns in the grid.

The number of elements that are selected.

Obtains a PrintDocument derived class to use for printing.

Indicates whether tooltips are shown on the control.

The element that has the focus.

While any number of elements can be selected, only one element can have the focus.

Initializes a new instance of the SandTreeView class.

Raises the BeforeCheck event.

The arguments associated with the event.

Raises the AfterCheck event.

The arguments associated with the event.

Raises the BeforeExpand event.

The arguments associated with the event.

Raises the BeforeCollapse event.

The arguments associated with the event.

Raises the AfterExpand event.

The arguments associated with the event.

Raises the AfterCollapse event.

The arguments associated with the event.

Occurs when a row is about to be expanded.

Occurs when a row is about to be collapsed.

Occurs when a row has just been expanded.

Occurs when a row has just been collapsed.

Occurs when a row is about to have its check state changed by the user.

Occurs after a row has had its check state changed by the user.

Indicates whether the grid is editable.

The amount, in pixels, to indent the contents of the primary column in nested rows.

Indicates whether lines are drawn to show the relationship of indented nodes.

Indicates whether lines and buttons are drawn for the root items.

Indicates whether the expand button will be displayed for nested rows.

Indicates what happens when a parent row is double-clicked.

A logical grouping of data in to a column. Provides layout and drawing facilities for that column.

An abstract base class from which elements that sit in a SandGrid derive.

Locates a child grid element at the specified coordinates.

The coordinates at which to look. The child element, if one is found.

Locates the grid element at the specified coordinates.

The coordinates to be hit-tested. The element at the coordinates.

Obtains the text to be displayed as a tooltip when the mouse is hovered over the specified position.

The position of the mouse cursor.

Called when the Hot status of the element changes.

Occurs when a drag operation finishes.

Occurs when a mouse button is pressed over the element.

The arguments associated with the event.

Occurs when the mouse is double-clicked over the element.

The arguments associated with the event.

Occurs when the mouse cursor is moved over the element.

The arguments associated with the event.

Occurs when the mouse cursor leaves the region of the element.

Occurs when a mouse button is released over the element.

The arguments associated with the event.

Causes the element to lay out its contents within its bounds.

The bounds in which to lay out the element contents.

Measures the contents of the elements and calculates a minimum desired size for them.

The Graphics instance for measuring text metrics. The StringFormat instance to use for text layout. Whether items should be arranged in right-to-left reading order. The desired size of the element.

Ensures the element is visible by scrolling it into view if necessary.

Marks the visual state of the element as invalid. The element will be redrawn during the next paint cycle.

Marks the visual state of a given area as invalid. The element will be redrawn during the next paint cycle.

Marks the metrics of the element as invalid. The element will be remeasured at the next available opportunity.

Determines whether the element is in a state that should trigger a remeasure when its measurement is marked as invalid.

A boolean value indicating whether to trigger a measure operation.

Determines whether the value of the element affects its measurements.

A boolean value. Some elements need to be remeasured when their value (or other properties affecting the displayed value) changes. Most do not, however, and depending on this method SandGrid will either perform a layout operation or simply redraw the element.

Obtains the default font to use for drawing text in the element.

An instance of the Font class.

The logical parent element of the element.

For a grid row, this will be the parent row, or null if the row doesn't have a parent. For a grid cell, this will be the parent row.

The DataHost to which the grid element belongs.

The index of the element within its primary parent collection.

The Font in use by the element.

Setting this to a null reference will cause the element to use the font of its parent.

Indicates whether the element is selected.

Indicates whether the mouse cursor is currently over the element.

Updates the selected state without triggering a redraw. Use in bulk operations only.

The area of the host control occupied by the element.

Gets or sets the object that contains data about the element.

Initializes a new instance of the GridColumn class.

Initializes a new instance of the GridColumn class, with the specified text.

The text shown in the column heading.

Initializes a new instance of the GridColumn class, with the specified text and the specified width.

The text shown in the column heading. The width of the column.

Returns a value to use for sorting, given a raw value from a cell.

The raw value present in a cell. The base implementation of this method returns the raw value. This method must never return a null reference. It must always return either the raw value or a modification of the raw value.

Returns an array with potential values for cells under the column.

An array of NameValuePair instances.

Finds all cells that lie under the column.

An array of GridCell instances.

Gets a string representation of the specified value.

The value for which to obtain a string representation. The type needed by the target of the transformation. A string representing the value.

Sets the formatted value of an object.

The row that represents the object whose value will be set. The value to set. The type required by the target of the transformation.

Obtains a group heading text suitable for the row.

The row to test against. A string suitable for displaying as a group heading for the row.

Tests whether a previous object should be placed in to the same group as the row.

The row to test against. The last object that represents a group. The heading for the new group. A boolean value indicating whether a new group should be started.

Causes the column to assume the width of its largest cell.

The minimum size of the column. Whether to include the contents of the header itself.

Measures the contents of all cells that fall under the column and returns the largest.

The rows to include in the calculation. Whether to include the contents of the header itself.

Overridden.

Determines whether the text shown is overflowing the visible area on the screen.

The row containing the cell to inspect. If this is null, the column header is used. A boolean value indicating whether overflow has occurred.

Overridden.

Toggles sorting on the column.

If the column is already being sorted by, the sort direction is changed. If not, the column is sorted in ascending order.

Toggles a multi-column sort on the column.

Raises the Click event.

The arguments associated with the event.

Overridden.

Indicates whether the row can be resized.

Overridden.

Causes the column to paint the foreground of the specified cell.

The context in which the rendering operation is being invoked. The row of data containing the cell to paint. The value to draw in the cell. The default font with which to draw. The image associated with the cell. The bounds of cell. Whether to draw the cell as selected. The object to use for controlling text rendering. The foreground color of the cell.

Causes the column to draw its background.

The context in which rendering is being invoked. The bounds of the visible area of the column background.

Causes the element to paint its background.

The context in which rendering is being invoked. The object to use for controlling how text is drawn.

Creates a text format control suitable for formatting text in the column and its cells.

Which type of element to create a text format for. A new text format control.

Overridden.

Creates a cell suitable for displaying data in the column.

An instance of the GridCell class.

Obtains the color with which to draw a foreground object under the cell.

The color of the row or cell being drawn. A color structure.

Sets the sort indicator displayed in the column.

The type of indicator to display. This method is used internally by SandGrid as a result of sorting. Advanced users applying their own sort algorithms may wish to set indicators manually.

Requests that the area occupied by the column is redrawn.

If true, the whole column will be redrawn. If false, the header will be redrawn.

Overridden.

Releases the resources consumed by the object.

Occurs when the column header is clicked.

Occurs when the component is disposed.

Indicates the minimum width to which the user can change the column.

The type of data the column is designed to contain.

Indicates how the column is being used to sort data.

Gets or sets the type of editor used to edit values in the column.

Indicates whether text in cells is allowed to wrap.

Indicates how the column will automatically size itself.

Indicates whether column header text is accounted for when autosizing based on contents.

Indicates whether the column is the primary column.

Gets or sets the name of the data source property or database column to which the column is bound.

Indicates whether the column is bound to data.

Indicates whether the column is visible.

Indicates whether the contents of the column can be edited.

The image to display in the column header.

Indicates whether text that cannot be shrunk any further will be clipped.

This property is false by default for performance reasons, but turning it on will result in technically more correct text rendering.

The color of text drawn under the column.

The index of the column in the visual order of columns in a grid.

To change this, use the SetDisplayIndices method of the Columns collection.

Gets or sets the ISite associated with the component.

Indicates whether the column will automatically initiate sorting when its header is clicked.

Indicates how the column will automatically sort itself when clicked.

Indicates whether the user will be able to reorder columns by dragging the header.

Indicates whether the column header will be clickable.

Indicates whether to use the row font or the column font when drawing a cell.

Indicates whether to use the row forecolor or the column forecolor when drawing a cell.

Indicates how the foreground color of a cell is determined.

The horizontal alignment of both the header and cell contents.

Indicates how the contents of cells are laid out.

Indicates how the contents of the header are laid out.

The column that precedes this one.

The column that follows this one.

Indicates how the column is resized by the user.

The bounds occupied by the header image.

The bounds occupied by the header text.

The tooltip to show for the column header.

The text shown in the column heading.

The width of the column.

Required designer variable.

Clean up any resources being used.

true if managed resources should be disposed; otherwise, false.

Required method for Designer support - do not modify the contents of this method with the code editor.

An editor that uses a ComboBox as its user interface.

A contract to specify how SandGrid will interact with a control providing editing services.

It should be noted that when implementing this interface, the editor should retain a reference to the grid passed during InitializeContext so it can set the EditorDirty property to true when the value changes. Failure to do this will result in SandGrid not applying any value in the editor.

Initializes the editor by informing it of the context in which it is being invoked.

The grid that contains the element being edited. The row that contains the cell being edited. The column that contains the cell being edited.

Requests the editor to start an edit operation.

Whether all text should be selected.

Gets or sets the formatted value of the object being edited.

The border style of the control that hosts the editor.

The type of value the editor desires.

The fixed height of the editor. This should return zero if the editor does not care.

Initializes a new instance of the GridComboBoxEditor class.

Overridden.

Populates the editor with a list of names and corresponding values.

Names and values with which to populate the editor.

Overridden.

An editor that uses a DateTimePicker as its user interface.

Initializes a new instance of the GridDateTimeEditor class.

Overridden.

Sets the value in the editor to the DateTime passed to the method.

The value to which to set the editor.

Gets the value in the editor.

The value currently represented by the editor.

Overridden.

An editor that uses a NumericUpDown control as its user interface.

Initializes a new instance of the GridUpDownEditor class.

Overridden.

Represents a collection of grouped rows.

A grid element which can receive the input focus.

Advances the focus in the specified direction, using the specified method.

The direction in which to advance the selection. The method with which to advance the selection. The number of steps to advance the selection. Whether to loop around if the end of available elements is encountered. A boolean value indicating whether the focus was successfully advanced.

Advances the focus in the specified direction.

The direction in which to advance the selection.

Obtains the element following the element on which the method is called.

The direction in which to look. Whether to loop around if the end of available elements is encountered. Whether the method altered the visibility of further elements. The next element.

Obtains the element following the element on which the method is called.

The direction in which to look. The next element.

Called when the focus enters the element.

Called when the focus leaves the element.

Selects a block of elements.

The element at which to start. The element at which to finish.

Overridden.

Selects the element as the result of a mouse button being pressed.

The mouse arguments associated with the event.

Overridden.

This method is not implemented for group headings.

Overridden.

Draws the group heading.

The rendering context in which to draw.

Overridden.

Selects all rows in the group, taking into account the shift and control key states.

Obtains an array of all rows represented by the group.

An array of GridRow objects.

The bounds of the expand button.

The text to display in the heading.

Indicates whether the heading is expanded.

A class that represents a related friendly name and an underlying value.

Initializes a new instance of the NameValuePair class.

The friendly name. The underlying value.

The friendly name.

The underlying value.

Provides commonly used drawing functionality to renderers.

Creates a highlighted version of a source image.

The image to highlight. A value between 0 and 1 specifying the strength of the highlight. A new image with the highlight applied. When displaing an image next to a selected element it is common to shade the image with the system highlight color. This method does just that, in an optimized way.

Mixes two colours together to form a new colour.

The first source colour. The second source colour. A value that lies between 0 and 1, 0 being the first colour and 1 being the second. The new colour produced after mixing.

Draws a faded shadow around a rectangle.

The Graphics object to draw with. The bounds that represents the rectangle that will get a shadow. The size, in pixels, of the shadow. The color of the shadow. This method is optimized for small shadows. It is not suitable for drawing larger shadows as the corners will stop looking rounded.

Provides technology independent text rendering and measuring methods.

It is necessary for text in SandGrid to be renderer with GDI+ when printing and in .NET 1.0/1.1, and optionally with GDI in .NET 2.0. When printing text is always rendered in GDI+. This class there provides independent methods for drawing and measuring text, optimized for SandGrid.

Draws a block of text on the grid.

The Graphics object to draw with. The text to draw. The font to use for text. The bounds around the area to draw. Information on text formatting. The color of the text.

Draws a block of text on the grid.

The Graphics object to draw with. The text to draw. The font to use for text. The bounds around the area to draw. Information on text formatting. The color of the text. A brush corresponding to the color of the text.

Measures the extent of a block of text.

The Graphics object to measure with. The text to measure. The font to use for text. Information on text formatting. The size of the text.

Measures the extent of a block of text.

The Graphics object to measure with. The text to measure. The font to use for text. The width that the text is constrained by. Information on text formatting. The size of the text.

Provides rendering facilities to cause a grid to appear compatible with Office 2007.

Provides methods for drawing common features on a grid.

Calculates the boundaries of the expand button in a group heading.

The group heading for which to calculate. A rectangle containing the bounds.

Draws the header of a grid column.

The Graphics object to paint with. The column whose header should be drawn. This can be a null reference. The bounds around the area to draw. The object to use for controlling the drawing of text. The state of the object. Whether a print operation is taking place.

Draws the header of a grid row.

The Graphics object to paint with. The row whose header should be drawn. The bounds around the area to draw. The object to use for controlling the drawing of text. The state of the object.

Draws an expand/collapse button.

The Graphics object to paint with. The bounds around the area to draw. Whether the button should be drawn in an expanded state.

Draws a selection rectangle.

The Graphics object to paint with. The bounds around the area to draw. Whether to draw the area as selected. Whether the area contains the focus. Whether to draw a focus rectangle around the area.

Draws a rubber band selection.

The Graphics object to paint with. THe bounds around the area to draw.

Creates a pen suitable for drawing the lines of a tree hierarchy.

A disposable Pen object.

Creates a pen suitable for drawing grid lines.

A disposable Pen object.

Creates a pen suitable for drawing column and row resize hints.

A disposable Pen object.

Creates a brush suitable for filling the background of an alternate row.

The row whose background will be drawn. The bounds around the area to draw. A disposable Brush object.

Obtains the color with which to draw selected text.

True if the grid has focus. A color structure.

Draws the background of a column that is controlling the sorting behavior of a grid.

The Graphics object to paint with. The column whose background will be drawn. The bounds around the area to draw.

Draws the heading for a collection of rows that have been grouped together.

The Graphics object to paint with. The group whose heading is being drawn. The bounds around the area to draw. The font of the row whose heading will be drawn. The state of the heading. The columns that are being drawn. This does not necessarily represent all columns in the grid. The StringFormat instances to use for text layout of their equivalent columns.

Draws the border around a nested grid.

The Graphics object to paint with. The Grid whose border is being drawn. The bounds around the area to draw.

Draws the border of a grid.

The Graphics object to paint with. The bounds around the area to draw. A boolean value indicating whether a border was drawn.

Draws a glyph.

The Graphics object to paint with. The bounds around the area to draw. The type of glyph to draw.

Draws the corner where row headers and column headers meet.

The Graphics object to paint with. The bounds around the area to draw. Whether a print operation is taking place.

Draws a checkbox.

The Graphics object to paint with. The bounds around the area to draw. The state of the checkbox.

Draws a progress bar.

The Graphics object to paint with. The bounds around the area to draw. The minimum value. The maximum value. The value.

Occurs when a property is changed in the renderer that should result in a redraw operation.

Initializes a new instance of the Office2007Renderer class.

Overridden.

Raises the RedrawNeeded event.

The arguments associated with the event.

This member implements an interface member. For more information, consult the documentation on the interface.

Overridden.

This member implements an interface member. For more information, consult the documentation on the interface.

Overridden.

This member implements an interface member. For more information, consult the documentation on the interface.

Occurs when a property is changed in the renderer that should result in a redraw operation.

The color used to draw the border of the header of the current row.

The color used to draw the background of the header of the current row.

The color used to draw the text on group headers.

The color used to draw the glyphs on group headers.

The color used to draw the divider on group headers.

The color used to draw the shadow on group headers.

The color used to draw the background on group headers.

The color used to fill the background of alternate rows when enabled.

The color used to draw the border of a hot column header.

The color used to draw the border of a normal row header.

The color used to draw the border of a hot row header.

The color used to draw the background of a hot row header.

The color used to draw the background of a normal row header.

The color used to draw the background of a hot column header.

The color used to draw the border of a normal column header.

The color used to draw the background of a normal column header.

The color used to draw the border of a current column header.

The color used to draw the background of a current column header.

The color used to draw the background of a selection that is not focused.

The color used to draw the background of a selection that is focused.

The color used to draw the foreground of a selection that is not focused.

The color used to draw the foreground of a selection that is focused.

The color used to draw grid lines.

Indicates whether drop shadows are drawn.

Indicates when the backgrounds of columns are shaded.

The color scheme in use by the renderer.

The column header style in use by the renderer.

The group header style in use by the renderer.

Provides a way of storing text formatting information that is not tied to either GDI or GDI+.

Flags that control how text is drawn.

An object that controls how text is drawn.

Creates formatting information.

Whether text is laid out in right-to-left reading order. Whether text is allowed to wrap. How text is aligned horizontally. How text is aligned vertically. Whether text is clipped. A new TextFormattingInformation instance.

Cleans up all resources used by the class.

A strongly-typed resource class, for looking up localized strings, etc.

Returns the cached ResourceManager instance used by this class.

Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class.

Looks up a localized string similar to The specified array does not have the correct number of indices..

Looks up a localized string similar to The attempted operation is not supported while the grid is databound..

Looks up a localized string similar to An edit operation cannot be started because an existing editor is active. Explicitly end the current edit operation, indicating whether or not to commit changes, before attempting to start a new one..

Looks up a localized string similar to The specified type must inherit from Control and implement ISandGridCellEditor..

Looks up a localized string similar to The attempted operation is not valid because the group is not currently attached to a grid..

Looks up a localized string similar to The Insert method cannot be called on a collection of rows that is currently being sorted. To add rows to the collection, use the Add method, and they will be inserted at the appropriate point..

Looks up a localized string similar to The size returned by the MeasureCore function cannot be negative in either dimension..

Looks up a localized string similar to The specified value cannot be a negative number..

Looks up a localized string similar to The attempted operation is not valid when no editor is active..

Looks up a localized string similar to The attempted operation is not valid outside a grid. You need to ensure the element on which you are performing the operation has been added to a grid. If you are using nested grids, ensure that the grid is actually hosted inside a SandGrid control..

Looks up a localized string similar to The specified array cannot contain null entries..

Looks up a localized string similar to An invalid attempt was made to access a databound feature on an object that is not databound..

Looks up a localized string similar to The specified value must be a positive integer..

Looks up a localized string similar to The specified object cannot be used because it does not belong to the grid..

Looks up a localized string similar to Reentrancy is not supported within the current method. Check that your code does not call methods such as DoEvents that can result in user interaction with the grid while an existing grid event is still being processed..

Looks up a localized string similar to The rows in the grid have not been sorted appropriately for grouping. This might be because the data source to which the grid is bound does not support sorting correctly..

Looks up a localized string similar to The Cells collection of the SingleCellRow has been modified. To use a SingleCellRow there must always be at least one cell present..

Looks up a localized string similar to Virtual mode cannot be enabled while the grid is in its current state. The grid must be free of rows and unsorted..

Looks up a localized string similar to The specified type does not inherit from GridRow..

Looks up a localized string similar to The requested operation is not valid in a grid operating in virtual mode..

Looks up a localized string similar to The number of rows allowed in virtual mode is currently capped at 1000000..

Looks up a localized string similar to This message is being displayed because an exception occurred while the grid was trying to process data and the host application has not hooked the DataError event. The most common cause for a data exception is a failure in converting one datatype to another. A common way of handling the event is to display a message box to the user indicating they have entered invalid data (in such a case). Details of the exception appear below..

Looks up a localized string similar to Unhandled Data Exception.

Provides facilities for printing a SandGrid control.

Overridden.

Indicates whether printed elements will be shrunk to fit the boundaries of the page.

Provides a fully-functioning grid control.

Initializes a new instance of the SandGrid class.

Raises the PopulateVirtualRow event.

The arguments assocated with the event.

Raises the ElementsMoved event.

The arguments associated with the event.

Raises the BeforeCheck event.

The arguments associated with the event.

Raises the AfterCheck event.

The arguments associated with the event.

Raises the ColumnHeaderClick event.

The arguments associated with the event.

Raises the ColumnResized event.

The arguments associated with the event.

Raises the ColumnsReordered event.

The arguments associated with the event.

Raises the BeforeExpand event.

The arguments associated with the event.

Raises the BeforeCollapse event.

The arguments associated with the event.

Raises the AfterExpand event.

The arguments associated with the event.

Raises the AfterCollapse event.

The arguments associated with the event.

Occurs when a column header is clicked.

Occues when the user has resized a column.

Occurs when a row is about to be expanded.

Occurs when a row is about to be collapsed.

Occurs when a row has just been expanded.

Occurs when a row has just been collapsed.

Occurs when a row is about to have its check state changed by the user.

Occurs after a row has had its check state changed by the user.

Occurs when elements have been moved by the user.

Occurs when data is needed for display in virtual mode.

Occurs when the columns are reordered by the user.

The columns into which data in the grid is divided.

Indicates what happens when the user clicks the mouse in whitespace.

Indicates how null values are detected and generated.

Indicates what effect clicking on a group heading will have.

Specifies the string used to represent a null value in the grid.

Specifies the behavior when the user clicks and drags on a cell.

Specifies the behavior when the user clicks and drags on a column header.

Indicates the size of each row when virtual mode is enabled.

Indicates how many rows are present when virtual mode is enabled.

If enabled, data is loaded on-demand and discarded when not needed.

Indicates the effect of clicking and dragging on a row.

Indicates whether the user is able to resize rows in the grid.

Indicates whether images in selected columns are drawn highlighted.

Indicates how key presses can initiate an edit.

Indicates how mouse actions can initiate an edit.

Indicates whether the primary cell or the cell under the mouse cursor is edited on a row edit.

Indicates whether alternate rows are shaded for ease of reading.

The separation between the image and text inside cells.

Indicates whether an entire row will be highlighted when selected.

Indicates whether sorted rows are grouped together visually.

The column to sort by.

The type of sorting performed.

The column to group by.

The type of grouping performed.

Indicates how grid lines are displayed in the grid.

Indicates whether the user is able to collapse groups.

The amount, in pixels, to indent the contents of the primary column in nested rows.

Indicates whether lines are drawn to show the relationship of indented nodes.

Indicates whether lines and buttons are drawn for the root items.

Indicates whether the expand button will be displayed for nested rows.

The scope of selection allowed within the grid.

The column in which the highlight for a row will start, and that will contain other primary data.

Indicates whether a resize operation occurs in real time.

Indicates the width in pixels of row headers.

Indicates whether Row headers are visible.

Indicates whether column headers are visible.

Indicates what happens when a parent row is double-clicked.

A collection of GridElements that are currently selected.

Finds all selected cells, whether selected directly or under a selected column or row.

An array of GridCell instances.

Unselects all elements.

Determines whether the specified element is present in the collection.

The element to locate in the collection. A value indicating whether the element was found in the collection.

Determines the index of the specified element in the collection.

The element to locate in the collection. A value indicating the index of the element.

Creates an array based on the currently selected elements.

An array of GridElement derived class instances.

Locates the item at the specified index in the collection.

The index at which the item resides. The element at the specified index.

Provides a user interface for configuring the sorting and grouping order within a grid.

Initializes a new instance of the SortOrderPresenter class.

Raises the BeforePushSort event.

The arguments associated with the event.

Raises the BeforeDisplaySort event.

The arguments associated with the event.

Overridden.

Occurs when the control is about to apply a sort to a grid.

Occurs when the sorting in the grid has changed and must be displayed by the control.

Indicates whether the control will automatically size itself.

Overridden.

The type of border to draw in the control.

Indicates whether grouping will be enabled for the first column.

The grid which the control will sort.

The renderer in use by the control.

Provides a column whose default cell type is a push button.

Note that this column is only available in the version of the product built for .NET 2.0+.

Initializes a new instance of the GridButtonColumn class.

Raises the ButtonClicked event.

The arguments associated with the event.

Overridden.

Occurs when a button is clicked.

Overridden.

Provides facilities for managing an interactive grid cell.

A cell of data to display within a grid row.

Initializes a new instance of the GridCell class.

Initializes a new instance of the GridCell class, with the specified text.

The text to show inside the cell.

Initializes a new instance of the GridCell class, with the specified image.

The default value of the Image property.

Initializes a new instance of the GridCell class.

The text to show inside the cell. The default value of the Image property.

Initializes a new instance of the GridCell class.

The text to show inside the cell. The image to show inside the cell. The font to use for displaying text in the cell.

Overridden.

Draws the cell.

Objects and information to use to render the cell. The font of the row containing the cell. Whether the cell should be drawn as selected. The object to use to control measuring and drawing of text.

Overridden.

Remove the cell from its parent row.

Overridden.

Starts an edit operation on the cell.

Overridden.

Must be called when the effective value of the cell changes.

A value indicating whether the change of value resulted in a sort operation. Developers writing specialized cells should call this method when the value of the cell changes. The return value should dictate to your property setter whether or not it is necessary to call RedrawNeeded or MeasureNeeded.

Overridden.

Obtains the value in the cell.

The value of the cell. This method returns a databound value if it can, null if the value is null, or the value returned by GetValueCore.

Obtains the value in the cell.

The value of the cell.

Sets the value in the cell.

The value to set. This method pushes databound value if it can, sets the core value to null, or calls SetValueCore.

Sets the value in the cell.

The value to set.

The color with which to draw the background of the cell.

The color with which to draw text in the cell.

The bounds of the area that is painted with a selection rectangle.

The bounds of the area in which the content of the cell lies.

The image to display in the cell.

Overridden.

The cell that precedes this one.

The column that follows this one.

Indicates whether the cell contains no value.

The text in the cell.

The parent column containing the cell, if any.

The parent row containing the cell, if any.

Initializes a new instance of the InteractiveGridCell class.

Overridden.

Called when the button is clicked.

Calculates the boundaries of the interactive portion of the cell.

A rectangle representing the interactive portion of the cell.

Indicates whether the button is drawn.

Indicates whether the button is being hovered over.

Indicates whether the button is being pressed.

Provides a cell containing a push button.

Initializes a new instance of the GridButtonCell class.

The initial value of the Text property..

Overridden.

The margin to apply around the outside of the button.

Provides a column whose default cell type is a checkbox.

Note that this column is only available in the version of the product built for .NET 2.0+.

Initializes a new instance of the GridCheckBoxColumn class.

Overridden.

Indicates whether the checkboxes allow selection of an indeterminate state.

Provides a cell containing a checkbox.

Initializes a new instance of the GridCheckBoxCell class.

Overridden.

The check state of the cell.

A cell for displaying decimals.

A strongly-typed cell to be used in combination with a strongly-typed column.

Overridden.

Initializes a new instance of the GridDecimalCell class.

The initial value of the cell.

Initializes a new instance of the GridDecimalCell class.

Overridden.

The value of the cell.

A column for displaying decimals.

A strongly-typed grid column to be used in combination with strongly-typed grid cells.

Initializes a new instance of the GridColumn class.

Overridden.

The name of the type of data suitable for displaying in the column.

The string with which to format data in cells.

Initializes a new instance of the GridDecimalColumn class.

Overridden.

A cell for displaying integers.

Initializes a new instance of the GridDoubleCell class.

The initial value of the cell.

Initializes a new instance of the GridDoubleCell class.

Overridden.

The value of the cell.

A column for displaying doubles.

Initializes a new instance of the GridDoubleColumn class.

Overridden.

Provides formatting and grouping capabilities suitable for file sizes in bytes.

A generically-typed grid column.

The type of data the column will display.

Initializes a new instance of the GridColumn class.

Overridden.

Initializes a new instance of the GridFileSizeColumn class.

The initial value of the Text property. The initial value of the Width property.

Overridden.

The threshold at which a value starts being classified as Small.

The threshold at which a value starts being classified as Medium.

The threshold at which a value starts being classified as Large.

The text to display for the Zero group.

The text to display for the Tiny group.

The text to display for the Small group.

The text to display for the Medium group.

The text to display for the Large group.

A column that knows how to map its formatted value to a value in another table.

Initializes a new instance of the GridForeignKeyColumn class.

Initializes a new instance of the GridForeignKeyColumn class, with the specified text and the specified width.

The text shown in the column heading. The width of the column.

Overridden.

The sort expression to apply when selecting valid values for fields.

The filter to apply when selecting valid values for fields.

The name of the column whose value should be looked up based on a primary key value in this column.

The name of the table that holds the primary key.

Provides friendly group names based on an integer lookup.

A column for displaying integers.

Initializes a new instance of the GridIntegerColumn class.

Overridden.

Initializes a new instance of the GridFriendlyGroupNameColumn class.

Overridden.

The group names for the column.

Provides a column whose default cell type is a hyperlink.

Note that this column is only available in the version of the product built for .NET 2.0+.

Initializes a new instance of the GridHyperlinkColumn class.

Overridden.

The color with which normal links are drawn.

The color with which hot links are drawn.

Overridden.

Provides a cell containing a hyperlink.

Initializes a new instance of the GridHyperlinkCell class.

The initial value of the Text property..

Overridden.

A column for displaying an integer value as progress between defined minimum and maximum values.

Initializes a new instance of the GridProgressBarColumn class.

Overridden.

The size of the progress bar.

The minimum that a value can be.

The maximum that a value can be.

Provides a grid row that hosts a single cell.

A row of data to be displayed in a grid.

Initializes a new instance of the GridRow class.

The text to put in the first cell in the row.

Initializes a new instance of the GridRow class.

The text to put in the first cell in the row. The image to put in the first cell in the row.

Initializes a new instance of the GridRow class.

The text to place in the cells in the new row.

Initializes a new instance of the GridRow class.

The cells to place in the new row.

Instructs the row whether to be filtered out of visibility.

Obtains a value indicating whether the row has been filtered out visually.

A boolean value.

Starts an edit operation on the primary column.

A boolean indicating whether the edit operation was successfully started.

Starts an edit operation on the specified column.

The column under which the cell to be edited lies. A boolean indicating whether the edit operation was successfully started.

Overridden.

Raises the BeforeExpand event on the associated SandGrid.

The arguments associated with the event.

Raises the AfterExpand event on the associated SandGrid.

The arguments associated with the event.

Raises the BeforeCollapse event on the associated SandGrid.

The arguments associated with the event.

Raises the AfterCollapse event on the associated SandGrid.

The arguments associated with the event.

Overridden.

Indicates whether the row can be resized.

Called when the user clicks on the checkbox.

Arguments indicating the trigger for the action.

Overridden.

Remove the row from either its parent row or the grid in which it resides.

Obtains an array containing all rows that directly or indirectly descend from this one.

An array of rows.

Obtains the value in the specified cell.

The column under which the cell lies. An object that implements the IComparable interface. This method is used by the sorting functionality.

Sets the value at the specified cell.

The column under which the cell lies. The value to set in the cell.

Obtains the image contained in the specified cell.

The column under which the cell lies. The image contained in the cell.

Notifies the row that the value has changed under a specified column.

The column under which the value has changed. A value indicating whether the change resulted in a sort operation.

Causes the row to paint its header background.

Draws the expand button.

The rendering context in which to draw.

Draws the check box.

The rendering context in which to draw.

Draws the cells under the row and columns passed.

The rendering context in which to draw. The bounds of the area in which to draw the cells. The columns whose cells will be drawn. The text formatting information corresponding to the columns to draw.

Draws the grid lines for the row.

The rendering context in which to draw. The columns being drawn.

Causes the element to paint its contents.

Objects and information to use to render the row. The rectangle surrounding the area to draw. The columns that are being drawn. This does not necessarily represent all columns in the grid. The StringFormat instances to use for text layout of their equivalent columns.

Draws a virtual cell by calling the DrawCell method on the specified column.

Objects and information to use to render the row. The column containing the cell being rendered. The value of the cell. The font to use for drawing text. The image associated with the cell. The rectangle surrounding the area to draw. Whether the cell lies within a selection highlight. Text formatting information. The foreground color to use for drawing text.

Draws the tree hierarchy lines associated with the row.

The context in which rendering is being invoked.

Calculates the amount by which content in the row should be indented due to the hierarchy of a tree.

An integer number of pixels. The default implementation of this method returns Grid.IndentationSize multplied by IndentationLevel.

Reduces the size of the specified bounds, taking in to account the indentation of the row and any other features.

The original bounds. The modified bounds.

Causes the element to paint its background.

An object describing the rendering context.

Overridden.

Calculates the position and size of the expand button for the row.

The primary column in the grid. A Rectangle structure.

Performs any layout logic for the row that relies on column layout.

An array of the all columns in the grid. An array of the displayed columns in the grid. The primary column.

Overridden.

Overridden. Returns the text in the primary cell of the row, if possible.

Indicates whether the tree of rows leading to this row is completely expanded.

Indicates the state of the checkbox.

Indicates whether the checkbox is checked.

The first visible cell in the row.

The last visible cell in the row.

The object to which the row is bound.

Indicates whether the contents of the row can be edited.

Indicates whether the row has any cells present.

The cells contained in the row.

The index of the row in the grid, treating all nested rows as flat.

The group the row belongs to.

The bounds of the row header.

The previous visible row.

The next visible row.

The height of the row. Specify zero to force the row to base its height on its contents.

The indentation level of the row. If the row is nested within other rows, this will be a nonzero value.

Indicates whether the expand button will still be drawn for the row even if there are no child rows.

Indicates whether any child rows of this row are visible.

The rows of data that are nested inside this row rather than being direct descendents of the grid.

Indicates whether the row contains child rows.

Use this property rather than checking Rows.Count because the rows collection is delay-created the first time the Rows property is accessed.

The parent row containing the row, if any.

Overridden. This property returns the ParentRow property.

Initializes a new instance of the SingleCellRow class.

The text to go in the cell. The image to go in the cell.

The text in the row.

The image to display in the row.

A generically-typed grid cell.

The type of data the cell will hold.

Initializes a new instance of the GridCell class.

The initial value of the cell.

Initializes a new instance of the GridCell class.

Overridden.

The value of the cell.

Specifies a type of border that can be shown on a .

No border is shown.

A border is drawn around the whole control.

A border is drawn around the left, top and right sides of the control, leaving the bottom free to align next to a grid.

Specifies how a column will automatically sort itself when clicked.

The column will not apply a sort when clicked.

The column will apply a simple sort by itself when clicked.

The column will add to a multiple-column sort when clicked with the shift key held down, and apply a single-column sort without.

Specifies how the foreground color of a cell is determined.

The foreground is determined by the row or the cell itself.

The foreground is determined by the column.

The foreground is determined by the grid.

Specifies the scope of an operation that deals with grid rows.

All rows are included in the operation.

Only onscreen rows are included in the operation.

Specifies which part of a grid column to create a text format for.

Creates a text format for cells.

Creates a text format for the header.

Specifies what happens when the mouse is clicked in whitespace in the grid.

No action is taken.

The selection is cleared.

Specifies which elements of state to persist for a grid.

The display order of columns will be persisted.

The width of columns will be persisted.

The visibility of columns will be persisted.

The sort column and direction will be persisted.

All available metadata will be persisted.

Specifies what happens when a parent row is double clicked.

The row is expanded or collapsed.

The row is activated.

Specifies which cell is edited when a row enters edit mode.

The cell under the primary column will be edited.

The cell clicked upon will be edited.

Specifies how SandGrid interprets and generates null values.

A null is taken to mean a null object reference.

A null is taken to mean an instance of DBNull.Value.

Specifies what effect clicking on a group heading will have.

Clicking on a group heading will have no effect.

Clicking on a group heading will select all the rows underneath it if multiple selection is allowed.

Clicking on a group heading will expand or collapse the group.

Clicking on a group heading will select it.

Specifies what effect clicking (and dragging) on a column header will have.

Clicking on a column header will have no effect.

Clicking on a column header will sort by that column, and dragging will subsequently start a column reorder operation.

Clicking on a column header will select that column, and dragging will select more columns.

Raises the ItemDrag event on the SandGrid control.

Specifies an operation that can encouter an exception that will be exposed by the DataError event.

The grid was trying to obtain the value of a cell.

The grid was trying to apply a new value to a cell.

The grid was trying to format a value for display.

The grid was trying to parse a formatted value back into its native form.

Specifies what effect dragging from a cell will have.

Dragging from a cell will have no effect.

Dragging from a cell will extend the selection to the target of the drag.

Raises the ItemDrag event on the SandGrid control.

Specifies what effect dragging from a row will have.

Dragging from a row will have no effect.

Dragging from a row will extend the selection to the target of the drag.

Dragging from a row will move the row.

Raises the ItemDrag event on the SandGrid control.

Specifies how a column will size itself automatically.

The column will not autosize.

The column will expand to fill all available space in the viewport.

The column will expand so that its items are fully viewable.

Specifies which mouse actions will initiate an edit operation in a grid.

No mouse action will initiate an edit.

Single-clicking a selected item will result in a delay followed by an edit.

Double-clicking an item will initiate an edit.

Specifies which keyboard actions will initiate an edit operation in a grid.

No keyboard action will initiate an edit.

Entering a character will initiate an edit and the character will be passed to the editor.

Pressing F2 will invoke the editor for the current selection.

Entering a character or pressing F2 will start an edit operation.

Specifies a mode of editing for an editor.

The editor is not active.

The editor is visible and its value shown, but the user has not started editing.

The editor is visible and the user is editing its value.

Specifies a means of displaying a boolean value.

The value is displayed in its natural state.

The value is displayed in a friendly "Yes" or "No" state.

The value is displayed as a graphical check mark.

Specifies a means of triggering a change in the check state of a row.

The user used the keyboard to trigger the action.

The user clicked on the checkbox to trigger the action.

Specifies a means of triggering the expansion or collapse of a row.

The user used the keyboard to trigger the action.

The user clicked on the expand button to trigger the action.

The user double-clicked on the row to trigger the action.

Unknown or programmatic trigger.

Specifies how a row selection is displayed.

No highlight is shown for the selection.

The entire row is selected.

The entire row starting from the beginning of the contents of the primary column is selected.

Only the contents of the primary column are selected.

Specifies how grid lines are displayed in a grid.

No grid lines are displayed.

Only horizontal grid lines are displayed.

Only vertical grid lines are displayed.

Both horizontal and vertical grid lines are displayed.

Specifies how scrollbars reveal the blank page beyond the logical area to scroll.

The area is never visible.

The area is only accessibly by scrolling line by line or using the mouse wheel.

The area is always visible by scrolling to it.

Specifies how an element is resized by the user.

The element cannot be resized by the user.

When the element size is changed, all following elements are offset.

The size of the element plus that of its neighbor is changed so that the total size of elements is maintained.

The scope of selection allowed in a grid.

Only entire rows may be selected.

Any individual cell within a row may be selected.

A direction in which selection can be advanced.

The selection will be moved up.

The selection will be moved down.

The selection will be moved left.

The selection will be moved right.

A method in which selection can be advanced.

Only the focused element will be changed.

The selection will be moved to the new element.

The selection will be increased to encompass the new element.

A method signature describing a method that will handle grid row expand/collapse events.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle grid row check events.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle grid row events.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle grid edit events.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle grid edit events.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle grid data errors.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle selection changed events.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle formatting events.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle data binding completion events.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle events dealing with elements that have been moved.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle events dealing with a grid.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle events that choose an editor to use for a cell.

The object that sent the event. The arguments associated with the event.

A method signature describing a method that will handle events that deal with sort columns and directions.

The object that sent the event. The arguments associated with the event.

Arguments passed to an event dealing with elements that have been moved.

The grid on which the operation occurred.

The elements that were moved.

Arguments passed to an event dealing with data binding completion.

The grid on which databinding occurred.

The type of change that occurred.

The original event arguments generated by the binding manager.

Arguments passed to an event dealing with a grid.

The grid associated with the event.

Arguments passed to an event dealing with a change in grid sorting.

The columns being sorted.

The directions in which the columns are being sorted.

Arguments passed to an event dealing with a change in selection.

Arguments passed to an event dealing with a data error.

Arguments passed to an event dealing with a row and column.

Arguments passed to an event that needs information on a grid row and column.

Arguments passed to an event dealing with a grid row.

The row associated with the event.

The column associated with the event.

Whether the event should be cancelled.

The operation that was in progress when the exception was thrown.

The value that caused the data error.

The exception that was thrown.

Indicates whether the exception will be re-thrown by the grid.

Arguments passed to an event dealing with an edit operation being committed.

The formatted value in the editor.

Arguments passed to an event that decides which editor should be used to edit a cell.

The type of editor to use.

Arguments passed to an event dealing with an imminent edit operation.

The editor that will be handling the edit operation.

Arguments passed to formatting events.

The value in the cell.

The type required by the target of the transformation.

Arguments passed to an event dealing with a change in the check state of a row.

The action that triggered the operation.

Whether to cancel the operation.

Arguments passed to an event dealing with the expansion or collapse of a grid row.

The action that triggered the operation.

Whether to cancel the operation.

A method signature describing a method that will handle events dealing with a grid column.

The object that sent the event. The arguments associated with the event.

Arguments passed to an event dealing with a grid column.

The GridColumn associated with the event.

A collection of GridCell instances belonging to a data host.

Indicates whether the specified index is a valid index within the collection.

The index to text. A value indicating the validity of the index.

Overridden.

Adds an array of GridCell instances to the collection.

The cells to add.

Adds a cell to the collection.

The cell to add to the collection. The index of the new cell in the collection.

Inserts a cell into the collection at a given offset.

The index at which to insert the cell. The cell to insert.

Removes the specified cell from the collection.

The cell to remove.

Tests to see whether the specified cell exists in the collection.

The cell to look for. A boolean indicating whether the cell was found.

Locates the specified cell in the collection and returns its index.

The cell to look for. The index of the cell in the collection if found; otherwise -1.

Copies the contents of the collection into the specified array.

The array into which to copy the cells. The index at which to start copying.

Obtains the cell at the specified index in the collection.

The index of the cell. The cell at the specified index.

A collection of GridRow instances belonging to a data host.

Indicates whether the specified index is a valid index within the collection.

The index to text. A value indicating the validity of the index.

Sets the sorting to be performed on the collection.

The columns to be sorted by. The directions in which to sort the columns.

Removes any sorting being performed on the collection.

Obtains the current sort from the collection of rows.

The columns participating in the sort. The sort directions associated with the columns.

Overridden.

Adds an array of GridRow instances to the collection.

The rows to add.

Adds a row to the collection.

The row to add to the collection. The index of the new row in the collection.

Inserts a row into the collection at a given offset.

The index at which to insert the row. The row to insert.

Removes the specified row from the collection.

The row to remove.

Tests to see whether the specified row exists in the collection.

The row to look for. A boolean indicating whether the row was found.

Locates the specified row in the collection and returns its index.

The row to look for. The index of the row in the collection if found; otherwise -1.

Copies the contents of the collection into the specified array.

The array into which to copy the rows. The index at which to start copying.

Compares two grid rows.

The first grid row. This must derive from GridRowBase. The second grid row. This must derive from GridRowBase. An integer indicating how the two rows compare.

Compares two grid rows.

The first grid row. The second grid row. An integer indicating how the two rows compare.

Removes all objects from the collection.

Causes all loaded virtual rows to be unloaded, and new ones created.

Indicates whether the collection is being sorted.

Obtains the row at the specified index in the collection.

The index of the row. The row at the specified index.

Gets the number of elements contained in the collection.

Represents the top-level view of a set of columns and rows that make up a logical grid.

Initializes a new instance of the DataHost class.

Called when data binding is completed.

The arguments associated with the event.

Creates an instance of a GridRow-derived class for use in databinding.

A GridRow derived class instance.

Raises the DataSourceChanged event.

The arguments associated with the event.

Raises the DataMemberChanged event.

The arguments associated with the event.

Creates a new row populated with cells of the appropriate type for the columns in the grid.

A new instance of the GridRow class.

Marks the data host as needing to be measured.

Performs any tasks that need to be done before a measure operation is done.

The size of the viewport available. The default implementation of this method performs column size adjustments.

Obtains the first visible row in the grid.

An instance of the GridRow class.

Overridden.

Removes any sorting in operation.

Applies sorting with the specified columns and directions.

The columns to sort data by. The directions in which to sort the columns.

Sets the state of the grid based on a state previously saved with the SerializeState method.

The state to restore.

Sets the state of the grid based on a state previously saved with the SerializeState method.

The state to restore. Which serialized properties to restore.

Returns the state of the grid as a string that can be restored later.

A string containing XML.

Expands all rows.

Collapses all rows.

Overridden.

Locates the column containing the specified position.

The position at which to look. The column containing the position. The Y coordinate is not checked for lying within the boundaries of the column header; rather, it is simply checked to ensure it lies within the boundaries of the grid.

Overridden.

Locates the element lying under the specified cursor position.

The position at which to look. The element containing the position.

Copies the selected rows to the clipboard

Copies the selected cells to the clipboard

Whether to include column header text as the first row.

Finds all selected cells, whether selected directly or under a selected column or row.

An array of GridCell instances.

Selects all available elements in the grid.

Called by an element when it cannot advance the focus any further.

The direction in which the focus should be advanced. A value indicating whether the grid itself was able to advance the focus.

Selects the specified element after unselecting any other selected elements, and sets the focus to the element.

The element to select.

Unselects all grid elements that are selected.

The type of row to create when automatically creating rows during databinding.

Indicates how null values are detected and generated.

Indicates what effect clicking on a group heading will have.

Indicates whether checkboxes are present on rows.

Specifies the behavior when the user clicks and drags on a cell.

Specifies the string used to represent a null value in the grid.

Indicates whether the selection is hidden when the grid does not have focus.

Specifies the behavior when the user clicks and drags on a column header.

The type of grouping performed.

The type of sorting performed.

If a multi-column sort is in operation, this property will return the first sorted column type.

The column to group by.

The column to sort by.

If a multi-column sort is in operation, this property will return the first sorted column.

Indicates the effect of clicking and dragging on a row.

Indicates whether the user is able to resize rows in the grid.

Indicates whether columns corresponding to properties on bound objects will be automatically generated if they do not already exist.

Indicates whether the grid is nested within another grid.

Gets or sets the data source that the grid is bound to.

Gets or sets the name of the list or table in the data source that the grid is bound to.

Indicates whether images in selected columns are drawn highlighted.

The height of any group heading shown above the row.

Indicates whether alternate rows are shaded for ease of reading.

The separation between the image and text inside cells.

Indicates how grid lines are displayed in the grid.

Indicates whether lines are drawn to show the relationship of indented nodes.

Indicates whether lines and buttons are drawn for the root items.

Indicates whether the user is able to select multiple elements.

Indicates whether the user is able to collapse groups.

An object that can have its contents enumerated to show all groups.

Whether items in the grid should be laid out in right-to-left reading order.

The number of rows that are visible in the grid.

The index of the first visible column in the grid.

The number of columns that are visible in the grid.

The amount, in pixels, to indent the contents of the primary column in nested rows.

Indicates whether the expand button will be displayed for nested rows.

Indicates what happens when a parent row is double-clicked.

The column in which the highlight for a row will start, and that will contain other primary data.

Indicates whether an entire row will be highlighted when selected.

Indicates the size of each virtual row.

Indicates whether the grid is in virtual mode.

Indicates the number of virtual rows to display.

Indicates whether a resize operation occurs in real time.

The offset, in pixels, of a vertical insertion marker that can optionally be drawn on the grid.

Use -1 to hide the marker.

The offset, in pixels, of a horizontal insertion marker that can optionally be drawn on the grid.

Use -1 to hide the marker.

Indicates whether individual GridCell instances are created to populate each row.

The scope of selection allowed within the grid.

Indicates whether the row headers will stay fixed at the top of the viewport regardless of the scroll position.

Indicates whether row headers are visible.

Indicates the width in pixels of row headers.

Indicates whether the column headers will stay fixed at the top of the viewport regardless of the scroll position.

Indicates what happens when the user clicks the mouse in whitespace.

Indicates whether column headers are visible.

The columns in to which to divide data contained in the host.

The rows of data belonging to the host.

An IEnumerable that can be used to enumerate through a hierarchical layout of visible rows as if they were flat.

An IEnumerable that can be used to enumerate through a hierarchical layout of rows as if they were flat.

The SandGrid to which the data host belongs.

In a nested grid scenario, returns the element acting as a parent for the grid.

The number of elements that are selected.

The grid elements that are selected.

Indicates whether the primary cell or the cell under the mouse cursor is edited on a row edit.

A collection of GridColumn instances belonging to a data host.

Indicates whether the specified index is a valid index within the collection.

The index to text. A value indicating the validity of the index.

Sets the display indices of the columns in the collection.

An array of integers that correspond to columns in the collection.

Creates an array that represents all the columns in the collection.

An array of GridColumn instances.

Overridden.

Adds an array of GridColumn instances to the collection.

The columns to add.

Adds a column to the collection.

The column to add to the collection. The index of the new column in the collection.

Inserts a column into the collection at a given offset.

The index at which to insert the column. The column to insert.

Removes the specified column from the collection.

The column to remove.

Tests to see whether the specified column exists in the collection.

The column to look for. A boolean indicating whether the column was found.

Locates the specified column in the collection and returns its index.

The column to look for. The index of the column in the collection if found; otherwise -1.

Copies the contents of the collection into the specified array.

The array into which to copy the columns. The index at which to start copying.

An array of columns that are being displayed (but are not necessarily visible due to scrolling).

Obtains the column at the specified index in the collection.

The index of the column. The column at the specified index.

Obtains the column bound to the specified data property name.

The column or property name to which the column is bound. The column at the specified index.

A row that contains a nested grid.

Initializes a new instance of the NestedGridRow class.

Overridden.

The heading displayed above the nested grid.

The amount of margin to show around the nested grid.

The grid that lies within the row.

Specifies the style of group header to use with the Office 2007 renderer.

The header looks like a divider.

The header looks like a button.

Specifies the style of column header to use with the Office 2007 renderer.

Column headers appear as they would in Excel.

Column headers appear as they would in Outlook.

Specifies a color scheme for use with the Office 2007 renderer.

A blue color scheme.

A black color scheme.

A silver color scheme.

Specifies a type of glyph that can be drawn in a grid.

Indicates there is an edit operation underway.

Indicates the row that contains the focus.

Indicates an object has an error associated with it.

Specifies when the background of a column is shaded.

The background is never shaded.

The background is shaded when a column is being sorted by, but only if grouping is disabled.

The background is shaded when a column is being sorted or grouped.

A combination of visual states in which an object can be drawn.

The object has no special graphical state.

The object is selected.

The mouse is hovering over the object.

The mouse button is pressed over the object.

A class that contains common data used for rendering a grid.

A pen suitable for drawing grid lines.

Indicates whether the rendering operation is a print operation.

Indicates whether the selection is shown.

The renderer responsible for drawing common graphical elements.

Either the row that contains the focus or the row that contains the cell with focus, whichever is appropriate.

The cell that has the input focus, if any.

A Graphics object that can be used to draw on the surface of the control.

A Font object that can be used to draw text.

Indicates whether the control contains the input focus.

Indicates whether focus rectangles should be drawn on the control.

A renderer that mimics the visual features of Windows XP.

Initializes a new instance of the WindowsXPRenderer class.

Overridden.

Raises the RedrawNeeded event.

The arguments associated with the event.

Overridden.

This member implements an interface member. For more information, consult the documentation on the interface.

Occurs when a property is changed in the renderer that should result in a redraw operation.

Indicates how solid the background of alternate rows is drawn.

Indicates the color used to draw the background of alternate rows.

Indicates whether drop shadows are drawn.

Indicates when the backgrounds of columns are shaded.

A utility class to help bind a grid to different kinds of data.

Binds a grid with columns to a collection of class instances.

The grid to populate with data. An ICollection of object instances. The type of GridRow to instantiate for each object encountered.

Binds a grid with columns to a collection of class instances, recursing on a property that exposes a collection of further instances.

The grid to populate with data. An ICollection of object instances. The type of GridRow to instantiate for each object encountered. The name of the property on each instance that exposes child objects of the same type.

Transforms the data in a grid into a comma delimited text file.

The grid whose data should be exported. A string containing delimited text.

Transforms the data in a grid into a delimited text file.

The grid whose data should be exported. The settings to use for the export. Whether to include column headers. A string containing delimited text.

Transforms the data in a grid into HTML.

The grid whose data should be exported. A string containing HTML.

Transforms the data in a grid into HTML.

The grid whose data should be exported. The amount of spacing between table cells. The amount of padding in table cells. A string containing HTML.

Provides settings for a data export operation.

Settings to export to CSV format.

Initializes a new instance of the DelimitedDataExportSettings class.

The delimiter to use between fields.

The character to use for string or special values.

Indicates whether the string qualifier is used for all string values. If false, the qualifier is used when the value contains the string qualifier.

Contains global text strings used by SandGrid.

The string to display when an error is encountered converting a value to its proper type.

Friendly ways of describing dates.

The array must contain entries for Future, Today, Yesterday, Last Week, Two Weeks Ago and Previous.

An editor that uses a TextBox as its user interface.

Initializes a new instance of the GridTextBoxEditor class.

Overridden.

The grid owning the cell being edited.

Overridden.

A cell for displaying booleans.

Initializes a new instance of the GridBooleanCell class.

The initial value of the cell.

Initializes a new instance of the GridBooleanCell class.

Overridden.

The value of the cell.

A column for displaying booleans.

Initializes a new instance of the GridBooleanColumn class.

Overridden.

Indicates the text displayed for a false value when DisplayType is set to YesNo.

Indicates the text displayed for a true value when DisplayType is set to YesNo.

Indicates how the value will be displayed.

A column that will display an image if a bound condition is met.

Initializes a new instance of the GridConditionalImageColumn class.

Overridden.

The text to display for a true value when grouping rows by the column.

The text to display for a false value when grouping rows by the column.

The image to display when the condition is met.

The image to display when the condition is not met.

A cell for displaying DateTimes.

Initializes a new instance of the GridDateTimeCell.

The initial value of the cell.

Initializes a new instance of the GridDateTimeCell.

Overridden.

The value of the cell.

A column for displaying DateTimes.

Initializes a new instance of the GridDateTimeColumn class.

Overridden.

When set to true, enables a secondary sort to be applied after dates in the column have been grouped.

Overridden.

A column for displaying images.

Initializes a new instance of the GridImageColumn class.

Overridden.

A cell for displaying integers.

Initializes a new instance of the GridIntegerCell class.

The initial value of the cell.

Initializes a new instance of the GridIntegerCell class.

Overridden.

The value of the cell.