SummaryDescriptionVisibility プロパティ

集計レコードが説明を表示するかどうかを指定します。Default は Collapsed に解決されます。

シンタックス

Visual Basic

'宣言
 
Public Property SummaryDescriptionVisibility As Nullable(Of Visibility)

C#

public Nullable<Visibility> SummaryDescriptionVisibility {get; set;}

解説

SummaryDescriptionVisibility を Visible に設定することによって、集計レコードの上に集計の説明を表示することができます。デフォルトでは、要約説明ボタンは表示されません。FieldLayout の SummaryDescriptionMask、SummaryDescriptionMaskInGroupBy プロパティおよび SummaryResultCollection の SummaryResultCollection.SummaryRecordHeader プロパティを使用して記述を表示するよう指定できます。

使用例

The following code demonstrates the usage of SummaryDescriptionVisibility, SummaryDescriptionMask and SummaryDescriptionMaskInGroupBy properties.

Visual Basic

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

C#

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" );
		}

XAML

        <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>