DataGridViewCell.InitializeEditingControl-Methode

public virtual void InitializeEditingControl (
	int rowIndex,
	Object initialFormattedValue,
	DataGridViewCellStyle dataGridViewCellStyle
)

public void InitializeEditingControl (
	int rowIndex, 
	Object initialFormattedValue, 
	DataGridViewCellStyle dataGridViewCellStyle
)

public function InitializeEditingControl (
	rowIndex : int, 
	initialFormattedValue : Object, 
	dataGridViewCellStyle : DataGridViewCellStyle
)

Nicht zutreffend.

Parameter

rowIndex

Der nullbasierte Zeilenindex der Position der Zelle.

initialFormattedValue

Ein Object, das den Wert darstellt, der von der Zelle angezeigt wird, wenn mit der Bearbeitung begonnen wird.

dataGridViewCellStyle

Ein DataGridViewCellStyle, der den Stil der Zelle darstellt.

Als Optimierungsverfahren verwenden alle Zellen desselben Typs und in derselben DataGridView i. d. R. ein einziges gehostetes Bearbeitungssteuerelement gemeinsam. Bevor das Steuerelement von einer Zelle verwendet wird, muss es jedoch durch die InitializeEditingControl-Methode initialisiert werden. Wenn die Methode erstmalig aufgerufen wird, fügt sie das Steuerelement der Liste von Bearbeitungssteuerelementen in der übergeordneten DataGridView hinzu. Sie initialisiert zudem einige visuelle Eigenschaften der Zelle. Beispielsweise legt InitializeEditingControl die Hintergrundfarbe des Bearbeitungsbereichs fest, sodass sie dem angegebenen Zellstilparameter entspricht. Nachfolgende Aufrufe von InitializeEditingControl sind wirkungslos.

Abgeleitete Klassen verwenden diese Methode zum Hosten einer Instanz der Control-Klasse, die ihrem Typ entspricht. Beispielsweise ruft eine Tabelle, die mindestens ein DataGridViewTextBoxCell-Objekt enthält, diese Methode auf, um der besitzenden DataGridView ein einzelnes TextBox-Bearbeitungssteuerelement hinzuzufügen.

Im folgenden Codebeispiel wird das Überschreiben der InitializeEditingControl-Methode in einer einfachen Klasse veranschaulicht, die von der DataGridViewTextBoxCell-Klasse abgeleitet ist. Dieses Beispiel ist Teil eines umfangreicheren Codebeispiels für Gewusst wie: Hosten von Steuerelementen in DataGridView-Zellen in Windows Forms.

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;
        ctl.Value = (DateTime)this.Value;
    }

    public override Type EditType
    {
        get
        {
            // Return the type of the editing contol 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;
        }
    }
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework