Utilizzo della classe GlobalizationSettings per etichette di subtotale personalizzate e altre etichette del grafico a torta con C++
Possibili Scenari di Utilizzo
Le API di Aspose.Cells hanno esposto la classe GlobalizationSettings per gestire gli scenari in cui l’utente desidera utilizzare etichette personalizzate per le subtotali in un foglio di calcolo. Inoltre, la classe GlobalizationSettings può anche essere utilizzata per modificare l’etichetta Altro per il grafico a torta durante la visualizzazione del foglio di lavoro o del grafico.
Introduzione alla classe GlobalizationSettings
La classe GlobalizationSettings offre attualmente i seguenti 3 metodi che possono essere sovrascritti in una classe personalizzata per ottenere etichette desiderate per le subtotali o per creare testo personalizzato per l’etichetta Altro di un grafico a torta.
- GlobalizationSettings.GetTotalName: Ottiene il nome totale della funzione.
- GlobalizationSettings.GetGrandTotalName: Ottiene il nome del totale generale della funzione.
Etichette personalizzate per le subtotali
La classe GlobalizationSettings può essere utilizzata per personalizzare le etichette delle subtotali sovra-ridendo i metodi GlobalizationSettings.GetTotalName e GlobalizationSettings.GetGrandTotalName come dimostrato di seguito.
#include "Aspose.Cells.h"
using namespace Aspose::Cells;
class CustomSettings : public GlobalizationSettings
{
public:
U16String GetTotalName(ConsolidationFunction functionType) override
{
switch (functionType)
{
case ConsolidationFunction::Average:
return u"AVG";
default:
return GlobalizationSettings::GetTotalName(functionType);
}
}
U16String GetGrandTotalName(ConsolidationFunction functionType) override
{
switch (functionType)
{
case ConsolidationFunction::Average:
return u"GRD AVG";
default:
return GlobalizationSettings::GetGrandTotalName(functionType);
}
}
};
Per iniettare etichette personalizzate, è necessario assegnare la proprietà WorkbookSettings.GetGlobalizationSettings() a un’istanza della classe CustomSettings definita sopra prima di aggiungere le subtotali al foglio di lavoro.
#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;
class CustomSettings : public GlobalizationSettings
{
public:
CustomSettings() {}
~CustomSettings() {}
// Override necessary methods from GlobalizationSettings
// Example: Override GetTotalName if needed
U16String GetTotalName(ConsolidationFunction functionType) override
{
// Custom implementation if needed
return GlobalizationSettings::GetTotalName(functionType);
}
};
int main()
{
Aspose::Cells::Startup();
// Source directory path
U16String srcDir(u"..\\Data\\01_SourceDirectory\\");
// Output directory path
U16String outDir(u"..\\Data\\02_OutputDirectory\\");
// Path of input excel file
U16String inputFilePath = srcDir + u"sample.xlsx";
// Path of output excel file
U16String outputFilePath = outDir + u"output_out.xlsx";
// Loads an existing spreadsheet containing some data
Workbook book(inputFilePath);
// Assigns the GlobalizationSettings property of the WorkbookSettings class to the class created in first step
CustomSettings customSettings;
book.GetSettings().SetGlobalizationSettings(&customSettings);
// Accesses the 1st worksheet from the collection which contains data resides in the cell range A2:B9
Worksheet sheet = book.GetWorksheets().Get(0);
// Adds Subtotal of type Average to the worksheet
CellArea cellArea = CellArea::CreateCellArea(u"A2", u"B9");
sheet.GetCells().Subtotal(cellArea, 0, ConsolidationFunction::Average, {1});
// Calculates Formulas
book.CalculateFormula();
// Auto fits all columns
sheet.AutoFitColumns();
// Saves the workbook on disc
book.Save(outputFilePath);
std::cout << "Workbook processed and saved successfully!" << std::endl;
Aspose::Cells::Cleanup();
}
Testo personalizzato per l’etichetta Altro del grafico a torta
#include "Aspose.Cells.h"
#include <locale>
#include <codecvt>
using namespace Aspose::Cells;
using namespace Aspose::Cells::Charts;
// Defines a custom class inherited by ChartGlobalizationSettings class
class GlobalCustomSettings : public ChartGlobalizationSettings
{
public:
// Overrides the GetOtherName method
virtual U16String GetOtherName() override
{
// Gets the culture identifier for the current system
std::locale loc("");
std::wstring_convert<std::codecvt_utf8<wchar_t>> conv;
std::string locName = loc.name();
std::wstring wlocName = conv.from_bytes(locName);
if (wlocName.find(L"en_US") != std::wstring::npos)
{
return U16String(u"Other");
}
else if (wlocName.find(L"fr_FR") != std::wstring::npos)
{
return U16String(u"Autre");
}
else if (wlocName.find(L"de_DE") != std::wstring::npos)
{
return U16String(u"Andere");
}
else
{
return ChartGlobalizationSettings::GetOtherName();
}
}
};
Il seguente snippet carica un foglio di calcolo esistente contenente un grafico a torta e visualizza il grafico come un’immagine utilizzando la classe CustomSettings creata in precedenza.
#include <iostream>
#include "Aspose.Cells.h"
using namespace Aspose::Cells;
class GlobalCustomSettings : public Aspose::Cells::Charts::ChartGlobalizationSettings
{
// Implement custom settings if needed
};
int main()
{
Aspose::Cells::Startup();
U16String srcDir(u"..\\Data\\01_SourceDirectory\\");
Workbook book(srcDir + u"sample.xlsx");
auto settings = book.GetSettings();
GlobalizationSettings* globalSettings = new GlobalizationSettings();
globalSettings->SetChartSettings(new GlobalCustomSettings());
settings.SetGlobalizationSettings(globalSettings);
Worksheet sheet = book.GetWorksheets().Get(0);
Chart chart = sheet.GetCharts().Get(0);
chart.Calculate();
ImageOrPrintOptions options;
chart.ToImage(srcDir + u"output_out.png", options);
std::cout << "Chart rendered successfully!" << std::endl;
Aspose::Cells::Cleanup();
}