Partager via

DataGridView.BeginEdit(Boolean) Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
DataGridView.Methods.cs
Source:
DataGridView.Methods.cs
Source:
DataGridView.Methods.cs
Source:
DataGridView.Methods.cs
Source:
DataGridView.Methods.cs

Place la cellule active en mode Édition.

public:
 virtual bool BeginEdit(bool selectAll);
public virtual bool BeginEdit(bool selectAll);
abstract member BeginEdit : bool -> bool
override this.BeginEdit : bool -> bool
Public Overridable Function BeginEdit (selectAll As Boolean) As Boolean

Paramètres

selectAll
Boolean

true pour sélectionner tout le contenu de la cellule ; false pour ne sélectionner aucun contenu.

Retours

Boolean

true si la cellule active est déjà en mode édition ou entre correctement en mode d’édition ; sinon, false.

Exceptions

InvalidOperationException

CurrentCell n’est pas défini sur une cellule valide.

- ou -

Cette méthode a été appelée dans un gestionnaire pour l’événement CellBeginEdit .

InvalidCastException

Le type indiqué par la propriété de EditType la cellule ne dérive pas du Control type.

- ou -

Le type indiqué par la propriété de EditType la cellule n’implémente pas l’interface IDataGridViewEditingControl .

Exception

L’initialisation de la valeur de cellule d’édition a échoué et il n’existe aucun gestionnaire pour l’événement DataError ou le gestionnaire a défini la ThrowException propriété truesur . L’objet d’exception peut généralement être converti en type FormatException.

Exemples

L’exemple de code suivant illustre l’utilisation de cette méthode.

// Override OnMouseClick in a class derived from DataGridViewCell to 
// enter edit mode when the user clicks the cell. 
protected override void OnMouseClick(DataGridViewCellMouseEventArgs e)
{
    if (base.DataGridView != null)
    {
        Point point1 = base.DataGridView.CurrentCellAddress;
        if (point1.X == e.ColumnIndex &&
            point1.Y == e.RowIndex &&
            e.Button == MouseButtons.Left &&
            base.DataGridView.EditMode !=
            DataGridViewEditMode.EditProgrammatically)
        {
            base.DataGridView.BeginEdit(true);
        }
    }
}

' Override OnMouseClick in a class derived from DataGridViewCell to 
' enter edit mode when the user clicks the cell. 
Protected Overrides Sub OnMouseClick( _
    ByVal e As DataGridViewCellMouseEventArgs)

    If MyBase.DataGridView IsNot Nothing Then

        Dim point1 As Point = MyBase.DataGridView.CurrentCellAddress
        If point1.X = e.ColumnIndex And _
            point1.Y = e.RowIndex And _
            e.Button = MouseButtons.Left And _
            Not MyBase.DataGridView.EditMode = _
            DataGridViewEditMode.EditProgrammatically Then

            MyBase.DataGridView.BeginEdit(True)

        End If
    End If
End Sub

Remarques

Cette méthode retourne false si la cellule ne parvient pas à entrer en mode d’édition, ce qui peut se produire pour plusieurs raisons. Cette méthode retourne false si la cellule active est en lecture seule. Elle retourne false également si la propriété de cellule EditType est null (ce qui signifie que la cellule ne peut pas héberger un contrôle d’édition) et que le type de cellule n’implémente pas l’interface IDataGridViewEditingCell .

Si la cellule prend en charge la modification, cette méthode déclenche l’événement CellBeginEdit , qui peut être annulé et retourne false si un gestionnaire d’événements annule la modification. Si la modification n’est pas annulée et que la cellule peut héberger un contrôle d’édition, cette méthode initialise le contrôle et l’affiche. Si l’initialisation échoue, cette méthode retourne false.

Si la cellule entre correctement en mode d’édition, la IsCurrentCellInEditMode propriété retourne true.

S’applique à

Voir aussi