DataGridViewSortCompareEventArgs Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje data pro událost SortCompare.

public ref class DataGridViewSortCompareEventArgs : System::ComponentModel::HandledEventArgs

public class DataGridViewSortCompareEventArgs : System.ComponentModel.HandledEventArgs

type DataGridViewSortCompareEventArgs = class
    inherit HandledEventArgs

Public Class DataGridViewSortCompareEventArgs
Inherits HandledEventArgs

Dědičnost: Object

EventArgs

HandledEventArgs
DataGridViewSortCompareEventArgs

Příklady

Následující příklad kódu ukazuje použití SortCompare v řazení s více sloupci. Tento příklad je součástí většího příkladu v části Postupy: Přizpůsobení řazení v ovládacím prvku model Windows Forms DataGridView.

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

Poznámky

Událost můžete zpracovat a SortCompare zajistit tak vlastní řazení. K této události dojde pouze v DataGridView.DataSource případě, že vlastnost není nastavená a DataGridView.VirtualMode vlastnost je nastavená na falsehodnotu . Tato událost nastane jednou pro každou dvojici buněk ve sloupci, který je seřazen. K tomu dochází pouze v případě, že uživatel klikne na záhlaví sloupce s DataGridViewColumn.SortMode hodnotou Automaticvlastnosti , nebo když zavoláte DataGridView.Sort(DataGridViewColumn, ListSortDirection) přetížení. Když dojde k této události pro sloupec s DataGridViewColumn.SortMode hodnotou Programmaticvlastnosti , musíte si pomocí vlastnosti zobrazit vlastní piktogram DataGridViewColumnHeaderCell.SortGlyphDirection řazení.

Tuto událost můžete použít k řazení řádků pomocí hodnot buněk v jednom sloupci nebo ve více sloupcích. CellValue1 Pomocí vlastností a CellValue2 můžete porovnat hodnoty buněk ve sloupci zadaném Column ve vlastnosti . RowIndex1 Pomocí vlastností a RowIndex2 můžete přistupovat k hodnotám v jiných sloupcích prostřednictvím DataGridView.Rows kolekce.

Konstruktory

DataGridViewSortCompareEventArgs(DataGridViewColumn, Object, Object, Int32, Int32)

Inicializuje novou instanci DataGridViewSortCompareEventArgs třídy .

Vlastnosti

CellValue1	Získá hodnotu první buňky k porovnání.
CellValue2	Získá hodnotu druhé buňky k porovnání.
Column	Získá seřazený sloupec.
Handled	Získá nebo nastaví hodnotu, která označuje, zda obslužná rutina události zcela zpracovala událost nebo zda systém má pokračovat ve vlastním zpracování. (Zděděno od HandledEventArgs)
RowIndex1	Získá index řádku obsahujícího první buňku k porovnání.
RowIndex2	Získá index řádku obsahujícího druhou buňku k porovnání.
SortResult	Získá nebo nastaví hodnotu označující pořadí, ve kterém budou porovnávané buňky seřazeny.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Platí pro