DataGridViewCell

Wisej.Web.DataGridViewCell

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Represents an individual cell in a DataGridView control.

public class DataGridViewCell : DataGridViewElement, ICloneable, ICommandSource, IUserData

Constructors

DataGridViewCell()

Initializes a new instance of DataGridViewCell.

Properties

CellRenderer

String: Returns the name of the cell renderer to use on the client side to render the cell. If it's null or empty, it defaults to "Cell".

The name of the cell renderer can be a fully qualified class name (i.e. "wisej.web.datagrid.cellRenderer.Cell") or just the class name (i.e. "ImageCell") in which case the client library prepends "wisej.web.datagrid.cellRenderer".

ColumnIndex

Int32: Returns the column index for this cell.

Command

ICommand: Returns or sets the ICommand implementation to invoke. (Default: null)

ContextMenu

ContextMenu: Returns or sets the shortcut menu associated with the cell. (Default: null)

Control

Control: Returns or sets a child control to display inside the cell.

DataGridView

DataGridView: Returns the DataGridView control associated with this DataGridViewCell.

DefaultNewRowValue

Object: Returns the default value for a cell in the row for new records.

Displayed

Boolean: Returns a value that indicates whether the cell is currently displayed.

Editable

Boolean: Returns whether the cell can be edited.

EditedFormattedValue

Object: Returns the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

Throws:

EditType

Type: Returns the type of the cell's hosted editing control.

ErrorText

String: Returns or sets the text describing an error condition associated with the cell.

FormattedValue

Object: Returns the value of the cell as formatted for display.

Throws:

FormattedValueType

Type: Returns the type of the formatted value associated with the cell.

FormattedValueTypeConverter

TypeConverter: Returns the type converter to use to convert a formatted value to the cell's value type.

Frozen

Boolean: Returns a value indicating whether the cell is frozen.

HasStyle

Boolean: Returns true it the Style property has been set.

HasUserData

Boolean: Checks if the UserData dynamic object was created and has any value.

Height

Int32: Returns the height of the cell.

InheritedState

DataGridViewElementStates: Returns the current state of the cell as inherited from the state of its row and column.

Throws:

InheritedStyle

DataGridViewCellStyle: Returns the style currently applied to the cell.

Throws:

IsCurrentCell

Boolean: Returns whether this is the current cell in the DataGridView.

IsInEditMode

Boolean: Returns a value indicating whether this cell is currently being edited.

OwningColumn

DataGridViewColumn: Returns the column that contains this cell.

OwningRow

DataGridViewRow: Returns the row that contains this cell.

ReadOnly

Boolean: Returns or sets whether the cell's data can be edited.

Resizable

Boolean: Returns a value indicating whether the cell can be resized.

RowIndex

Int32: Returns the index of the cell's parent row.

Selected

Boolean: Returns or sets whether the cell has been selected.

Size

Size: Returns the size of the cell.

Style

DataGridViewCellStyle: Returns or sets the style for the cell.

Tag

Object: Returns or sets the object that contains supplemental data about the cell. (Default: null)

ToolTipText

String: Returns or sets the ToolTip text associated with this cell.

UserData

Object: Returns a dynamic object that can be used to store custom data in relation to this cell.

UserPaint

Boolean: Enables or disables the user paint feature for this cell. When UserPaint is true, the application can handle the CellPaint event to draw custom content in the cell. (Default: False)

Value

Object: Returns or sets the value associated with this cell.

Throws:

ValueType

Type: Returns or sets the data type of the values in the cell.

ValueTypeConverter

TypeConverter: Return the type converter to use to convert the value in the cell to the formatted value.

Visible

Boolean: Returns a value indicating whether the cell is in a row or column that has been hidden.

Width

Int32: Returns the width of the cell.

Methods

Clone()

Creates a copy of this cell.

Returns: DataGridViewCell. The cloned DataGridViewCell.

CompareValue(newValue, oldValue)

Compares the new value being assigned to the cell with the previous value.

Parameter
Type
Description

newValue

New value being assigned to the cell.

oldValue

Current value assigned to the cell being replaced by newValue

Returns: Boolean. true if newValue and oldValue are different.

CreateEditingControl()

Creates a new instance of the edit control used to edit values in this cell.

Returns: Control.

Dispose(disposing)

Releases the resources used by the DataGridViewCell.

Parameter
Type
Description

disposing

true when this method is called by the application rather than a finalizer.

GetClipboardContent(rowIndex, firstCell, lastCell, inFirstRow, inLastRow, format)

Returns the formatted value of the cell to copy to the Clipboard.

Parameter
Type
Description

rowIndex

The zero-based index of the row containing the cell.

firstCell

true to indicate that the cell is in the first column of the region defined by the selected cells; otherwise, false.

lastCell

true to indicate that the cell is the last column of the region defined by the selected cells; otherwise, false.

inFirstRow

true to indicate that the cell is in the first row of the region defined by the selected cells; otherwise, false.

inLastRow

true to indicate that the cell is in the last row of the region defined by the selected cells; otherwise, false.

format

The current format string of the cell.

Returns: Object. An Object that represents the value of the cell to copy to the Clipboard.

Throws:

GetCommand()

Returns the command bound to the cell.

Returns: ICommand. The value contained in the DataGridViewCell.

GetEditedFormattedValue()

Returns the current, formatted value of the cell, regardless the cell being in edit mode.

Returns: Object. The current, formatted value of the DataGridViewCell.

