Verwendung der ChartGlobalizationSettings Klasse zum Einstellen einer anderen Sprache für das Diagrammkomponente

Mögliche Verwendungsszenarien

Aspose.Cells-APIs haben die Klasse ChartGlobalizationSettings freigelegt, um mit Szenarien umzugehen, in denen der Benutzer die Diagrammkomponente auf eine andere Sprache einstellen möchte. Benutzerdefinierte Beschriftungen für Zwischensummen in einer Tabelle.

Einführung in die ChartGlobalizationSettings-Klasse

Die Klasse ChartGlobalizationSettings bietet derzeit die folgenden 8 Methoden, die in einer benutzerdefinierten Klasse überschrieben werden können, um beispielsweise Achsentitel, Achsenbeschriftung, Diagrammtitel usw. in verschiedene Sprachen zu übersetzen.

1. GetAxisTitleName: Gibt den Titel für die Achse zurück.
2. GetAxisUnitName: Gibt den Namen der Achseneinheit zurück.
3. GetChartTitleName: Gibt den Titel des Diagramms zurück.
4. GetLegendDecreaseName: Gibt den Namen der Abnahme für die Legende zurück.
5. GetLegendIncreaseName: Gibt den Namen des Anstiegs für die Legende zurück.
6. GetLegendTotalName: Gibt den Namen des Gesamtwerts für die Legende zurück.
7. GetOtherName: Gibt den Namen der “Andere”-Beschriftungen für das Diagramm zurück.
8. GetSeriesName: Gibt den Namen der Serie im Diagramm zurück.

Benutzerdefinierte Sprachübersetzung

Hier erstellen wir ein Wasserfalldiagramm basierend auf den folgenden Daten. Die Namen der Diagrammkomponenten werden im Diagramm auf Englisch angezeigt. Wir verwenden ein Beispiel für die türkische Sprache, um zu zeigen, wie der Diagrammtitel, die Legenden-Abnahme/Zunahme-Namen, der Gesamtwert und der Achsentitel auf Türkisch angezeigt werden.

Beispielcode

Der folgende Beispielcode lädt die Beispieldatei 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);
}

Ausgabe, die vom Beispielcode generiert wurde

Dies ist die Konsolenausgabe des obigen Beispiels.

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ığı