バージョン

SummaryDescriptionMask プロパティ

集計レコードのヘッダーに何を表示するのかを指定します。
シンタックス
'宣言
 
Public Property SummaryDescriptionMask As String
public string SummaryDescriptionMask {get; set;}
解説

デフォルトで各集計レコードはその上にヘッダーを表示します。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 は親データ レコード内の任意のフィールドにすることができます。これは、親データ レコード内のそのフィールドの値で置き換えられます。

明示的に設定されない場合、このプロパティは以下のように解決されます。

  • 総集計
  • "[PRIMARY_FIELD] の集計"
    Group By レコードがある場合、このプロパティではなく SummaryDescriptionMaskInGroupBy が使用される点に注意してください。

注: 集計レコード ヘッダーを非表示にするには、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" );
		}
        <igDP:XamDataGrid x:Name="_dp" HorizontalAlignment="Stretch" VerticalAlignment="Stretch" >

            
<igDP:XamDataGrid.FieldSettings>
                
<igDP:FieldSettings SummaryDisplayArea="Bottom" />
            
</igDP:XamDataGrid.FieldSettings>

            
<igDP:XamDataGrid.FieldLayouts>
                
<!--
                    Note that you actually have to set SummaryDescriptionVisibility, which we do further below, 
                    to actually show the summary description.
                
-->
                
<igDP:FieldLayout IsDefault="true" 
                        
SummaryDescriptionMask="Grand Summaries"
                        
SummaryDescriptionMaskInGroupBy="Summaries for [GROUP_BY_VALUE]"
                    
>
                    
<!-- Set SummaryDescriptionVisibility to actually show the summary description. -->
                    
<igDP:FieldLayout.Settings>
                        
<igDP:FieldLayoutSettings SummaryDescriptionVisibility="Visible" />
                    
</igDP:FieldLayout.Settings>
                    
                    
<!-- Add a summary - without at least one summary, the summary record will not be displayed -->
                    
<igDP:FieldLayout.SummaryDefinitions>
                        
<igDP:SummaryDefinition SourceFieldName="Price" Calculator="Average" />
                    
</igDP:FieldLayout.SummaryDefinitions>
                    
                
</igDP:FieldLayout>
            
</igDP:XamDataGrid.FieldLayouts>

        
</igDP:XamDataGrid>
参照