DataGridViewCell.InitializeEditingControl Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridViewCell.cs

Inizializza il controllo usato per la modifica della cella.

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)

Parametri

rowIndex

Int32

Indice in base zero della riga della posizione della cella.

initialFormattedValue

Object

Classe Object che rappresenta il valore visualizzato dalla cella all'inizio della modifica.

dataGridViewCellStyle

DataGridViewCellStyle

Oggetto DataGridViewCellStyle che rappresenta lo stile della cella.

Eccezioni

InvalidOperationException

Nessuna classe DataGridView è associata o se presente, non dispone di un controllo di modifica associato.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'override del InitializeEditingControl metodo in una classe semplice che deriva dalla DataGridViewTextBoxCell classe . Questo esempio fa parte di un esempio di codice più ampio fornito in Procedura: Ospitare controlli in Windows Forms celle DataGridView.

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

Commenti

Come tecnica di ottimizzazione, in genere tutte le celle dello stesso tipo e nella stessa DataGridView condivisione di un singolo controllo di modifica ospitato. Tuttavia, prima che il controllo venga utilizzato da una cella, deve essere inizializzato dal InitializeEditingControl metodo . La prima volta che viene chiamata, questo metodo aggiunge il controllo all'elenco di controlli di modifica nel relativo elemento padre DataGridView. Inizializza anche alcune delle proprietà visive della cella. Ad esempio, InitializeEditingControl imposta il colore di sfondo dell'area di modifica in modo che corrisponda al parametro dello stile di cella fornito. Le chiamate successive non eseguono InitializeEditingControl alcuna operazione.

Le classi derivate usano questo metodo per ospitare un'istanza della Control classe corrispondente al relativo tipo. Ad esempio, una tabella che contiene uno o più DataGridViewTextBoxCell oggetti chiama questo metodo per aggiungere un singolo TextBox controllo di modifica al proprietario DataGridViewdi .

Vedi anche

• DataGridView
• DetachEditingControl()