DataGridView.SetCurrentCellAddressCore Método

Definição

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

Boolean

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.

Aplica-se a

Confira também