SummaryStringFormats プロパティ

ひとつまたは複数の計算式タイプで集計結果をフォーマットするために使用する文字列フォーマットを指定します。

シンタックス

Visual Basic
C#

'宣言
 
Public Property SummaryStringFormats As String

public string SummaryStringFormats {get; set;}

解説

これはコンマで区切られたフォーマットのリストとなり、ここで必要に応じてひとつまたは複数の計算式の文字列フォーマットを指定できます。

例：「sum: TOTAL={0:c}, average: AVG={0:c}, count: COUNT={0}」
文字列の各コンマで区切られた値には ‘:’ およびその計算式のフォーマットが後ろに続いた計算式名があります。この例では、合計は ‘TOTAL={0:c}’ を平均は ‘AVG={0:c}' をカウントは ‘COUNT={0}’ を使用してフォーマットされます。

SummaryDefinition.StringFormat プロパティを使用して個々の SummaryDefinition オブジェクトの文字列書式を指定することもできる点に注意してください。

使用例

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

        Dim fieldLayout As FieldLayout = _dp.FieldLayouts(0)

        Dim summary As SummaryDefinition = fieldLayout.SummaryDefinitions.Add(SummaryCalculator.Sum, "Price")

        ' StringFormat property's value is used to format the summary result using String's Format
        ' method. See .NET String.Format method for more information on available formatting options.
        summary.StringFormat = "Sum={0:C}"

        ' You can also specify a string format provider to use for the summary result.
        summary.StringFormatProvider = System.Globalization.CultureInfo.GetCultureInfo("fr-FR")

        ' Also note that SummaryStringFormats property of the Field can be used to control the format
        ' that gets assigned to summaries that the user selectes via the user interface (summary icon
        ' on the field label). This is in the format of "calculator_name1: format1, calculator_name2: format2".
        fieldLayout.Fields("Price").Settings.AllowSummaries = True
        fieldLayout.Fields("Price").SummaryStringFormats = _
            "sum: TOTAL={0:c}, average: AVG={0:c}, count: COUNT={0}, minimum: MIN={0:c}, maximum: MAX={0:c}"

    End Sub

using Infragistics.Windows;
using Infragistics.Windows.Editors;
using Infragistics.Windows.DataPresenter;

		public void Window1_Loaded( object sender, RoutedEventArgs e )
		{
			_dp.DataSource = _dataSource;

			FieldLayout fieldLayout = _dp.FieldLayouts[0];

			SummaryDefinition summary = fieldLayout.SummaryDefinitions.Add( SummaryCalculator.Sum, "Price" );

			// StringFormat property's value is used to format the summary result using String's Format
			// method. See .NET String.Format method for more information on available formatting options.
			summary.StringFormat = "Sum={0:C}";

			// You can also specify a string format provider to use for the summary result.
			summary.StringFormatProvider = System.Globalization.CultureInfo.GetCultureInfo( "fr-FR" );
			
			// Also note that SummaryStringFormats property of the Field can be used to control the format
			// that gets assigned to summaries that the user selectes via the user interface (summary icon
			// on the field label). This is in the format of "calculator_name1: format1, calculator_name2: format2".
			fieldLayout.Fields["Price"].Settings.AllowSummaries = true;
			fieldLayout.Fields["Price"].SummaryStringFormats = 
				"sum: TOTAL={0:c}, average: AVG={0:c}, count: COUNT={0}, minimum: MIN={0:c}, maximum: MAX={0:c}";
		}

XAML

<igDP:XamDataGrid x:Name="_dp" HorizontalAlignment="Stretch" VerticalAlignment="Stretch" >

            <igDP:XamDataGrid.FieldLayouts>
                <igDP:FieldLayout IsDefault="true" >
                    <igDP:FieldLayout.SummaryDefinitions>
                        
                        <igDP:SummaryDefinition
                                SourceFieldName="Price"
                                Calculator="Sum"
                                StringFormat="{}Sum={0:C}"
                            />
                    </igDP:FieldLayout.SummaryDefinitions>

                    <igDP:FieldLayout.Fields>
                        
                        <igDP:Field
                                Name="Price"
                                SummaryStringFormats="{}sum: TOTAL={0:c}, average: AVG={0:c}, count: COUNT={0}, minimum: MIN={0:c}, maximum: MAX={0:c}"
                            >
                            <igDP:Field.Settings>
                                <igDP:FieldSettings AllowSummaries="true" />
                            </igDP:Field.Settings>
                        </igDP:Field>
                    </igDP:FieldLayout.Fields>
                </igDP:FieldLayout>
            </igDP:XamDataGrid.FieldLayouts>

        </igDP:XamDataGrid>

参照

Field クラス
 Field メンバ
 StringFormat プロパティ

WPF | ヘルプ トピック

SummaryStringFormats プロパティ

参照

WPF | ヘルプトピック