Export (0) Print
Expand All
Expand Minimize
0 out of 1 rated this helpful - Rate this topic

DataGridViewElementStates Enumeration

Note: This enumeration is new in the .NET Framework version 2.0.

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)

[FlagsAttribute] 
[ComVisibleAttribute(true)] 
public enum DataGridViewElementStates
/** @attribute FlagsAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum DataGridViewElementStates
FlagsAttribute 
ComVisibleAttribute(true) 
public enum DataGridViewElementStates
 Member nameDescription
DisplayedIndicates the an element is currently displayed onscreen. 
FrozenIndicates that an element cannot be scrolled through the UI. 
NoneIndicates that an element is in its default state. 
ReadOnlyIndicates that an element will not accept user input to change its value. 
ResizableIndicates that an element can be resized through the UI. This value is ignored except when combined with the ResizableSet value. 
ResizableSetIndicates that an element does not inherit the resizable state of its parent. 
SelectedIndicates that an element is in a selected (highlighted) UI state. 
VisibleIndicates that an element is visible (displayable). 

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

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");
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.