DataGridView.ColumnHeaderMouseClick イベント

.NET Framework クラス ライブラリ リファレンス

DataGridView.ColumnHeaderMouseClick イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーが列ヘッダーをクリックしたときに発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event ColumnHeaderMouseClick As
 DataGridViewCellMouseEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewCellMouseEventHandler

AddHandler instance.ColumnHeaderMouseClick, handler

C#

public event DataGridViewCellMouseEventHandler ColumnHeaderMouseClick

C++

public:
event DataGridViewCellMouseEventHandler^ ColumnHeaderMouseClick {
    void add (DataGridViewCellMouseEventHandler^ value);
    void remove (DataGridViewCellMouseEventHandler^ value);
}

J#

/** @event */
public void add_ColumnHeaderMouseClick (DataGridViewCellMouseEventHandler
 value)

/** @event */
public void remove_ColumnHeaderMouseClick (DataGridViewCellMouseEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

異なる動作が設定されている場合に DataGridViewColumnHeaderCell をクリックしたときの既定の動作をエミュレートする、プログラムによる並べ替えを実行するためのこのイベント使用方法を次のコード例に示します。この例では、SelectionMode が ColumnHeaderSelect に設定されているため、DataGridViewColumnHeaderCell をクリックすると、列の内容が選択されます。この例を実行するには、dataGridView1 という名前の DataGridView が配置されているフォームにコードを貼り付け、すべてのイベントを確実にイベント ハンドラに関連付けます。

Visual Basic

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 Not oldColumn Is
 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

C#

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;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)