DataGridView.BeginEdit(Boolean) DataGridView.BeginEdit(Boolean) DataGridView.BeginEdit(Boolean) DataGridView.BeginEdit(Boolean) Method

정의

현재 셀을 편집 모드로 전환합니다.Puts the current cell in edit mode.

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

모든 셀의 내용을 선택하려면 true이고, 아무 내용도 선택하지 않으려면 false입니다.true to select all the cell's contents; false to not select any contents.

반환

현재 셀이 이미 편집 모드에 있거나 성공적으로 편집 모드로 전환되었으면 true이고, 그렇지 않으면 false입니다.true if the current cell is already in edit mode or successfully enters edit mode; otherwise, false.

예외

CurrentCell이 유효한 셀로 설정되지 않았습니다.CurrentCell is not set to a valid cell.

또는-or- 이 메서드가 CellBeginEdit 이벤트의 처리기에서 호출되었습니다.This method was called in a handler for the CellBeginEdit event.

셀의 EditType 속성이 나타내는 형식이 Control 형식에서 파생되지 않습니다.The type indicated by the cell's EditType property does not derive from the Control type.

또는-or- 셀의 EditType 속성이 나타내는 형식이 IDataGridViewEditingControl 인터페이스를 구현하지 않습니다.The type indicated by the cell's EditType property does not implement the IDataGridViewEditingControl interface.

편집 셀 값을 초기화하지 못했으며 DataError 이벤트에 대한 처리기가 없거나 처리기의 ThrowException 속성이 true로 설정되어 있습니다.Initialization of the editing cell value failed and either there is no handler for the DataError event or the handler has set the ThrowException property to true. 예외 개체는 일반적으로 FormatException 형식으로 캐스팅할 수 있습니다.The exception object can typically be cast to type FormatException.

예제

다음 코드 예제에서는이 메서드를 사용 하는 방법을 보여 줍니다.The following code example demonstrates the use of this method.

// 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 셀 실패는 다양 한 이유로 발생할 수 있는 편집 모드로 전환 합니다.This method returns false if the cell fails to enter edit mode, which can happen for a number of reasons. 이 메서드가 반환 false 현재 셀이 읽기 전용입니다.This method returns false if the current cell is read-only. 반환 한다는 false 경우 셀 EditType 속성은 null (편집 컨트롤을 호스팅할 수 없습니다 셀 의미) 셀 유형을 구현 하지 않습니다는 IDataGridViewEditingCell 인터페이스입니다.It also returns false if the cell EditType property is null (meaning the cell cannot host an editing control) and the cell type does not implement the IDataGridViewEditingCell interface.

셀이 편집을 지 원하는 경우이 메서드는 CellBeginEdit 이벤트는 취소할 수 있으며 반환 false 이벤트 처리기가 편집을 취소 하는 경우.If the cell supports editing, this method raises the CellBeginEdit event, which can be canceled, and returns false if an event handler cancels the edit. 편집 취소 되지 않은 셀 편집 컨트롤을 호스트할 수 있습니다 하 고이 메서드는 컨트롤을 초기화 표시 합니다.If the edit is not canceled and the cell can host an editing control, this method initializes the control and displays it. 이 메서드가 반환 하는 경우 초기화가 실패 하면, false합니다.If the initialization fails, this method returns false.

셀에는 성공적으로 편집 모드로 전환 하는 경우는 IsCurrentCellInEditMode 속성이 반환 true합니다.If the cell successfully enters edit mode, the IsCurrentCellInEditMode property returns true.

적용 대상

추가 정보