DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
コレクション内の指定したインデックス位置に列を挿入します。
public:
virtual void Insert(int columnIndex, System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);public virtual void Insert(int columnIndex, System.Windows.Forms.DataGridViewColumn dataGridViewColumn);abstract member Insert : int * System.Windows.Forms.DataGridViewColumn -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewColumn -> unitPublic Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)パラメーター
- columnIndex
- Int32
指定した列を挿入する位置の 0 から始まるインデックス。
- dataGridViewColumn
- DataGridViewColumn
挿入する DataGridViewColumn 。
例外
dataGridViewColumn は nullです。
関連付けられている DataGridView コントロールは、新しい列の追加を一時的に妨げる次のいずれかのアクションを実行しています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
プロパティ値 DisplayIndex 列を更新しています。
-又は-
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
-又は-
dataGridViewColumn は既に DataGridView コントロールに属しています。
-又は-
dataGridViewColumn
SortModeプロパティの値がAutomaticされ、SelectionModeプロパティの値がFullColumnSelectまたはColumnHeaderSelect。 コントロール ISupportInitialize.BeginInit() メソッドと ISupportInitialize.EndInit() メソッドを使用して、競合するプロパティ値を一時的に設定します。
-又は-
dataGridViewColumn
InheritedAutoSizeModeプロパティ値がColumnHeaderされ、ColumnHeadersVisibleプロパティ値がfalse。
-又は-
dataGridViewColumnには、InheritedAutoSizeModeのFillプロパティ値とFrozenのtrueプロパティ値があります。
-又は-
dataGridViewColumn には DisplayIndex プロパティ値と Frozen プロパティ値があり、プロパティ値が反対の隣接する一連の列の中に表示 Frozen 。
-又は-
DataGridView コントロールには少なくとも 1 つの行が含まれており、dataGridViewColumnにはCellTypeのnullプロパティ値があります。
例
次のコード例は、このメソッドの使用方法を示しています。 詳細については、「方法: Data-Bound Windows フォーム DataGridView コントロールにバインドされていない列を追加するを参照してください。
private void CreateUnboundButtonColumn()
{
// Initialize the button column.
DataGridViewButtonColumn buttonColumn =
new DataGridViewButtonColumn();
buttonColumn.Name = "Details";
buttonColumn.HeaderText = "Details";
buttonColumn.Text = "View Details";
// Use the Text property for the button text for all cells rather
// than using each cell's value as the text for its own button.
buttonColumn.UseColumnTextForButtonValue = true;
// Add the button column to the control.
dataGridView1.Columns.Insert(0, buttonColumn);
}
Private Sub CreateUnboundButtonColumn()
' Initialize the button column.
Dim buttonColumn As New DataGridViewButtonColumn
With buttonColumn
.HeaderText = "Details"
.Name = "Details"
.Text = "View Details"
' Use the Text property for the button text for all cells rather
' than using each cell's value as the text for its own button.
.UseColumnTextForButtonValue = True
End With
' Add the button column to the control.
dataGridView1.Columns.Insert(0, buttonColumn)
End Sub
