Используя класс ChartGlobalizationSettings для установки другого языка для компонента диаграммы
Возможные сценарии использования
API Aspose.Cells представило класс ChartGlobalizationSettings, чтобы работать с ситуациями, когда пользователь хочет установить компонент диаграммы на другом языке. настраиваемые метки для промежуточных итогов в электронной таблице.
Введение в класс ChartGlobalizationSettings
Класс ChartGlobalizationSettings в настоящее время предлагает следующие 8 методов, которые могут быть переопределены в пользовательском классе для перевода, такие как название оси, название единицы оси, название диаграммы и т. д. на другой язык.
- GetAxisTitleName: Получает название заголовка для оси.
- GetAxisUnitName: Получает название единицы оси.
- GetChartTitleName: Получает название заголовка диаграммы.
- GetLegendDecreaseName: Получает название уменьшения для легенды.
- GetLegendIncreaseName: Получает название увеличения для легенды.
- GetLegendTotalName: Получает название итога для легенды.
- GetOtherName: Получает название меток “Другие” для диаграммы.
- GetSeriesName: Получает название серии в диаграмме.
Пользовательский перевод языка
Здесь мы создадим водопадную диаграмму на основе следующих данных. Названия компонентов диаграммы будут отображаться на английском языке. Мы воспользуемся турецким примером, чтобы показать, как отображать заголовок диаграммы, наименования увеличения/уменьшения в легенде, общее наименование и заголовок оси на турецком языке.
Образец кода
В следующем образце кода загружается образец файла Excel.
//Create a custom language class for chart component,here take Turkey for example, | |
//which will translate the chart element to specific language | |
public class TurkeyChartGlobalizationSettings : ChartGlobalizationSettings | |
{ | |
public override string GetChartTitleName() | |
{ | |
return "Grafik Başlığı";//Chart Title | |
} | |
public override string GetLegendIncreaseName() | |
{ | |
return "Artış";//Increase | |
} | |
public override string GetLegendDecreaseName() | |
{ | |
return "Düşüş";//Decrease; | |
} | |
public override string GetLegendTotalName() | |
{ | |
return "Toplam";//Total | |
} | |
public override string GetAxisTitleName() | |
{ | |
return "Eksen Başlığı";//Axis Title | |
} | |
} | |
public static void ChartGlobalizationSettingsTest() | |
{ | |
//Create an instance of existing Workbook | |
string pathName = "input.xlsx"; | |
Workbook workbook = new Workbook(pathName); | |
//Set custom chartGlobalizationSettings, here is TurkeyChartGlobalizationSettings | |
workbook.Settings.GlobalizationSettings.ChartSettings = new TurkeyChartGlobalizationSettings(); | |
//Get the worksheet | |
Worksheet worksheet = workbook.Worksheets[0]; | |
ChartCollection chartCollection = worksheet.Charts; | |
//Load the chart from source worksheet | |
Chart chart = chartCollection[0]; | |
//Chart Calculate | |
chart.Calculate(); | |
//Get the chart title | |
Title title = chart.Title; | |
//Output the name of the Chart title | |
Console.WriteLine("\nWorkbook chart title: " + title.Text); | |
string[] legendEntriesLabels = chart.Legend.GetLegendLabels(); | |
//Output the name of the Legend | |
for (int i = 0; i < legendEntriesLabels.Length; i++) | |
{ | |
Console.WriteLine("\nWorkbook chart legend: " + legendEntriesLabels[i]); | |
} | |
//Output the name of the Axis title | |
Title categoryAxisTitle = chart.CategoryAxis.Title; | |
Console.WriteLine("\nWorkbook category axis tile: " + categoryAxisTitle.Text); | |
} |
Вывод, созданный образцовым кодом
Это вывод консоли вышеуказанного образца кода.
Workbook chart title: Grafik Başlığı
Workbook chart legend: Artış
Workbook chart legend: Düşüş
Workbook chart legend: Toplam
Workbook category axis tile: Eksen Başlığı