DataGridView.BeginEdit(Boolean) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Coloca a célula atual em modo de edição.
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 BooleanParâmetros
- selectAll
- Boolean
true selecionar todo o conteúdo da célula; false para não selecionar nenhum conteúdo.
Devoluções
true se a célula atual já estiver em modo de edição ou entrar com sucesso no modo de edição; caso contrário, false.
Exceções
CurrentCell não está definido para uma célula válida.
-ou-
Este método era chamado por um handler para o CellBeginEdit evento.
O tipo indicado pela propriedade da EditType célula não deriva do Control tipo.
-ou-
O tipo indicado pela propriedade da EditType célula não implementa a IDataGridViewEditingControl interface.
A inicialização do valor da célula de edição falhou e ou não existe um handler para o DataError evento ou o handler definiu a ThrowException propriedade para true. O objeto exceção pode tipicamente ser lançado para o tipo FormatException.
Exemplos
O seguinte exemplo de código demonstra a utilização deste método.
// 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
Observações
Este método retorna false se a célula não entrar em modo de edição, o que pode acontecer por várias razões. Este método retorna false se a célula atual for apenas de leitura. Também devolve false se a propriedade da célula EditType for null (ou seja, a célula não pode hospedar um controlo de edição) e o tipo de célula não implementar a IDataGridViewEditingCell interface.
Se a célula suportar edição, este método levanta o CellBeginEdit evento, que pode ser cancelado, e retorna false se um gestor de eventos cancelar a edição. Se a edição não for cancelada e a célula puder alojar um controlo de edição, este método inicializa o controlo e o apresenta. Se a inicialização falhar, este método devolve false.
Se a célula entrar com sucesso no modo de edição, a IsCurrentCellInEditMode propriedade devolve true.
