استخدام فئة GlobalizationSettings لتخصيص علامات مجموع جزئي مخصصة وعلامة أخرى لمخطط البيت
سيناريوهات الاستخدام المحتملة
وقد طرحت واجهة برمجة تطبيقات Aspose.Cells الفئة GlobalizationSettings للتعامل مع السيناريوهات التي يرغب المستخدم في استخدام علامات مخصصة للمجاميع الجزئية في جدول بيانات. علاوة على ذلك، يمكن أيضًا استخدام فئة GlobalizationSettings لتعديل العلامة أخرى لمخطط البيت أثناء استخراج الورقة العمل أو المخطط.
مقدمة في فئة GlobalizationSettings
تقدم فئة GlobalizationSettings حاليًا 3 طرق يمكن تجاوزها في فئة مخصصة للحصول على علامات مرجعية مرغوبة للمجاميع الجزئية أو لتصدير نص مخصص لعلامة أخرى لمخطط البيت.
- GlobalizationSettings.GetTotalName: يحصل على الاسم الكامل للوظيفة.
- GlobalizationSettings.GetGrandTotalName: يستلم اسم المجموع الكلي للوظيفة.
- GlobalizationSettings.GetOtherName: يستلم اسم “أخرى” لعلامات مخطط البيت.
علامات مخصصة للمجاميع الجزئية
يمكن استخدام فئة GlobalizationSettings لتخصيص علامات المجموع الجزئي عن طريق تجاوز الطرق 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 إلى مثيل من فئة 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 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 طريقة 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()); |