Uso de la clase GlobalizationSettings para etiquetas personalizadas de subtotal y otras etiquetas en gráficos de pastel con JavaScript vía C++
Contents
[
Hide
]
Escenarios de uso posibles
Las APIs de Aspose.Cells han expuesto la clase GlobalizationSettings para tratar escenarios donde el usuario desea usar etiquetas personalizadas para subtotales en una hoja de cálculo. Además, la clase GlobalizationSettings también puede usarse para modificar la etiqueta Other en gráficos circulares al renderizar la hoja o gráfico.
Introducción a la Clase Configuración Global
La clase GlobalizationSettings ofrece actualmente los siguientes 3 métodos que pueden ser sobreescritos en una clase personalizada para obtener las etiquetas deseadas para los subtotales o para renderizar texto personalizado en la etiqueta Other de un gráfico circular.
- GlobalizationSettings.totalName(ConsolidationFunction): Obtiene el nombre total de la función.
- GlobalizationSettings.grandTotalName(ConsolidationFunction): Obtiene el nombre del total general de la función.
Etiquetas Personalizadas para Subtotales
La clase GlobalizationSettings puede usarse para personalizar las etiquetas de subtotal sobrescribiendo los métodos GlobalizationSettings.totalName(ConsolidationFunction) y GlobalizationSettings.grandTotalName(ConsolidationFunction) como se demuestra a continuación.
<!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>
Para inyectar etiquetas personalizadas, es necesario asignar la propiedad WorkbookSettings.globalizationSettings a una instancia de la clase CustomSettings definida anteriormente antes de agregar los subtotales a la hoja.
<!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 clase GlobalizationSettings solo funciona para agregar nuevos subtotales. Si una hoja ya contiene subtotales, sus etiquetas no pueden modificarse.