DataGridView.BeginEdit(Boolean) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de huidige cel in de bewerkingsmodus geplaatst.
public:
virtual bool BeginEdit(bool selectAll);public virtual bool BeginEdit(bool selectAll);abstract member BeginEdit : bool -> bool
override this.BeginEdit : bool -> boolPublic Overridable Function BeginEdit (selectAll As Boolean) As BooleanParameters
- selectAll
- Boolean
true om alle inhoud van de cel te selecteren; false om geen inhoud te selecteren.
Retouren
true als de huidige cel zich al in de bewerkingsmodus bevindt of als de bewerkingsmodus is geactiveerd; anders, false.
Uitzonderingen
CurrentCell is niet ingesteld op een geldige cel.
– of –
Deze methode is aangeroepen in een handler voor de CellBeginEdit gebeurtenis.
Het type dat wordt aangegeven door de eigenschap van EditType de cel, is niet afgeleid van het Control type.
– of –
Het type dat wordt aangegeven door de eigenschap van EditType de cel implementeert de IDataGridViewEditingControl interface niet.
Initialisatie van de waarde van de bewerkingscel is mislukt en er is geen handler voor de DataError gebeurtenis of de handler heeft de ThrowException eigenschap ingesteld op true. Het uitzonderingsobject kan doorgaans worden gecast naar type FormatException.
Voorbeelden
In het volgende codevoorbeeld ziet u het gebruik van deze methode.
// 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
Opmerkingen
Deze methode retourneert als de cel de bewerkingsmodus false niet kan inschakelen. Dit kan een aantal oorzaken hebben. Deze methode retourneert false als de huidige cel het kenmerk Alleen-lezen heeft. Het retourneert ook als de celeigenschap false (EditTypewat betekent dat de cel geen besturingselement voor bewerken kan hostennull) en het celtype de IDataGridViewEditingCell interface niet implementeert.
Als de cel bewerking ondersteunt, genereert deze methode de CellBeginEdit gebeurtenis, die kan worden geannuleerd en wordt geretourneerd false als een gebeurtenis-handler de bewerking annuleert. Als de bewerking niet is geannuleerd en de cel een besturingselement voor bewerken kan hosten, initialiseert deze methode het besturingselement en wordt het weergegeven. Als de initialisatie mislukt, retourneert falsedeze methode.
Als de cel de bewerkingsmodus heeft geactiveerd, wordt de IsCurrentCellInEditMode eigenschap geretourneerd true.
