デフォルトで各集計レコードはその上にヘッダーを表示します。SummaryDescriptionMask プロパティと SummaryDescriptionMaskInGroupBy プロパティを使用して、ヘッダー内に表示する内容を指定できます。SummaryDescriptionMaskInGroupBy は、親レコードが GroupByRecord の集計レコードに使用されます。そうでない場合は SummaryDescriptionMask が使用されます。
集計記述マスクは、対応する値によって置き換えられる特定のトークンを持つ置き換え文字列です。以下は、サポートされるトークンのリストです。
トークン | 置き換え文字列 |
---|---|
[GROUP_BY_VALUE] | 親グループ化レコードの値。 |
[GROUP_BY_VALUES] | ',' によって区切られるすべての祖先グループ化レコードの値。 |
[PRIMARY_FIELD] | 親データ レコードの (Field のField.IsPrimary プロパティを使用して指定した) primary フィールドの値。 |
[TREE_FIELD] | Value of the tree field in the parent data record. If not in tree view then the value of the primary field will be used. |
[SCROLLTIP_FIELD] | 親データ レコードの (Field のField.IsScrollTipField プロパティを使用して指定した) scroll-tip フィールドの値。 |
[PARENT_FIELD_NAME] | 集計レコードが子レコード コレクションと関連付けられている場合には、このトークンは親の展開可能なフィールド名で置き換えられます。 |
[FieldName] | ここで FieldName は親データ レコード内の任意のフィールドにすることができます。これは、親データ レコード内のそのフィールドの値で置き換えられます。 |
明示的に設定されない場合、このプロパティは以下のように解決されます。
注: 集計レコード ヘッダーを非表示にするには、FieldLayoutSetting の FieldLayoutSettings.SummaryDescriptionVisibility プロパティを使用します。
Imports Infragistics.Windows Imports Infragistics.Windows.Editors Imports Infragistics.Windows.DataPresenter Private Sub Window1_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs) _dp.DataSource = _dataSource ' By default summary records are displayed only at top level and not within nested ' group-by records. To demonstrate SummaryDescriptionMaskInGroupBy property, which applies ' to summary records inside nested group-by records, we need display summaries in nested ' group-by records by setting SummaryDisplayArea to a value that doesn't contain ' TopLevelOnly. ' _dp.FieldSettings.SummaryDisplayArea = SummaryDisplayAreas.Bottom Dim fieldLayout As FieldLayout = _dp.FieldLayouts(0) ' Note that you actually have to set SummaryDescriptionVisibility, which we do further below, ' to actually show the summary description. fieldLayout.SummaryDescriptionMask = "Grand Summaries" fieldLayout.SummaryDescriptionMaskInGroupBy = "Summaries for [GROUP_BY_VALUE]" ' Set SummaryDescriptionVisibility to actually show the summary description. fieldLayout.Settings.SummaryDescriptionVisibility = Visibility.Visible ' Add a summary - without at least one summary, the summary record will not be displayed. fieldLayout.SummaryDefinitions.Add(SummaryCalculator.Sum, "Price") End Sub
using Infragistics.Windows; using Infragistics.Windows.Editors; using Infragistics.Windows.DataPresenter; public void Window1_Loaded( object sender, RoutedEventArgs e ) { _dp.DataSource = _dataSource; // By default summary records are displayed only at top level and not within nested // group-by records. To demonstrate SummaryDescriptionMaskInGroupBy property, which applies // to summary records inside nested group-by records, we need display summaries in nested // group-by records by setting SummaryDisplayArea to a value that doesn't contain // TopLevelOnly. // _dp.FieldSettings.SummaryDisplayArea = SummaryDisplayAreas.Bottom; FieldLayout fieldLayout = _dp.FieldLayouts[0]; // Note that you actually have to set SummaryDescriptionVisibility, which we do further below, // to actually show the summary description. fieldLayout.SummaryDescriptionMask = "Grand Summaries"; fieldLayout.SummaryDescriptionMaskInGroupBy = "Summaries for [GROUP_BY_VALUE]"; // Set SummaryDescriptionVisibility to actually show the summary description. fieldLayout.Settings.SummaryDescriptionVisibility = Visibility.Visible; // Add a summary - without at least one summary, the summary record will not be displayed. fieldLayout.SummaryDefinitions.Add( SummaryCalculator.Sum, "Price" ); }