CellName プロパティ (HeaderDropDownList)

対応するセルのセル名。フィルタ項目および並べ替え項目は、指定した名前を持つセルに対して動作します。

構文

Visual Basic (宣言)
C#

Public Property CellName As String

public string CellName {get; set;}

プロパティ値

対応するセルの名前を示すSystem.String。有効なCellNameを設定した場合、これはString.Emptyになります。

解説

HeaderDropDownListの対応するセルはインデックスまたは名前で設定します。リストのDropDownItemはこれらを使用して対応するセルを取得し、それらのセルに対して動作します。インデックスまたは名前が無効な場合は、項目をクリックしても何も起こりません。

使用例

次のサンプルコードは、ドロップダウンリストの操作対象となるセルを指定する方法を示します。このサンプルコードは、ColumnHeaderCell.DropDownListプロパティに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

void setSecondColumnDropDownListButton_Click(object sender, EventArgs e)
{
    // Create a header drop down list without default down down items.
    HeaderDropDownList headerDropDownList = new HeaderDropDownList();

    // If do not indicate which cell to be filtered, the cell which has same index with column header cell in row section will be filtered.
    headerDropDownList.CellName = "textBoxCell2";

    DropDownItemCollection dropDownItemCollection = headerDropDownList.Items;
    // Initialize drop down items manually.
    // Add sort item.
    dropDownItemCollection.Add(new DropDownSortItem(SortOrder.Ascending));
    dropDownItemCollection.Add(new DropDownSortItem(SortOrder.Descending));
    
    // Add a separator line.
    dropDownItemCollection.Add(new DropDownSeparatorItem());

    // Add show all, black and none black items.
    dropDownItemCollection.Add(new DropDownShowAllFilterItem());
    dropDownItemCollection.Add(new DropDownBlanksFilterItem());
    dropDownItemCollection.Add(new DropDownNonBlanksFilterItem());

    // Add auto filter items.
    dropDownItemCollection.Add(new DropDownAutoFilterItem());

    // Get second column header cell.
    ColumnHeaderCell columnHeaderCell = this.gcMultiRow1.ColumnHeaders[0][1] as ColumnHeaderCell;
    columnHeaderCell.DropDownList = headerDropDownList;
}

Private Sub setSecondColumnDropDownListButton_Click(ByVal sender As Object, ByVal e As EventArgs) Handles setSecondColumnDropDownListButton.Click
    ' Create a header drop down list without default down down items.
    Dim headerDropDownList As New HeaderDropDownList()

    ' If do not indicate which cell to be filtered, the cell which has same index with column header cell in row section will be filtered.
    headerDropDownList.CellName = "textBoxCell2"

    Dim dropDownItemCollection As DropDownItemCollection = headerDropDownList.Items
    ' Initialize drop down items manually.
    ' Add sort item.
    dropDownItemCollection.Add(New DropDownSortItem(SortOrder.Ascending))
    dropDownItemCollection.Add(New DropDownSortItem(SortOrder.Descending))

    ' Add a separator line.
    dropDownItemCollection.Add(New DropDownSeparatorItem())

    ' Add show all, black and none black items.
    dropDownItemCollection.Add(New DropDownShowAllFilterItem())
    dropDownItemCollection.Add(New DropDownBlanksFilterItem())
    dropDownItemCollection.Add(New DropDownNonBlanksFilterItem())

    ' Add auto filter items.
    dropDownItemCollection.Add(New DropDownAutoFilterItem())

    ' Get second column header cell.
    Dim columnHeaderCell As ColumnHeaderCell = TryCast(Me.gcMultiRow1.ColumnHeaders(0)(1), ColumnHeaderCell)
    columnHeaderCell.DropDownList = headerDropDownList
End Sub

参照

HeaderDropDownList クラス
 HeaderDropDownList メンバ