DataGridView.SelectedColumns プロパティ

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

DataGridView.SelectedColumns プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーが選択した列のコレクションを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 SelectedColumns As DataGridViewSelectedColumnCollection

Visual Basic (使用法)

Dim instance As DataGridView
Dim value As DataGridViewSelectedColumnCollection

value = instance.SelectedColumns

C#

public DataGridViewSelectedColumnCollection SelectedColumns {
 get; }

C++

public:
property DataGridViewSelectedColumnCollection^ SelectedColumns {
    DataGridViewSelectedColumnCollection^ get ();
}

J#

/** @property */
public DataGridViewSelectedColumnCollection get_SelectedColumns
 ()

JScript

public function get SelectedColumns
 () : DataGridViewSelectedColumnCollection

プロパティ値
ユーザーが選択した列を表す DataGridViewSelectedColumnCollection。

解説

SelectedColumns プロパティに選択された列を読み込むために、SelectionMode プロパティを DataGridViewSelectionMode.FullColumnSelect または DataGridViewSelectionMode.ColumnHeaderSelect に設定する必要があります。

このプロパティには、参照された時点の選択の読み取り専用スナップショットが格納されます。このコレクションのコピーを保持し続けた場合、ユーザーが選択を変更した実際の後続の DataGridView 状態とは異なる可能性があります。したがって、このコレクションのコピーは使用しないでください。

使用例

SelectedColumns プロパティを使用して、プログラムによる並べ替えで選択列を取得するコード例を次に示します。この例では、このプロパティを Sort メソッドで使用して、並べ替えの方向を決定します。

Visual Basic

Private Sub SortButton_Click(ByVal
 sender As Object, _
    ByVal e As EventArgs) Handles
 sortButton.Click

    ' Check which column is selected, otherwise set NewColumn to Nothing.
    Dim newColumn As DataGridViewColumn
    If dataGridView1.Columns.GetColumnCount(DataGridViewElementStates
 _
        .Selected) = 1 Then
        newColumn = dataGridView1.SelectedColumns(0)
    Else
        newColumn = Nothing
    End If

    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


    ' If no column has been selected, display an error dialog  box.
    If newColumn Is Nothing
 Then
        MessageBox.Show("Select a single column and try again.",
 _
            "Error: Invalid Selection", MessageBoxButtons.OK,
 _
            MessageBoxIcon.Error)
    Else
        dataGridView1.Sort(newColumn, direction)
        If direction = ListSortDirection.Ascending Then
            newColumn.HeaderCell.SortGlyphDirection = SortOrder.Ascending
        Else
            newColumn.HeaderCell.SortGlyphDirection = SortOrder.Descending
        End If
    End If

End Sub

C#

private void sortButton_Click(object sender,
 System.EventArgs e)
{
    // Check which column is selected, otherwise set NewColumn to null.
    DataGridViewColumn newColumn =
        dataGridView1.Columns.GetColumnCount(
        DataGridViewElementStates.Selected) == 1 ?
        dataGridView1.SelectedColumns[0] : null;

    DataGridViewColumn oldColumn = dataGridView1.SortedColumn;
    ListSortDirection direction;

    // If oldColumn is null, then the DataGridView is not currently
 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;
    }

    // If no column has been selected, display an error dialog  box.
    if (newColumn == null)
    {
        MessageBox.Show("Select a single column and try again."
,
            "Error: Invalid Selection", MessageBoxButtons.OK,
            MessageBoxIcon.Error);
    }
    else
    {
        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 フォーム)