DataGridView.SetCurrentCellAddressCore Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define a célula ativa no momento.
protected:
virtual bool SetCurrentCellAddressCore(int columnIndex, int rowIndex, bool setAnchorCellAddress, bool validateCurrentCell, bool throughMouseClick);
protected virtual bool SetCurrentCellAddressCore (int columnIndex, int rowIndex, bool setAnchorCellAddress, bool validateCurrentCell, bool throughMouseClick);
abstract member SetCurrentCellAddressCore : int * int * bool * bool * bool -> bool
override this.SetCurrentCellAddressCore : int * int * bool * bool * bool -> bool
Protected Overridable Function SetCurrentCellAddressCore (columnIndex As Integer, rowIndex As Integer, setAnchorCellAddress As Boolean, validateCurrentCell As Boolean, throughMouseClick As Boolean) As Boolean
Parâmetros
- columnIndex
- Int32
O índice da coluna que contém a célula.
- rowIndex
- Int32
O índice da linha que contém a célula.
- setAnchorCellAddress
- Boolean
true
para tornar a nova célula atual a célula de âncora de uma seleção multicelular seguinte usando a tecla SHIFT; caso contrário, false
.
- validateCurrentCell
- Boolean
true
para validar o valor na célula atual antiga e cancelar a alteração se a validação falhar; caso contrário, false
.
- throughMouseClick
- Boolean
true
se a célula atual estiver sendo definida como resultado de um clique do mouse; caso contrário, false
.
Retornos
true
se a célula atual foi definida com êxito; caso contrário, false
.
Exceções
columnIndex
é menor que 0 ou maior que o número de colunas no controle menos 1 e rowIndex
não é -1.
- ou -
rowIndex
é menor que 0 ou maior que o número de linhas no controle menos 1 e columnIndex
não é -1.
A célula especificada tem um valor da propriedade Visible de false
.
- ou - Esse método foi chamado por um motivo diferente da redefinição da fonte de dados subjacente e outro thread está executando esse método no momento.
A nova célula atual tentou entrar no modo de edição, mas a propriedade EditType não indica uma classe que deriva de Control e implementa IDataGridViewEditingControl.
Comentários
O DataGridView controle usa esse método sempre que altera a célula atual. Esse método altera a célula atual sem alterar a seleção e, opcionalmente, sem validar a célula anterior ou alterar a célula de âncora de seleção. A célula âncora é a primeira célula de um bloco de várias células que o usuário pode selecionar segurando a tecla SHIFT e clicando na última célula do bloco.
Se rowIndex
e columnIndex
ambos forem -1, a CurrentCell propriedade retornará null
.