ピーグラフのカスタムサブトータルラベルおよびその他のラベル用のGlobalizationSettingsクラスの使用

可能な使用シナリオ

Aspose.Cells のAPIでは、スプレッドシートでサブトータルのカスタムラベルを使用したい場合に GlobalizationSettings クラスが公開されています。さらに、ワークシートまたはチャートをレンダリングする際に Other ラベルを変更するためにも GlobalizationSettings クラスを使用することができます。

GlobalizationSettingsクラスの紹介

GlobalizationSettingsクラスには現在以下の3つのメソッドが公開されており、カスタムクラスでこれらをオーバーライドして望ましいラベルを取得することができます。

1. GlobalizationSettings.GetTotalName: 関数の合計名を取得します。
2. GlobalizationSettings.GetGrandTotalName: 関数のグランドトータル名を取得します。
3. GlobalizationSettings.GetOtherName: 円グラフの “その他” ラベルの名前を取得します。

サブトータルのカスタムラベル

GlobalizationSettingsクラスを使用してサブトータルのラベルをカスタマイズするには、上記で定義されたCustomSettingsクラスのインスタンスを作成し、シートにサブトータルを追加する前にこのプロパティを割り当てる必要があります。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Defines a custom class derived from GlobalizationSettings class
class CustomSettings : GlobalizationSettings
{
    // Overrides the GetTotalName method
    public override string GetTotalName(ConsolidationFunction functionType)
    {
        // Checks the function type used to add the subtotals
        switch (functionType)
        {
            // Returns custom value based on the function type used to add the subtotals
            case ConsolidationFunction.Average:
                return "AVG";
            // Handle other cases as per requirement
            default:
                return base.GetTotalName(functionType);
        }
    }

    // Overrides the GetGrandTotalName method
    public override string GetGrandTotalName(ConsolidationFunction functionType)
    {
        // Checks the function type used to add the subtotals
        switch (functionType)
        {
            // Returns custom value based on the function type used to add the subtotals
            case ConsolidationFunction.Average:
                return "GRD AVG";
            // Handle other cases as per requirement
            default:
                return base.GetGrandTotalName(functionType);
        }
    }
}

カスタムラベルを挿入するには、新しいサブトータルを追加する必要があります。スプレッドシートにすでにサブトータルが含まれている場合は、そのラベルを変更することはできません。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Loads an existing spreadsheet containing some data
Workbook book = new Workbook(dataDir + "sample.xlsx");

// Assigns the GlobalizationSettings property of the WorkbookSettings class to the class created in first step
book.Settings.GlobalizationSettings = new CustomSettings();

// Accesses the 1st worksheet from the collection which contains data resides in the cell range A2:B9
Worksheet sheet = book.Worksheets[0];

// Adds Subtotal of type Average to the worksheet
sheet.Cells.Subtotal(CellArea.CreateCellArea("A2", "B9"), 0, ConsolidationFunction.Average, new int[] { 1 });

// Calculates Formulas
book.CalculateFormula();

// Auto fits all columns
sheet.AutoFitColumns();

// Saves the workbook on disc
book.Save(dataDir + "output_out.xlsx");

GlobalizationSettingsクラスは、新しい小計を追加するためだけに動作します。スプレッドシートにすでに小計が含まれている場合、そのラベルは変更できません。

円グラフの他のラベルのカスタムテキスト

GlobalizationSettings クラスは、“その他"の円グラフのラベルにカスタム値を与えるために便利なGetOtherName メソッドを提供します。次のコードは、カスタムクラスを定義し、システムのカルチャ識別子に基づいてカスタムラベルを取得するためにGetOtherName メソッドをオーバーライドします。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Defines a custom class inherited by GlobalizationSettings class
class GlobalCustomSettings : ChartGlobalizationSettings
{
    // Overrides the GetOtherName method
    public override string GetOtherName()
    {
        // Gets the culture identifier for the current system
        int lcid = System.Globalization.CultureInfo.CurrentCulture.LCID;
        switch (lcid)
        {
            // Handles case for English
            case 1033:
                return "Other";
            // Handles case for French
            case 1036:
                return "Autre";
            // Handles case for German
            case 1031:
                return "Andere";
            // Handle other cases
            default:
                return base.GetOtherName();
        }
    }
}

次のコードは、円グラフを含む既存のスプレッドシートを読み込み、上記で作成したCustomSettings クラスを使用して画像にレンダリングします。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Loads an existing spreadsheet containing a pie chart
Workbook book = new Workbook(dataDir + "sample.xlsx");

// Assigns the GlobalizationSettings property of the WorkbookSettings class to the class created in first step
book.Settings.GlobalizationSettings.ChartSettings = new GlobalCustomSettings();

// Accesses the 1st worksheet from the collection which contains pie chart
Worksheet sheet = book.Worksheets[0];

// Accesses the 1st chart from the collection
Chart chart = sheet.Charts[0];

// Refreshes the chart
chart.Calculate();

// Renders the chart to image
chart.ToImage(dataDir + "output_out.png", new ImageOrPrintOptions());