DataGridView.ColumnHeaderMouseClick Olay

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Kaynak:: DataGridView.cs

Kaynak:: DataGridView.cs

Kaynak:: DataGridView.cs

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Kullanıcı bir sütun üst bilgisine tıkladığında gerçekleşir.

public:
 event System::Windows::Forms::DataGridViewCellMouseEventHandler ^ ColumnHeaderMouseClick;

public event System.Windows.Forms.DataGridViewCellMouseEventHandler ColumnHeaderMouseClick;

public event System.Windows.Forms.DataGridViewCellMouseEventHandler? ColumnHeaderMouseClick;

member this.ColumnHeaderMouseClick : System.Windows.Forms.DataGridViewCellMouseEventHandler

Public Custom Event ColumnHeaderMouseClick As DataGridViewCellMouseEventHandler

Olay Türü

DataGridViewCellMouseEventHandler

Örnekler

içinde bir sütun başlığına tıklandığında DataGridView, varsayılan davranış kılavuz satırlarını tıklanan sütuna göre sıralamak veya kılavuz tıklanan sütuna göre zaten sıralanmışsa sıralama düzenini tersine çevirmektir. Aşağıdaki kod örneğinde, varsayılan davranış devre dışı bırakıldığında bir öğesine tıklamanın varsayılan davranışını öykünen programlı bir DataGridViewColumnHeaderCell sıralama gerçekleştirmek için bu olayın nasıl kullanılacağı gösterilmektedir. Bu örnekte , SelectionMode olarak ayarlanmıştır ColumnHeaderSelect, bu nedenle öğesine tıklandığında DataGridViewColumnHeaderCell sütunun içeriği seçilir. Örnek kodun amaçlandığı gibi çalışması için, veriler içine her yüklendiğinde varsayılan sütun başlığı tıklama davranışının DataGridViewdeğiştirilmesi gerekir. Varsayılan davranışı değiştiren kodu sağlamak için bir DataBindingComplete olay işleyicisi ekleyin. Bu örneği çalıştırmak için, kodu adlandırılmış dataGridView1 bir forma DataGridView yapıştırın ve tüm olayların olay işleyicileriyle ilişkilendirildiğinden emin olun.

private void dataGridView1_ColumnHeaderMouseClick(
    object sender, DataGridViewCellMouseEventArgs e)
{
    DataGridViewColumn newColumn = dataGridView1.Columns[e.ColumnIndex];
    DataGridViewColumn oldColumn = dataGridView1.SortedColumn;
    ListSortDirection direction;

    // If oldColumn is null, then the DataGridView is not sorted.
    if (oldColumn != null)
    {
        // Sort the same column again, reversing the SortOrder.
        if (oldColumn == newColumn &&
            dataGridView1.SortOrder == SortOrder.Ascending)
        {
            direction = ListSortDirection.Descending;
        }
        else
        {
            // Sort a new column and remove the old SortGlyph.
            direction = ListSortDirection.Ascending;
            oldColumn.HeaderCell.SortGlyphDirection = SortOrder.None;
        }
    }
    else
    {
        direction = ListSortDirection.Ascending;
    }

    // Sort the selected column.
    dataGridView1.Sort(newColumn, direction);
    newColumn.HeaderCell.SortGlyphDirection =
        direction == ListSortDirection.Ascending ?
        SortOrder.Ascending : SortOrder.Descending;
}

private void dataGridView1_DataBindingComplete(object sender,
    DataGridViewBindingCompleteEventArgs e)
{
    // Put each of the columns into programmatic sort mode.
    foreach (DataGridViewColumn column in dataGridView1.Columns)
    {
        column.SortMode = DataGridViewColumnSortMode.Programmatic;
    }
}

Private Sub dataGridView1_ColumnHeaderMouseClick(ByVal sender As Object, _
    ByVal e As DataGridViewCellMouseEventArgs) _
    Handles dataGridView1.ColumnHeaderMouseClick

    Dim newColumn As DataGridViewColumn = _
        dataGridView1.Columns(e.ColumnIndex)
    Dim oldColumn As DataGridViewColumn = dataGridView1.SortedColumn
    Dim direction As ListSortDirection

    ' If oldColumn is null, then the DataGridView is not currently sorted.
    If oldColumn IsNot Nothing Then

        ' Sort the same column again, reversing the SortOrder.
        If oldColumn Is newColumn AndAlso dataGridView1.SortOrder = _
            SortOrder.Ascending Then
            direction = ListSortDirection.Descending
        Else

            ' Sort a new column and remove the old SortGlyph.
            direction = ListSortDirection.Ascending
            oldColumn.HeaderCell.SortGlyphDirection = SortOrder.None
        End If
    Else
        direction = ListSortDirection.Ascending
    End If

    ' Sort the selected column.
    dataGridView1.Sort(newColumn, direction)
    If direction = ListSortDirection.Ascending Then
        newColumn.HeaderCell.SortGlyphDirection = SortOrder.Ascending
    Else
        newColumn.HeaderCell.SortGlyphDirection = SortOrder.Descending
    End If

End Sub

Private Sub dataGridView1_DataBindingComplete(ByVal sender As Object, _
    ByVal e As DataGridViewBindingCompleteEventArgs) _
    Handles dataGridView1.DataBindingComplete

    ' Put each of the columns into programmatic sort mode.
    For Each column As DataGridViewColumn In dataGridView1.Columns
        column.SortMode = DataGridViewColumnSortMode.Programmatic
    Next
End Sub

Açıklamalar

Olayları işleme hakkında daha fazla bilgi için bkz. Olayları İşleme ve Oluşturma.

Şunlara uygulanır

Ürün	Sürümler
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Ayrıca bkz.

DataGridView Denetimi (Windows Forms)

Aracılığıyla paylaş