DataGridView.BeginEdit(Boolean) 方法

  • 參考

定義

命名空間:
System.Windows.Forms
組件:
System.Windows.Forms.dll

將目前儲存格置於編輯模式下。

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 回 。 如果儲存格 EditType 屬性 null (，則也會傳回 false ，這表示儲存格無法裝載編輯控制項) ，而且儲存格類型不會實作 IDataGridViewEditingCell 介面。

如果儲存格支援編輯，這個方法會 CellBeginEdit 引發事件，可以取消此事件，如果事件處理常式取消編輯，則會傳回 false 。 如果未取消編輯，而且儲存格可以裝載編輯控制項，這個方法會初始化控制項並顯示它。 如果初始化失敗，這個方法會傳 false 回 。

如果儲存格成功進入編輯模式，屬性會 IsCurrentCellInEditMode 傳 true 回 。

適用於

另請參閱