Throws:

GetErrorText()

Returns a string that represents the error for the cell.

Returns: String. A string that describes the error for the current DataGridViewCell.

GetFormattedValue(value, cellStyle, valueTypeConverter, formattedTypeConverter)

Returns the value of the cell formatted for the client.

Parameter
Type
Description

value

The value to be formatted.

cellStyle

The DataGridViewCellStyle in for the cell.

valueTypeConverter

A TypeConverter providing custom conversion from the formatted type to the value type, or null if no custom conversion is required.

formattedTypeConverter

A TypeConverter providing custom conversion from the value type to the formatted type, or null if no custom conversion is required.

Returns: Object. The value of the cell or null if the cell does not belong to a DataGridView control.

Throws:

GetInheritedContextMenu()

Returns the inherited ContextMenu for the current cell.

Returns: ContextMenu. A ContextMenu instance if the DataGridViewCell, or the owner DataGridViewRow, or the owner DataGridViewColumn, or the owner DataGridView has a ContextMenu assigned; otherwise, null.

GetInheritedState()

Returns a value indicating the current state of the cell as inherited from the state of its row and column.

Returns: DataGridViewElementStates. A combination of DataGridViewElementStates values representing the current state of the cell.

GetInheritedStyle(includeVisualProperties)

Returns the style applied to the cell.

Parameter
Type
Description

includeVisualProperties

true to include inherited visual properties; otherwise, false to include only formatting properties.

Returns: DataGridViewCellStyle. A DataGridViewCellStyle that includes the style settings of the cell inherited from the cell's parent row, column, and DataGridView.

Throws:

GetToolTipText()

Returns a string that represents the tooltip text for the cell.

Returns: String. A string that describes the tooltip text for the current DataGridViewCell.

GetValue()

Returns the value of the cell.

Returns: Object. The value contained in the DataGridViewCell.

InitializeEditingControl(editor, style)

Initializes the control used to edit the cell.

Parameter
Type
Description

editor

The Control that is used to edit the cell.

style

The DataGridViewCellStyle that is in effect for the cell entering edit mode.

Throws:

OnCellFormatting(e)

Raised when the contents of a cell need to be formatted for display.

Parameter
Type
Description

OnClick(e)

Raised when the user clicks on a cell.

Parameter
Type
Description

OnDataGridViewChanged()

Called when the element is associated with a different DataGridView.

OnDoubleClick(e)

Raised when the user double-clicks on a cell.

Parameter
Type
Description

OnEnter(e)

Raised when the cell becomes the active cell.

Parameter
Type
Description

OnKeyDown(e)

Raised when the user types on the keyboard while the grid has the focus and it's not in edit more.

Parameter
Type
Description

e

A KeyEventArgs that contains the event data.

OnLeave(e)

Raised when the cell is not the active cell anymore.

Parameter
Type
Description

OnMouseClick(e)

Raised when the user clicks or taps on a cell.

Parameter
Type
Description

OnMouseDoubleClick(e)

Raised when the user double-clicks or double-taps on a cell.

Parameter
Type
Description

ParseFormattedValue(value, cellStyle, formattedTypeConverter, valueTypeConverter)

Converts a value to the actual cell value.

Parameter
Type
Description

value

The display value of the cell.

cellStyle

The DataGridViewCellStyle in effect for the cell.

formattedTypeConverter

A TypeConverter for the display value type, or null to use the default converter.

valueTypeConverter

A TypeConverter for the cell value type, or null to use the default converter.

Returns: Object. The cell value.

Throws:

RaiseCellCommandChanged(e)

Fires the CellCommandChanged event.

Parameter
Type
Description

ResetReadOnly()

Resets the ReadOnly state to inherit its value from the OwningColumn, OwningRowand the DataGridView.

SetCommand(command)

Sets the command for the cell.

Parameter
Type
Description

command

The cell command to set.

Returns: Boolean. True if the value has been set, otherwise false.

SetValue(value)

Sets the value of the cell.

Parameter
Type
Description

value

The cell value to set.

Returns: Boolean. True if the value has been set, otherwise false.

ShouldUpdate()

Indicates whether the cell data should be updated on the client even if the user didn't change the value when editing.Since 3.2.5

Returns: Boolean. true to force the cell to update the client.

Used to allow the server to update the cell after editing mode is terminated and the user didn't change anything. For example, a password cell can be obfuscated, or a custom cell may need to always format the rendered value when terminating edit mode.

Update()

Updates the cell on the client.

Inherited By

Name
Description

Displays a button widget in a DataGridViewCell cell.

Displays a CheckBox icon (not the actual control) in a DataGridViewCell cell.

Displays an editable ComboBox control in a DataGridViewCell cell when in edit mode.

Displays an editable DateTimePicker control in a DataGridViewCell cell when in edit mode.

Displays an image in a DataGridViewCell cell.

Displays a link widget in a DataGridViewCell cell.

Displays an editable MaskedTextBox control in a DataGridViewCell cell when in edit mode.

Displays an editable NumericUpDown control in a DataGridViewCell cell when in edit mode.

Displays an editable TextBox control in a DataGridViewCell cell when in edit mode.

Represents a column header in a DataGridView control.

Contains functionality common to row header cells and column header cells.

Represents a row header of a DataGridView control.

Implements

Name
Description

Provides access to the UserData and Tag properties associated to the component implementing this interface.

Defines an object that can invoke a Command.

Last updated

Was this helpful?