Utilisation de la classe GlobalizationSettings pour les étiquettes de sous-total personnalisées et une autre étiquette de graphique à secteurs

Scénarios d’utilisation possibles

Aspose.Cells Les API ont exposé leGlobalizationSettingsclasse afin de gérer les scénarios dans lesquels l’utilisateur souhaite utiliser des étiquettes personnalisées pour les sous-totaux dans une feuille de calcul. De plus, leGlobalizationSettings la classe peut également être utilisée pour modifier laAutre étiquette pour le graphique à secteurs lors du rendu de la feuille de calcul ou du graphique.

Introduction à la classe GlobalizationSettings

LeGlobalizationSettings propose actuellement les 3 méthodes suivantes qui peuvent être remplacées dans une classe personnalisée pour obtenir les étiquettes souhaitées pour les sous-totaux ou pour afficher le texte personnalisé pour leAutre étiquette d’un graphique à secteurs.

1. GlobalizationSettings.GetTotalName: Obtient le nom total de la fonction.
2. GlobalizationSettings.GetGrandTotalName: Obtient le nom du total général de la fonction.
3. GlobalizationSettings.GetOtherName: Obtient le nom des libellés “Autre” pour les graphiques à secteurs.

Étiquettes personnalisées pour les sous-totaux

LeGlobalizationSettingspeut être utilisée pour personnaliser les étiquettes de sous-total en remplaçant laGlobalizationSettings.GetTotalName & GlobalizationSettings.GetGrandTotalNameméthodes comme démontré ci-dessus.

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

Afin d’injecter des étiquettes personnalisées, il est nécessaire d’attribuer leWorkbookSettings.GlobalizationSettingsWorkbookSettings.GlobalizationSettings propriété à une instance deParamètres personnalisésclasse définie ci-dessus avant d’ajouter les sous-totaux à la feuille de calcul.

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

LeGlobalizationSettingsla classe ne fonctionne que pour ajouter de nouveaux sous-totaux. Si une feuille de calcul contient déjà des sous-totaux, leurs libellés ne peuvent pas être modifiés.

Texte personnalisé pour une autre étiquette de graphique à secteurs

LeGlobalizationSettings offres de coursObtenirAutreNomméthode qui est utile pour donner une valeur personnalisée à l’étiquette “Autre” des graphiques à secteurs. L’extrait de code suivant définit une classe personnalisée et remplace leObtenirAutreNomméthode pour obtenir une étiquette personnalisée basée sur l’identifiant de culture du système.

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

L’extrait de code suivant charge une feuille de calcul existante contenant un graphique à secteurs et affiche le graphique sous forme d’image tout en utilisant leParamètres personnalisésclasse créée ci-dessus.

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