DataGridViewSortCompareEventArgs Classe
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.
Fornece dados para o evento de SortCompare .
public ref class DataGridViewSortCompareEventArgs : System::ComponentModel::HandledEventArgs
public class DataGridViewSortCompareEventArgs : System.ComponentModel.HandledEventArgs
type DataGridViewSortCompareEventArgs = class
inherit HandledEventArgs
Public Class DataGridViewSortCompareEventArgs
Inherits HandledEventArgs
- Herança
Exemplos
O exemplo de código a seguir demonstra o uso de em uma classificação de SortCompare várias colunas. Este exemplo faz parte de um exemplo maior fornecido em How to: Customize Sorting in the Windows Forms DataGridView Control.
private void dataGridView1_SortCompare(object sender,
DataGridViewSortCompareEventArgs e)
{
// Try to sort based on the cells in the current column.
e.SortResult = System.String.Compare(
e.CellValue1.ToString(), e.CellValue2.ToString());
// If the cells are equal, sort based on the ID column.
if (e.SortResult == 0 && e.Column.Name != "ID")
{
e.SortResult = System.String.Compare(
dataGridView1.Rows[e.RowIndex1].Cells["ID"].Value.ToString(),
dataGridView1.Rows[e.RowIndex2].Cells["ID"].Value.ToString());
}
e.Handled = true;
}
Private Sub DataGridView1_SortCompare( _
ByVal sender As Object, ByVal e As DataGridViewSortCompareEventArgs) _
Handles DataGridView1.SortCompare
' Try to sort based on the contents of the cell in the current column.
e.SortResult = System.String.Compare(e.CellValue1.ToString(), _
e.CellValue2.ToString())
' If the cells are equal, sort based on the ID column.
If (e.SortResult = 0) AndAlso Not (e.Column.Name = "ID") Then
e.SortResult = System.String.Compare( _
DataGridView1.Rows(e.RowIndex1).Cells("ID").Value.ToString(), _
DataGridView1.Rows(e.RowIndex2).Cells("ID").Value.ToString())
End If
e.Handled = True
End Sub
Comentários
Você pode manipular o SortCompare evento para fornecer classificação personalizada. Esse evento ocorre somente quando a DataGridView.DataSource propriedade não está definida e a DataGridView.VirtualMode propriedade é definida false
como . Esse evento ocorre uma vez para cada par de células na coluna que está sendo classificada. Isso ocorre somente quando o usuário clica no cabeçalho de uma coluna com um DataGridViewColumn.SortMode valor de propriedade de Automaticou quando você chama a DataGridView.Sort(DataGridViewColumn, ListSortDirection) sobrecarga. Quando esse evento ocorre para uma coluna com um DataGridViewColumn.SortMode valor de propriedade de Programmatic, você deve exibir o glifo de classificação por conta própria por meio da DataGridViewColumnHeaderCell.SortGlyphDirection propriedade .
Você pode usar esse evento para classificar linhas usando os valores de célula em uma coluna ou em várias colunas. Use as CellValue1 propriedades e CellValue2 para comparar valores de célula na coluna especificada na Column propriedade . Use as RowIndex1 propriedades e RowIndex2 para acessar valores em outras colunas por meio da DataGridView.Rows coleção.
Construtores
DataGridViewSortCompareEventArgs(DataGridViewColumn, Object, Object, Int32, Int32) |
Inicializa uma nova instância da classe DataGridViewSortCompareEventArgs. |
Propriedades
CellValue1 |
Obtém o valor da primeira célula a ser comparada. |
CellValue2 |
Obtém o valor da segunda célula a ser comparada. |
Column |
Obtém a coluna que está sendo classificada. |
Handled |
Obtém ou define um valor que indica se o manipulador de eventos tratou completamente o evento ou se o sistema deve continuar seu próprio processamento. (Herdado de HandledEventArgs) |
RowIndex1 |
Obtém o índice da linha que contém a primeira célula a ser comparada. |
RowIndex2 |
Obtém o índice da linha que contém a segunda célula a ser comparada. |
SortResult |
Obtém ou define um valor que indica a ordem na qual as células comparadas serão classificadas. |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |