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

单元格所在位置的从零开始的行索引。

initialFormattedValue

Object

Object，它表示在开始编辑时单元格显示的值。

dataGridViewCellStyle

DataGridViewCellStyle

一个 DataGridViewCellStyle，它表示单元格样式。

例外

InvalidOperationException

不存在关联的 DataGridView；如果它存在，则它不具有任何关联的编辑控件。

示例

下面的代码示例演示如何在派生自 DataGridViewTextBoxCell 类的简单类中重写 InitializeEditingControl 方法。 此示例是 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 实例。 例如，包含一个或多个 DataGridViewTextBoxCell 对象的表调用此方法，以将单个 TextBox 编辑控件添加到拥有 DataGridView的 。

另请参阅

• DataGridView
• DetachEditingControl()