Använd Class ChartGlobalizationSettings för att ställa in olika språk för diagramkomponenter med C++

Möjliga användningsscenario

Aspose.Cells API har exponerat ChartGlobalizationSettings-klassen för att hantera scenarier där användaren vill ställa in diagramkomponent till olika språk. Anpassade etiketter för delsummer i en kalkyl.

Introduktion till ChartGlobalizationSettings-klassen

Klassen ChartGlobalizationSettings erbjuder för närvarande de följande 8 metoder som kan åsidosättas i en anpassad klass för att översätta såsom AxisTitle-namn, AxisUnit-namn, ChartTitle-namn och så vidare till ett annat språk.

  1. GetAxisTitleName: Hämtar namnet på titeln för axeln.
  2. GetAxisUnitName: Hämtar namnet på axelenhet.
  3. GetChartTitleName: Hämtar namnet på diagramtiteln.
  4. GetLegendDecreaseName: Hämtar namnet på minskningen för förklaringen.
  5. GetLegendIncreaseName: Hämtar namnet på ökningen för förklaringen.
  6. GetLegendTotalName: Hämtar namnet på totalen för förklaringen.
  7. GetOtherName: Hämtar namnet på “Annan” etiketter för diagrammet.
  8. GetSeriesName: Hämtar namnet på serier i diagrammet.

Anpassad språköversättning

Här kommer vi att skapa en stapeldiagram baserat på följande data. Namnen på diagramkomponenterna kommer att visas på engelska i diagrammet. Vi kommer att använda ett turkiskt språkexempel för att visa hur man visar diagramtitel, förklarings-ökning/minskning, totalt namn och axelns titel på turkiska.

todo:image_alt_text

Exempelkod

Följande exempelkod laddar prov Excel-filen.

#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;
using namespace Aspose::Cells::Charts;

class TurkeyChartGlobalizationSettings : public ChartGlobalizationSettings
{
public:
    TurkeyChartGlobalizationSettings() : ChartGlobalizationSettings() {}

    U16String GetChartTitleName() override
    {
        return u"Grafik Başlığı"; // Chart Title
    }

    U16String GetLegendIncreaseName() override
    {
        return u"Artış"; // Increase
    }

    U16String GetLegendDecreaseName() override
    {
        return u"Düşüş"; // Decrease
    }

    U16String GetLegendTotalName() override
    {
        return u"Toplam"; // Total
    }

    U16String GetAxisTitleName() override
    {
        return u"Eksen Başlığı"; // Axis Title
    }
};

void ChartGlobalizationSettingsTest()
{
    // Create an instance of existing Workbook
    U16String pathName = u"input.xlsx";
    Workbook workbook(pathName);

    // Set custom chartGlobalizationSettings, here is TurkeyChartGlobalizationSettings
    TurkeyChartGlobalizationSettings* globalizationSettings = new TurkeyChartGlobalizationSettings();
    workbook.GetSettings().GetGlobalizationSettings()->SetChartSettings(globalizationSettings);

    // Get the worksheet
    Worksheet worksheet = workbook.GetWorksheets().Get(0);

    // Load the chart from source worksheet
    ChartCollection chartCollection = worksheet.GetCharts();
    Chart chart = chartCollection.Get(0);

    // Chart Calculate
    chart.Calculate();

    // Get the chart title
    Title title = chart.GetTitle();

    // Output the name of the Chart title
    std::cout << "\nWorkbook chart title: " << title.GetText().ToUtf8() << std::endl;

    // Get the legend labels
    Vector<U16String> legendEntriesLabels = chart.GetLegend().GetLegendLabels();

    // Output the name of the Legend
    for (int i = 0; i < legendEntriesLabels.GetLength(); i++)
    {
        std::cout << "\nWorkbook chart legend: " << legendEntriesLabels[i].ToUtf8() << std::endl;
    }

    // Output the name of the Axis title
    Title categoryAxisTitle = chart.GetCategoryAxis().GetTitle();
    std::cout << "\nWorkbook category axis title: " << categoryAxisTitle.GetText().ToUtf8() << std::endl;

    delete globalizationSettings;
}

int main()
{
    Aspose::Cells::Startup();
    ChartGlobalizationSettingsTest();
    Aspose::Cells::Cleanup();
    return 0;
}

Utdata genererad av provkoden

Detta är konsoloutputen för ovanstående exempelkod.

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