DropDownAutoFilterItem クラス

HeaderDropDownListの自動生成された項目を表します。このクラスは継承できません。

構文

Visual Basic (宣言)
C#

Public NotInheritable Class DropDownAutoFilterItem 
   Inherits DropDownItem
   Implements INamedObject

public sealed class DropDownAutoFilterItem : DropDownItem, INamedObject

解説

フィルタ操作は、HeaderDropDownList.CellIndexまたはHeaderDropDownList.CellNameによって指定された、HeaderDropDownList.StartRowとHeaderDropDownList.EndRowの間にあるセルに適用されます。

DropDownAutoFilterItemは、各セルに対応する項目を自動生成できます。このクラスは、FormattedValueごとに1回ずつDropDownItemNeededイベントを発生させます。このイベントハンドラで、各フィルタ値のDropDownCustomFilterItemを作成できます。このイベントを処理しない場合は、フィルタ値に基づいて既定のDropDownCustomFilterItemが作成されます。パフォーマンスの観点から、フィルタ値の数がMaxCountを超えると、冗長な項目は破棄されます。

注意:
DropDownAutoFilterItemでは、ImageCellのフィルタ項目は生成できません。

使用例

次のサンプルコードは、このドロップダウン項目を使用してユーザーが並べ替えまたはフィルタを実行できるようにする方法を示します。このサンプルコードは、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

継承階層

System.Object
GrapeCity.Win.MultiRow.DropDownItem
GrapeCity.Win.MultiRow.DropDownAutoFilterItem

参照

DropDownAutoFilterItem メンバ
 GrapeCity.Win.MultiRow 名前空間
 HeaderDropDownList クラス
 DropDownItemCollection クラス
 DropDownItem クラス
 DropDownShowAllFilterItem クラス
 DropDownBlanksFilterItem クラス
 DropDownNonBlanksFilterItem クラス
 DropDownCustomFilterItem クラス
 DropDownList プロパティ