استخدام فئة GlobalizationSettings لملصقات المجموع الفرعي المخصص والتسميات الأخرى للمخطط الدائري

سيناريوهات الاستخدام الممكنة

كشفت واجهات برمجة التطبيقات Aspose.Cells ملفالعولمة الإعداداتclass من أجل التعامل مع السيناريوهات التي يرغب فيها المستخدم في استخدام تسميات مخصصة للمجاميع الفرعية في جدول بيانات. وعلاوة على ذلك، فإنالعولمة الإعدادات يمكن أيضًا استخدام class لتعديلآخر تسمية المخطط الدائري أثناء عرض ورقة العمل أو المخطط.

مقدمة في فئة GlobalizationSettings

الالعولمة الإعدادات تقدم الفئة حاليًا الطرق الثلاثة التالية التي يمكن تجاوزها في فئة مخصصة للحصول على التسميات المطلوبة للمجموعات الفرعية أو لتقديم نص مخصص لـآخر تسمية مخطط دائري.

1. GlobalizationSettings.GetTotalName: الحصول على الاسم الإجمالي للوظيفة.
2. GlobalizationSettings.GetGrandTotalName: الحصول على الاسم الإجمالي الكلي للوظيفة.
3. GlobalizationSettings.GetOtherName: الحصول على اسم التصنيفات “الأخرى” للمخططات الدائرية.

تسميات مخصصة للمجموعات الفرعية

الالعولمة الإعداداتيمكن استخدام الفئة لتخصيص تسميات الإجمالي الفرعي عن طريق تجاوزGlobalizationSettings.GetTotalName & GlobalizationSettings.GetGrandTotalNameالأساليب كما هو موضح في المستقبل.

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

لإدخال ملصقات مخصصة ، يلزم تعيين ملفWorkbookSettings.GlobalizationSettings الخاصية إلى مثيلإعدادات مخصصةالفئة المحددة أعلاه قبل إضافة الإجماليات الفرعية إلى ورقة العمل.

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

الالعولمة الإعداداتفئة تعمل فقط لإضافة مجاميع فرعية جديدة. إذا كان جدول البيانات يحتوي بالفعل على مجاميع فرعية ، فلا يمكن تعديل تسمياتها.

نص مخصص للتسمية الأخرى للمخطط الدائري

الالعولمة الإعدادات عروض الصف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();
        }
    }
}

يقوم المقتطف التالي بتحميل جدول بيانات موجود يحتوي على مخطط دائري ويعرض المخطط إلى صورة أثناء استخدامإعدادات مخصصةفئة تم إنشاؤها أعلاه.

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