SummaryDescriptionVisibility Property

Specifies whether summary records display description. Default is resolved to Collapsed.

Syntax

Visual Basic

'Declaration
 
Public Property SummaryDescriptionVisibility As Nullable(Of Visibility)

C#

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

Remarks

You can display a description of summaries above the summary record by setting SummaryDescriptionVisibility to Visible. By default summary description is not displayed. You can specify the description to display using FieldLayout's SummaryDescriptionMask, SummaryDescriptionMaskInGroupBy and SummaryResultCollection's SummaryResultCollection.SummaryRecordHeader properties.

Example

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>

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2