Поделиться через

DataGridView.BeginEdit(Boolean) Метод

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll
Исходный код:
DataGridView.Methods.cs
Исходный код:
DataGridView.Methods.cs
Исходный код:
DataGridView.Methods.cs
Исходный код:
DataGridView.Methods.cs
Исходный код:
DataGridView.Methods.cs

Помещает текущую ячейку в режим редактирования.

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

Параметры

selectAll
Boolean

true чтобы выбрать все содержимое ячейки; false , чтобы не выбрать содержимое.

Возвращаемое значение

Boolean

true Значение , если текущая ячейка уже находится в режиме редактирования или успешно входит в режим редактирования; falseв противном случае .

Исключения

InvalidOperationException

CurrentCell не задано допустимое значение ячейки.

–или–

Этот метод был вызван в обработчике CellBeginEdit события.

InvalidCastException

Тип, указанный свойством ячейки EditType , не является производным от Control типа.

–или–

Тип, указанный свойством ячейки EditType , не реализует IDataGridViewEditingControl интерфейс.

Exception

Сбой инициализации значения ячейки редактирования, и обработчик не имеет обработчика для DataError события, либо обработчик задал свойству ThrowException значение true. Объект исключения обычно может быть приведение к типу FormatException.

Примеры

В следующем примере кода демонстрируется использование этого метода.

// 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

Комментарии

Этот метод возвращается false , если ячейка не вступает в режим редактирования, что может произойти по ряду причин. Этот метод возвращает, false если текущая ячейка доступна только для чтения. Он также возвращает значениеfalse, если свойство null ячейки EditType (то есть ячейка не может размещать элемент управления редактированием), а тип ячейки не реализует IDataGridViewEditingCell интерфейс.

Если ячейка поддерживает редактирование, этот метод вызывает CellBeginEdit событие, которое может быть отменено, и возвращается false , если обработчик событий отменяет изменение. Если изменение не отменено, и ячейка может разместить элемент управления редактирования, этот метод инициализирует элемент управления и отображает его. Если инициализация завершается ошибкой, этот метод возвращается false.

Если ячейка успешно входит в режим редактирования, IsCurrentCellInEditMode свойство возвращается true.

Применяется к

См. также раздел