DataGridViewElementStates Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Specifies the user interface (UI) state of a element within a DataGridView control.
This enumeration supports a bitwise combination of its member values.
public enum class DataGridViewElementStates
[System.Flags]
[System.Runtime.InteropServices.ComVisible(true)]
public enum DataGridViewElementStates
[System.Flags]
public enum DataGridViewElementStates
[<System.Flags>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type DataGridViewElementStates =
[<System.Flags>]
type DataGridViewElementStates =
Public Enum DataGridViewElementStates
- Inheritance
- Attributes
Fields
Name | Value | Description |
---|---|---|
None | 0 | Indicates that an element is in its default state. |
Displayed | 1 | Indicates the an element is currently displayed onscreen. |
Frozen | 2 | Indicates that an element cannot be scrolled through the UI. |
ReadOnly | 4 | Indicates that an element will not accept user input to change its value. |
Resizable | 8 | Indicates that an element can be resized through the UI. This value is ignored except when combined with the ResizableSet value. |
ResizableSet | 16 | Indicates that an element does not inherit the resizable state of its parent. |
Selected | 32 | Indicates that an element is in a selected (highlighted) UI state. |
Visible | 64 | Indicates that an element is visible (displayable). |
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");
}
Private Sub dataGridView1_CellStateChanged(ByVal sender As Object, _
ByVal e As DataGridViewCellStateChangedEventArgs) _
Handles dataGridView1.CellStateChanged
Dim state As DataGridViewElementStates = e.StateChanged
Dim msg As String = String.Format( _
"Row {0}, Column {1}, {2}", _
e.Cell.RowIndex, e.Cell.ColumnIndex, e.StateChanged)
MessageBox.Show(msg, "Cell State Changed")
End Sub
Remarks
Although these different states, like Frozen, are enforced by the UI, they can be programmatically overruled.