DataGridViewElementStates 列挙型


DataGridView コントロールに含まれる要素のユーザー インターフェイス (UI) の状態を指定します。Specifies the user interface (UI) state of a element within a DataGridView control.

この列挙型には FlagsAttribute 属性があり、メンバー値ではビットごとの組み合わせを使用できます。

public enum class DataGridViewElementStates
public enum DataGridViewElementStates
type DataGridViewElementStates = 
Public Enum DataGridViewElementStates


Displayed 1

要素が現在画面上に表示されていることを示します。Indicates the an element is currently displayed onscreen.

Frozen 2

要素を UI を通じてスクロールできないことを示します。Indicates that an element cannot be scrolled through the UI.

None 0

要素が既定の状態であることを示します。Indicates that an element is in its default state.

ReadOnly 4

要素が値を変更するためのユーザー入力を受け付けないことを示します。Indicates that an element will not accept user input to change its value.

Resizable 8

要素が UI を通じてサイズ変更できることを示します。Indicates that an element can be resized through the UI. この値は、ResizableSet 値と組み合わせて使用される場合以外は無視されます。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

要素の UI が選択された (強調表示された) 状態であることを示します。Indicates that an element is in a selected (highlighted) UI state.

Visible 64

要素が表示されている (表示できる) ことを示します。Indicates that an element is visible (displayable).

この型の使用方法を次のコード例に示します。The following code example illustrates the use of this type. 詳細については、「方法: Windows フォーム DataGridView コントロールのセルの変更に基づいてカスタム動作を実行する」を参照してください。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


これらのさまざまな状態 (凍結など) は UI によって適用されますが、プログラムによって却下できます。Although these different states, like Frozen, are enforced by the UI, they can be programmatically overruled.