DataGridViewCell

Namespace: Wisej.Web

Assembly: Wisej.Framework (3.5.0.0)

• DataGridViewElement
  • DataGridViewCell

Represents an individual cell in a DataGridView control.

C#

public class DataGridViewCell : DataGridViewElement, ICloneable, ICommandSource

VB.NET

Public Class DataGridViewCell
    Inherits DataGridViewElement
    Implements ICloneable, ICommandSource

Constructors

DataGridViewCell()

Initializes a new instance of DataGridViewCell.

Properties

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:

• ArgumentOutOfRangeException The row containing the cell is a shared row; or the cell is a column header cell.
• InvalidOperationException ColumnIndex is less than 0, indicating that the cell is a row header cell.
• Exception Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. The exception object can typically be cast to type FormatException.

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:

• InvalidOperationException ColumnIndex is less than 0, indicating that the cell is a row header cell.
• ArgumentOutOfRangeException The row containing the cell is a shared row; or the cell is a column header cell.
• Exception Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. The exception object can typically be cast to type FormatException.

FormattedValueType

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

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:

• ArgumentException The cell is not contained within a DataGridView control and the value of its RowIndex property is not -1.
• ArgumentOutOfRangeException The cell is contained within a DataGridView control and the value of its RowIndex property is -1.

InheritedStyle

DataGridViewCellStyle: Returns the style currently applied to the cell.

Throws:

• InvalidOperationException The cell does not belong to a DataGridView control; or ColumnIndex is less than 0, indicating that the cell is a row header cell.
• ArgumentOutOfRangeException The row containing the cell is a shared row; or the cell is a column header cell.

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:

• ArgumentOutOfRangeException RowIndex is outside the valid range of 0 to the number of rows in the control minus 1.
• InvalidOperationException ColumnIndex is less than 0, indicating that the cell is a row header cell.

ValueType

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

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.

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:

• Exception Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. The exception object can typically be cast to type FormatException.

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	Boolean	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:

• InvalidOperationException The cell has no associated DataGridView.

ParseFormattedValue(value, cellStyle, formattedTypeConverter, valueTypeConverter)

Converts a value to the actual cell value.

Parameter	Type	Description
value	Object	The display value of the cell.
cellStyle	DataGridViewCellStyle	The DataGridViewCellStyle in effect for the cell.
formattedTypeConverter	TypeConverter	A TypeConverter for the display value type, or null to use the default converter.
valueTypeConverter	TypeConverter	A TypeConverter for the cell value type, or null to use the default converter.

Returns: Object. The cell value.

Throws:

• ArgumentNullException cellStyle is null.
• FormatException The FormattedValueType property value is null or the ValueType property value is null or value cannot be converted.
• ArgumentException value is null or the type of value does not match the type indicated by the FormattedValueType property.

ResetReadOnly()

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

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
DataGridViewButtonCell	Displays a button widget in a DataGridViewCell cell.
DataGridViewCheckBoxCell	Displays a CheckBox icon (not the actual control) in a DataGridViewCell cell.
DataGridViewComboBoxCell	Displays an editable ComboBox control in a DataGridViewCell cell when in edit mode.
DataGridViewDateTimePickerCell	Displays an editable DateTimePicker control in a DataGridViewCell cell when in edit mode.
DataGridViewImageCell	Displays an image in a DataGridViewCell cell.
DataGridViewLinkCell	Displays a link widget in a DataGridViewCell cell.
DataGridViewMaskedTextBoxCell	Displays an editable MaskedTextBox control in a DataGridViewCell cell when in edit mode.
DataGridViewNumericUpDownCell	Displays an editable NumericUpDown control in a DataGridViewCell cell when in edit mode.
DataGridViewTextBoxCell	Displays an editable TextBox control in a DataGridViewCell cell when in edit mode.
DataGridViewColumnHeaderCell	Represents a column header in a DataGridView control.
DataGridViewHeaderCell	Contains functionality common to row header cells and column header cells.
DataGridViewRowHeaderCell	Represents a row header of a DataGridView control.

Implements

Name	Description
ICommandSource	Defines an object that can invoke a Command.