Användning av klassen GlobalizationSettings för anpassade subtotalmärken och andra märken för cirkeldiagram

Möjliga användningsscenario

Aspose.Cells API:er har exponerat GlobalizationSettings klassen för att hantera scenarier där användaren vill använda anpassade etiketter för subtotals i en kalkylblad. Dessutom kan GlobalizationSettings klassen också användas för att modifiera Oavslutad-etiketten för Pie-diagrammet medan kalkylbladet eller diagrammet renderas.

Introduktion till klassen GlobalizationSettings

GlobalizationSettings klassen erbjuder för närvarande följande 3 metoder som kan åsidosättas i en anpassad klass för att få önskade etiketter för subtotaler eller för att rendera anpassad text för Oavslutad-etiketten på ett Pie-diagram.

1. GlobalizationSettings.GetTotalName: Hämtar det totala namnet på funktionen.
2. GlobalizationSettings.GetGrandTotalName: Hämtar det totala namnet på den totala funktionen.
3. GlobalizationSettings.GetOtherName: Hämtar namnet på “Övrigt”-etiketter för Pie-diagram.

Anpassade etiketter för subtotaler

GlobalizationSettings klassen kan användas för att anpassa subtotal-etiketterna genom att åsidosätta GlobalizationSettings.GetTotalName & GlobalizationSettings.GetGrandTotalName metoderna som visas framåt.

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

För att infogna anpassade etiketter krävs det att WorkbookSettings.GlobalizationSettings egenskapen tilldelas en instans av CustomSettings klassen som definieras ovan innan subtotalerna läggs till i kalkylbladet.

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

Klassen GlobalizationSettings fungerar endast för att lägga till nya delsummeringar. Om ett kalkylblad redan innehåller delsummeringar kan deras etiketter inte ändras.

Anpassad text för annan etikett för cirkeldiagram

Klassen GlobalizationSettings erbjuder GetOtherName metod som är användbar för att ge Pie-diagram en anpassad värde för etiketten “Övrigt”. Följande avsnitt definierar en anpassad klass och åsidosätter metoden GetOtherName för att få en anpassad etikett baserad på systemets kulturtillhörighet.

// 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();
        }
    }
}

Följande avsnutt laddar ett befintligt kalkylblad som innehåller ett Pie-diagram och renderar diagrammet till en bild med hjälp av CustomSettings-klassen skapad ovan.

// 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());