Utilisation de la classe GlobalizationSettings pour des étiquettes personnalisées de sous total et autres étiquettes de graphique circulaire avec JavaScript via C++
Contents
[
Hide
]
Scénarios d’utilisation possibles
Les API Aspose.Cells ont exposé la classe GlobalizationSettings afin de gérer les scénarios où l’utilisateur souhaite utiliser des étiquettes personnalisées pour les sous-totaux dans une feuille de calcul. De plus, la classe GlobalizationSettings peut également être utilisée pour modifier l’étiquette Autre pour le graphique à secteurs lors du rendu de la feuille de calcul ou du graphique.
Introduction à la classe GlobalizationSettings
La classe GlobalizationSettings offre actuellement les 3 méthodes suivantes qui peuvent être surchargées dans une classe personnalisée pour obtenir les étiquettes souhaitées pour les sous-totaux ou pour rendre un texte personnalisé pour l’étiquette Autre d’un graphique à secteurs.
- GlobalizationSettings.totalName(ConsolidationFunction) : Obtient le nom total de la fonction.
- GlobalizationSettings.grandTotalName(ConsolidationFunction) : Obtient le nom du total général de la fonction.
Étiquettes personnalisées pour les sous-totaux
La classe GlobalizationSettings peut être utilisée pour personnaliser les étiquettes de sous-totaux en surchargeant les méthodes GlobalizationSettings.totalName(ConsolidationFunction) & GlobalizationSettings.grandTotalName(ConsolidationFunction) comme démontré ci-après.
<!DOCTYPE html>
<html>
<head>
<title>Aspose.Cells Custom GlobalizationSettings Example</title>
</head>
<body>
<h1>Custom GlobalizationSettings Example</h1>
<input type="file" id="fileInput" accept=".xls,.xlsx,.csv" />
<button id="runExample">Run Example</button>
<a id="downloadLink" style="display: none;">Download Result</a>
<div id="result"></div>
</body>
<script src="aspose.cells.js.min.js"></script>
<script type="text/javascript">
const { Workbook, SaveFormat } = AsposeCells;
AsposeCells.onReady({
license: "/lic/aspose.cells.enc",
fontPath: "/fonts/",
fontList: [
"arial.ttf",
"NotoSansSC-Regular.ttf"
]
}).then(() => {
console.log("Aspose.Cells initialized");
});
// Defines a custom class derived from GlobalizationSettings class
class CustomSettings extends AsposeCells.GlobalizationSettings {
// Overrides the totalName method (converted from getTotalName)
totalName(functionType) {
switch (functionType) {
case AsposeCells.ConsolidationFunction.Average:
return "AVG";
default:
return super.totalName(functionType);
}
}
// Overrides the grandTotalName method (converted from getGrandTotalName)
grandTotalName(functionType) {
switch (functionType) {
case AsposeCells.ConsolidationFunction.Average:
return "GRD AVG";
default:
return super.grandTotalName(functionType);
}
}
}
document.getElementById('runExample').addEventListener('click', async () => {
const fileInput = document.getElementById('fileInput');
const resultDiv = document.getElementById('result');
if (!fileInput.files.length) {
resultDiv.innerHTML = '<p style="color: red;">Please select an Excel file.</p>';
return;
}
// Read the selected file and process with Aspose.Cells
const file = fileInput.files[0];
const arrayBuffer = await file.arrayBuffer();
// Instantiate a Workbook object from the file bytes
const workbook = new Workbook(new Uint8Array(arrayBuffer));
// Create and assign the custom globalization settings to the workbook
const customSettings = new CustomSettings();
workbook.globalizationSettings = customSettings;
// Save the workbook and provide a download link
const outputData = workbook.save(SaveFormat.Xlsx);
const blob = new Blob([outputData]);
const downloadLink = document.getElementById('downloadLink');
downloadLink.href = URL.createObjectURL(blob);
downloadLink.download = 'output.xlsx';
downloadLink.style.display = 'block';
downloadLink.textContent = 'Download Modified Excel File';
resultDiv.innerHTML = '<p style="color: green;">Custom globalization settings applied. Click the download link to get the modified file.</p>';
});
</script>
</html>
Pour injecter des étiquettes personnalisées, il est nécessaire d’assigner la propriété WorkbookSettings.globalizationSettings à une instance de la classe CustomSettings définie ci-dessus avant d’ajouter les sous-totaux à la feuille de calcul.
<!DOCTYPE html>
<html>
<head>
<title>Aspose.Cells Example</title>
</head>
<body>
<h1>Aspose.Cells Subtotal with Custom Globalization Settings</h1>
<input type="file" id="fileInput" accept=".xls,.xlsx,.csv" />
<button id="runExample">Run Example</button>
<a id="downloadLink" style="display: none;">Download Result</a>
<div id="result"></div>
</body>
<script src="aspose.cells.js.min.js"></script>
<script type="text/javascript">
const { Workbook, SaveFormat } = AsposeCells;
AsposeCells.onReady({
license: "/lic/aspose.cells.enc",
fontPath: "/fonts/",
fontList: [
"arial.ttf",
"NotoSansSC-Regular.ttf"
]
}).then(() => {
console.log("Aspose.Cells initialized");
});
// Defines a custom class derived from GlobalizationSettings class
class CustomSettings extends AsposeCells.GlobalizationSettings {
// Overrides the TotalName method (converted from getTotalName)
totalName(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 AsposeCells.ConsolidationFunction.Average:
return "AVG";
// Handle other cases as per requirement
default:
return super.totalName(functionType);
}
}
// Overrides the GrandTotalName method (converted from getGrandTotalName)
grandTotalName(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 AsposeCells.ConsolidationFunction.Average:
return "GRD AVG";
// Handle other cases as per requirement
default:
return super.grandTotalName(functionType);
}
}
}
document.getElementById('runExample').addEventListener('click', async () => {
const fileInput = document.getElementById('fileInput');
if (!fileInput.files.length) {
document.getElementById('result').innerHTML = '<p style="color: red;">Please select an Excel file.</p>';
return;
}
const file = fileInput.files[0];
const arrayBuffer = await file.arrayBuffer();
// Instantiating a Workbook object from uploaded file
const workbook = new Workbook(new Uint8Array(arrayBuffer));
// Assigns the GlobalizationSettings property of the WorkbookSettings class to a custom class created
workbook.settings.globalizationSettings = new CustomSettings();
// Accesses the 1st worksheet from the collection which contains data that resides in the cell range A2:B9
const sheet = workbook.worksheets.get(0);
// Adds Subtotal of type Average to the worksheet
sheet.cells.subtotal(AsposeCells.CellArea.createCellArea("A2", "B9"), 0, AsposeCells.ConsolidationFunction.Average, [1]);
// Calculates Formulas
workbook.calculateFormula();
// Auto fits all columns
sheet.autoFitColumns();
// Saving the workbook and preparing download link
const outputData = workbook.save(SaveFormat.Xlsx);
const blob = new Blob([outputData]);
const downloadLink = document.getElementById('downloadLink');
downloadLink.href = URL.createObjectURL(blob);
downloadLink.download = 'output_out.xlsx';
downloadLink.style.display = 'block';
downloadLink.textContent = 'Download Modified Excel File';
document.getElementById('result').innerHTML = '<p style="color: green;">Operation completed successfully! Click the download link to get the modified file.</p>';
});
</script>
</html>
La classe GlobalizationSettings fonctionne uniquement pour l’ajout de nouveaux sous-totaux. Si une feuille de calcul contient déjà des sous-totaux, leurs étiquettes ne peuvent pas être modifiées.