DataGridViewColumnCollection.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した列をコレクションに追加します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Add(DataGridViewColumn) |
指定した列をコレクションに追加します。 |
| Add(String, String) |
指定した列名と列ヘッダー テキストを持つ DataGridViewTextBoxColumn をコレクションに追加します。 |
Add(DataGridViewColumn)
指定した列をコレクションに追加します。
public:
virtual int Add(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);public virtual int Add(System.Windows.Forms.DataGridViewColumn dataGridViewColumn);abstract member Add : System.Windows.Forms.DataGridViewColumn -> int
override this.Add : System.Windows.Forms.DataGridViewColumn -> intPublic Overridable Function Add (dataGridViewColumn As DataGridViewColumn) As Integerパラメーター
- 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 には、 FillWeight プロパティ値があります。これにより、コントロール内のすべての列の結合 FillWeight 値が 65535 を超えます。
-又は-
dataGridViewColumn には DisplayIndex プロパティ値と Frozen プロパティ値があり、プロパティ値が反対の隣接する一連の列の中に表示 Frozen 。
-又は-
DataGridView コントロールには少なくとも 1 つの行が含まれており、dataGridViewColumnにはCellTypeのnullプロパティ値があります。
例
次のコード例は、このメソッドの使用方法を示しています。
private DataGridView dataGridView1 = new DataGridView();
private void AddColorColumn()
{
DataGridViewComboBoxColumn comboBoxColumn =
new DataGridViewComboBoxColumn();
comboBoxColumn.Items.AddRange(
Color.Red, Color.Yellow, Color.Green, Color.Blue);
comboBoxColumn.ValueType = typeof(Color);
dataGridView1.Columns.Add(comboBoxColumn);
dataGridView1.EditingControlShowing +=
new DataGridViewEditingControlShowingEventHandler(
dataGridView1_EditingControlShowing);
}
private void dataGridView1_EditingControlShowing(object sender,
DataGridViewEditingControlShowingEventArgs e)
{
ComboBox combo = e.Control as ComboBox;
if (combo != null)
{
// Remove an existing event-handler, if present, to avoid
// adding multiple handlers when the editing control is reused.
combo.SelectedIndexChanged -=
new EventHandler(ComboBox_SelectedIndexChanged);
// Add the event handler.
combo.SelectedIndexChanged +=
new EventHandler(ComboBox_SelectedIndexChanged);
}
}
private void ComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem;
}
Private WithEvents dataGridView1 As New DataGridView()
Private Sub AddColorColumn()
Dim comboBoxColumn As New DataGridViewComboBoxColumn()
comboBoxColumn.Items.AddRange( _
Color.Red, Color.Yellow, Color.Green, Color.Blue)
comboBoxColumn.ValueType = GetType(Color)
dataGridView1.Columns.Add(comboBoxColumn)
End Sub
Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
ByVal e As DataGridViewEditingControlShowingEventArgs) _
Handles dataGridView1.EditingControlShowing
Dim combo As ComboBox = CType(e.Control, ComboBox)
If (combo IsNot Nothing) Then
' Remove an existing event-handler, if present, to avoid
' adding multiple handlers when the editing control is reused.
RemoveHandler combo.SelectedIndexChanged, _
New EventHandler(AddressOf ComboBox_SelectedIndexChanged)
' Add the event handler.
AddHandler combo.SelectedIndexChanged, _
New EventHandler(AddressOf ComboBox_SelectedIndexChanged)
End If
End Sub
Private Sub ComboBox_SelectedIndexChanged( _
ByVal sender As Object, ByVal e As EventArgs)
Dim comboBox1 As ComboBox = CType(sender, ComboBox)
comboBox1.BackColor = _
CType(CType(sender, ComboBox).SelectedItem, Color)
End Sub
こちらもご覧ください
適用対象
Add(String, String)
指定した列名と列ヘッダー テキストを持つ DataGridViewTextBoxColumn をコレクションに追加します。
public:
virtual int Add(System::String ^ columnName, System::String ^ headerText);public virtual int Add(string columnName, string headerText);public virtual int Add(string? columnName, string? headerText);abstract member Add : string * string -> int
override this.Add : string * string -> intPublic Overridable Function Add (columnName As String, headerText As String) As Integerパラメーター
- columnName
- String
列を参照する名前。
- headerText
- String
列のヘッダーのテキスト。
返品
列のインデックス。
例外
関連付けられている DataGridView コントロールは、新しい列の追加を一時的に妨げる次のいずれかのアクションを実行しています。
コントロール内のすべてのセルを選択します。
選択範囲をクリアします。
プロパティ値 DisplayIndex 列を更新しています。
-又は-
このメソッドは、次のいずれかの DataGridView イベントのハンドラーから呼び出されています。
-又は-
SelectionModeプロパティ値はFullColumnSelectまたはColumnHeaderSelectであり、既定の列SortModeプロパティ値Automaticと競合します。
-又は-
既定の列 FillWeight プロパティ値が 100 の場合、コントロール内のすべての列の合計 FillWeight 値が 65535 を超えます。
注釈
columnNameパラメーターとheaderText パラメーターは、それぞれNameプロパティとHeaderTextプロパティに関連しています。
