Språk

DataGridView.BeginEdit(Boolean) Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
DataGridView.Methods.cs
Källa:
DataGridView.Methods.cs
Källa:
DataGridView.Methods.cs
Källa:
DataGridView.Methods.cs
Källa:
DataGridView.Methods.cs

Placerar den aktuella cellen i redigeringsläge.

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

Parametrar

selectAll
Boolean

true för att markera alla cellens innehåll; false om du inte vill välja något innehåll.

Returer

Boolean

trueom den aktuella cellen redan är i redigeringsläge eller om den har angetts i redigeringsläge. annars . false

Undantag

InvalidOperationException

CurrentCell är inte inställt på en giltig cell.

-eller-

Den här metoden anropades i en hanterare för CellBeginEdit händelsen.

InvalidCastException

Den typ som anges av cellens egenskap härleds EditType inte från Control typen.

-eller-

Den typ som anges av cellens EditType egenskap implementerar IDataGridViewEditingControl inte gränssnittet.

Exception

Initieringen av redigeringscellvärdet misslyckades och det finns antingen ingen hanterare för DataError händelsen eller så har hanteraren angett ThrowException egenskapen till true. Undantagsobjektet kan vanligtvis omvandlas till att skriva FormatException.

Exempel

I följande kodexempel visas användningen av den här metoden.

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

Kommentarer

Den här metoden returnerar false om cellen inte kan ange redigeringsläge, vilket kan inträffa av flera orsaker. Den här metoden returnerar false om den aktuella cellen är skrivskyddad. Den returnerar false också om cellegenskapen EditType är null (vilket innebär att cellen inte kan vara värd för en redigeringskontroll) och celltypen inte implementerar IDataGridViewEditingCell gränssnittet.

Om cellen stöder redigering genererar den CellBeginEdit här metoden händelsen, som kan avbrytas, och returnerar false om en händelsehanterare avbryter redigeringen. Om redigeringen inte avbryts och cellen kan vara värd för en redigeringskontroll initierar den här metoden kontrollen och visar den. Om initieringen misslyckas returnerar falseden här metoden .

Om cellen har angett redigeringsläge returnerar IsCurrentCellInEditModeegenskapen true .

Gäller för

Se även