DataGridViewElementStates Enumeration
TOC
Collapse the table of content
Expand the table of content

DataGridViewElementStates Enumeration

 

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

Member nameDescription
Displayed

Indicates the an element is currently displayed onscreen.

Frozen

Indicates that an element cannot be scrolled through the UI.

None

Indicates that an element is in its default state.

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).

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

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft