DataGridViewCell.InitializeEditingControl メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

セルの編集に使用されるコントロールを初期化します。

public:
 virtual void InitializeEditingControl(int rowIndex, System::Object ^ initialFormattedValue, System::Windows::Forms::DataGridViewCellStyle ^ dataGridViewCellStyle);

public virtual void InitializeEditingControl (int rowIndex, object initialFormattedValue, System.Windows.Forms.DataGridViewCellStyle dataGridViewCellStyle);

abstract member InitializeEditingControl : int * obj * System.Windows.Forms.DataGridViewCellStyle -> unit
override this.InitializeEditingControl : int * obj * System.Windows.Forms.DataGridViewCellStyle -> unit

Public Overridable Sub InitializeEditingControl (rowIndex As Integer, initialFormattedValue As Object, dataGridViewCellStyle As DataGridViewCellStyle)

パラメーター

rowIndex

Int32

セルの位置の 0 から始まる行インデックス番号。

initialFormattedValue

Object

編集の開始時にセルに表示される値を表す Object。

dataGridViewCellStyle

DataGridViewCellStyle

セルのスタイルを表す DataGridViewCellStyle。

例外

InvalidOperationException

関連付けられた DataGridView がありません。存在する場合は、関連付けられた編集コントロールがありません。

例

次のコード例では、 クラスから派生する InitializeEditingControl 単純なクラスの メソッドをオーバーライドする方法を DataGridViewTextBoxCell 示します。 この例は、「How to: Host Controls in Windows フォーム DataGridView Cells」で提供されるより大きなコード例の一部です。

public class CalendarCell : DataGridViewTextBoxCell
{

    public CalendarCell()
        : base()
    {
        // Use the short date format.
        this.Style.Format = "d";
    }

    public override void InitializeEditingControl(int rowIndex, object 
        initialFormattedValue, DataGridViewCellStyle dataGridViewCellStyle)
    {
        // Set the value of the editing control to the current cell value.
        base.InitializeEditingControl(rowIndex, initialFormattedValue, 
            dataGridViewCellStyle);
        CalendarEditingControl ctl = 
            DataGridView.EditingControl as CalendarEditingControl;
        // Use the default row value when Value property is null.
        if (this.Value == null)
        {
            ctl.Value = (DateTime)this.DefaultNewRowValue;
        }
        else
        {
            ctl.Value = (DateTime)this.Value;
        }
    }

    public override Type EditType
    {
        get
        {
            // Return the type of the editing control that CalendarCell uses.
            return typeof(CalendarEditingControl);
        }
    }

    public override Type ValueType
    {
        get
        {
            // Return the type of the value that CalendarCell contains.
            
            return typeof(DateTime);
        }
    }

    public override object DefaultNewRowValue
    {
        get
        {
            // Use the current date and time as the default value.
            return DateTime.Now;
        }
    }
}

Public Class CalendarCell
    Inherits DataGridViewTextBoxCell

    Public Sub New()
        ' Use the short date format.
        Me.Style.Format = "d"
    End Sub

    Public Overrides Sub InitializeEditingControl(ByVal rowIndex As Integer, _
        ByVal initialFormattedValue As Object, _
        ByVal dataGridViewCellStyle As DataGridViewCellStyle)

        ' Set the value of the editing control to the current cell value.
        MyBase.InitializeEditingControl(rowIndex, initialFormattedValue, _
            dataGridViewCellStyle)

        Dim ctl As CalendarEditingControl = _
            CType(DataGridView.EditingControl, CalendarEditingControl)

        ' Use the default row value when Value property is null.
        If (Me.Value Is Nothing) Then
            ctl.Value = CType(Me.DefaultNewRowValue, DateTime)
        Else
            ctl.Value = CType(Me.Value, DateTime)
        End If
    End Sub

    Public Overrides ReadOnly Property EditType() As Type
        Get
            ' Return the type of the editing control that CalendarCell uses.
            Return GetType(CalendarEditingControl)
        End Get
    End Property

    Public Overrides ReadOnly Property ValueType() As Type
        Get
            ' Return the type of the value that CalendarCell contains.
            Return GetType(DateTime)
        End Get
    End Property

    Public Overrides ReadOnly Property DefaultNewRowValue() As Object
        Get
            ' Use the current date and time as the default value.
            Return DateTime.Now
        End Get
    End Property

End Class

注釈

最適化手法として、通常、同じ型と同じ DataGridView 内のすべてのセルが、ホストされている単一の編集コントロールを共有します。 ただし、コントロールをセルで使用する前に、 メソッドで InitializeEditingControl 初期化する必要があります。 このメソッドは、初めて呼び出されるときに、親 DataGridViewの編集コントロールの一覧にコントロールを追加します。 また、セルのビジュアル プロパティの一部も初期化されます。 たとえば、 InitializeEditingControl 指定したセル スタイル パラメーターと一致するように編集領域の背景色を設定します。 後続の 呼び出しでは InitializeEditingControl 何も実行されません。

派生クラスは、このメソッドを使用して、その型に対応する クラスの Control インスタンスをホストします。 たとえば、1 つ以上DataGridViewTextBoxCellの オブジェクトを含むテーブルでは、このメソッドを呼び出して、所有する DataGridViewに単一TextBoxの編集コントロールを追加します。

こちらもご覧ください

• DataGridView
• DetachEditingControl()