This topic has not yet been rated - Rate this topic

DataGridViewElementStates Enumeration

.NET Framework 4.5

Other Versions

Specifies the user interface (UI) state of a element within a DataGridView control.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

C++

[ComVisibleAttribute(true)]
[FlagsAttribute]
public enum DataGridViewElementStates

Members

	Member name	Description
	None	Indicates that an element is in its default state.
	Displayed	Indicates the an element is currently displayed onscreen.
	Frozen	Indicates that an element cannot be scrolled through the UI.
	ReadOnly	Indicates that an element will not accept user input to change its value.
	Resizable	Indicates that an element can be resized through the UI. This value is ignored except when combined with the ResizableSet value.
	ResizableSet	Indicates that an element does not inherit the resizable state of its parent.
	Selected	Indicates that an element is in a selected (highlighted) UI state.
	Visible	Indicates that an element is visible (displayable).

Remarks

Although these different states, like Frozen, are enforced by the UI, they can be programmatically overruled.

Examples

The following code example illustrates the use of this type. For more information, see How to: Perform a Custom Action Based on Changes in a Cell of a Windows Forms DataGridView Control.

private void dataGridView1_CellStateChanged(object sender,
    DataGridViewCellStateChangedEventArgs e)
{
    DataGridViewElementStates state = e.StateChanged;
    string msg = String.Format("Row {0}, Column {1}, {2}",
        e.Cell.RowIndex, e.Cell.ColumnIndex, e.StateChanged);
    MessageBox.Show(msg, "Cell State Changed");
}

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

System.Windows.Forms Namespace

DataGridView

DataGridViewElement

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)