Selection Modes in the Windows Forms DataGridView Control
Às vezes você deseja que seu aplicativo para executar ações com base nas seleções do usuário dentro de um DataGridView de controle. Dependendo das ações, você poderá restringir os tipos de seleção que são possíveis. Por exemplo, suponha que seu aplicativo pode imprimir um relatório para o registro selecionado atualmente. Nesse caso, você pode desejar configurar o DataGridView controle para que clicar em qualquer lugar dentro de uma linha sempre seleciona a linha inteira, e então que somente uma linha por vez pode ser selecionada.
Você pode especificar as seleções permitidas, definindo a DataGridView.SelectionMode propriedade para um dos seguintes DataGridViewSelectionMode valores de enumeração.
Valor de DataGridViewSelectionMode |
Descrição |
|---|---|
Clicando em uma célula, você seleciona-lo. Os cabeçalhos de linha e coluna não podem ser usados para seleção. |
|
Clicando em uma célula, você seleciona-lo. Clicar em um cabeçalho de coluna seleciona a coluna inteira. Os cabeçalhos de coluna não podem ser usados para classificação. |
|
Clicar em uma célula ou um cabeçalho de coluna seleciona a coluna inteira. Os cabeçalhos de coluna não podem ser usados para classificação. |
|
Clicar em uma célula ou um cabeçalho de linha seleciona a linha inteira. |
|
Modo de seleção padrão. Clicando em uma célula, você seleciona-lo. Clicar em um cabeçalho de linha seleciona a linha inteira. |
.gif "Observação") Observação |
|---|
Alterando o modo de seleção em tempo de execução automaticamente limpa a seleção atual. |
Por padrão, os usuários podem selecionar várias linhas, colunas ou células arrastando-se com o mouse, pressionando CTRL ou SHIFT enquanto a seleção para estender ou modificar uma seleção ou clicando na célula superior esquerda cabeçalho para selecionar todas as células no controle. Para impedir esse comportamento, defina a MultiSelect propriedade para false.
O FullRowSelect e RowHeaderSelect modos permitem que os usuários excluam linhas selecionando-os e pressionando a tecla DELETE. Os usuários podem excluir linhas somente quando a célula atual não está no modo de edição, o AllowUserToDeleteRows for definida como true, e a fonte de dados subjacente oferece suporte a exclusão de linha orientado pelo usuário. Observe que essas configurações não impedir a exclusão de linha através de programação.
Seleção de programação
O modo de seleção atual restringe o comportamento de seleção através de programação, bem como a seleção do usuário. Você pode alterar a seleção atual programaticamente, definindo a Selected a propriedade de quaisquer células, linhas ou colunas presentes na DataGridView de controle. Você também pode selecionar todas as células no controle por meio de SelectAll método, dependendo do modo de seleção. Para limpar a seleção, use o ClearSelection método.
Se o MultiSelect propriedade estiver definida como true, você pode adicionar DataGridView elementos ou removê-los da seleção, alterando a Selected a propriedade do elemento. Caso contrário, definindo a Selected propriedade para true para um elemento remove automaticamente outros elementos da seleção.
Observe que a alteração do valor de CurrentCell propriedade não altera a seleção atual.
Você pode recuperar uma coleção das células selecionadas no momento, linhas ou colunas por meio de SelectedCells, SelectedRows, e SelectedColumns Propriedades da DataGridView de controle. Acessar essas propriedades é ineficiente quando cada célula no controle é selecionada. Para evitar uma penalidade de desempenho nesse caso, use o AreAllCellsSelected método primeiro. Além disso, acessando a essas coleções para determinar o número de células selecionadas, linhas ou colunas podem ser ineficientes. Em vez disso, você deve usar o GetCellCount, GetRowCount, ou GetColumnCount método, passando a Selected valor.
Dica
Código de exemplo que demonstra o uso programático das células selecionadas pode ser encontrado no DataGridView Visão geral de classe.
Consulte também
Tarefas
Como: Definir o modo de seleção do controle do Windows Forms DataGridView
Referência
Outros recursos
Seleção e uso de área de transferência com o controle DataGridView do Windows Forms