Cell Class

Cell Class

Represents a cell in the grid.

Inheritance Hierarchy

SystemObject
Stingray.GridCell

Namespace: Stingray.Grid
Assembly: Stingray.GridControl (in Stingray.GridControl.dll) Version: 14.0.0.0

Syntax

C++

Copy

[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public class Cell : IDisposable

<TypeConverterAttribute(GetType(ExpandableObjectConverter))>
Public Class Cell
	Implements IDisposable

[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
public ref class Cell : IDisposable

The Cell type exposes the following members.

Methods

	Name	Description
	ApplyNewStyle	Applies a new style stored in this cell object.
	ClearStyle	Clears the embedded Style object.
	ClearValue	Clears the value of the cell.
	CopyCell	Copies the contents of another cell into this cell.
	CopyCells	Copies a range of cells.
	CopyStyle	Copies the new style over the style stored in this cell object.
	ExcludeStyle	Remove, in this cell's style, the attributes that are included in the given style.
	MoveCell	Moves a cell.
	MoveCells	Moves cells.
	ScrollInView	Scrolls the grid so that this cell is in view.
	ScrollInView(RedrawFlags, Boolean)	Scrolls the grid so that this cell is in view.
	Select(Boolean)	Selects or deselects this cell.
	Select(Boolean, Boolean)	Selects or deselects this cell.

Top

Properties

	Name	Description
	Col	Gets the managed grid's column index.
	ControlText	Gets the control text displayed in the cell.
	Dirty	Gets or sets the state of the cell contents
	Formula	Gets or sets the text value or formula for the cell.
	IsCurrent	Gets or sets whether the cell is selected or is the specified cell.
	Row	Gets the managed grid's row index.
	Style	Gets or sets the Style for this cell.

Top

Remarks

Instances of this class are available via the GridControl indexer. For example, the following C# source code obtains a Cell object referencing cell [1, 1] by using the indexer on a GridControl named myGridControl.

Copy

Cell cell = myGridControl[1, 1];

Once an instance of a cell is obtained, you can use it to manipulate the style for the cell that it references, or you can store it as a reference to a location in the grid.

Because the GridControl indexer property returns an instance of a Cell object and the Cell class offers a Style property, cell styles can be conveniently manipulated in source code using single lines of code.d For example, the following C# source code changes the Interior property of a grid cell to a hatched pattern with black as the foreground color and bisque as the background color.

Copy

myGridControl[1, 1].Style.Interior = Stingray.Grid.OGBrush.OGHatchedBrush(Color.Black, Color.Bisque, HatchStyle.Cross);

The following C# source code changes the style of cell [1, 2] to read-only with the text "Read Only".

Copy

myGridControl[1, 2].Style.Value = "Read Only";
myGridControl[1, 2].Style.ReadOnly = true;

Reference

Stingray.Grid Namespace