Cambios en la API pública en Aspose.Cells 17.1.0
APIs Añadidas
Soporte para gráficos de Excel 2016
Las APIs de Aspose.Cells han añadido soporte para algunos gráficos de Excel 2016 mediante la mejora de la enumeración ChartType. Se han añadido los siguientes nuevos campos con la versión Aspose.Cells 17.1.0.
- ChartType.BOX_WHISKER: La serie se representa como caja y bigote.
- ChartType.FUNNEL: La serie se representa como embudo.
- ChartType.PARETO_LINE: La serie se representa como líneas de Pareto.
- ChartType.SUNBURST: La serie se representa como un sunburst.
- ChartType.TREEMAP: La serie se representa como un mapa de árbol.
- ChartType.WATERFALL: La serie se representa como un gráfico de cascada.
- ChartType.HISTOGRAM: La serie se representa como un histograma.
Setter añadido para la propiedad LoadFilter.LoadDataFilterOptions
Aspose.Cells 17.1.0 ha añadido un setter para la propiedad LoadFilter.LoadDataFilterOptions para reemplazar la variable de instancia m_LoadDataFilterOptions. Los usuarios pueden cambiar la propiedad LoadDataFilterOptions en su propia implementación de la clase LoadFilter para cambiar el comportamiento de carga de archivos de plantilla.
Aquí hay un escenario de uso simple.
Java
class CustomLoadFilter extends LoadFilter {
public void startSheet(Worksheet sheet) {
if (sheet.getName().equals("NoCharts")) {
//Load everything and filter charts
this.setLoadDataFilterOptions(LoadDataFilterOptions.ALL& ~LoadDataFilterOptions.CHART);
}
if (sheet.getName().equals("NoShapes")) {
//Load everything and filter shapes
this.setLoadDataFilterOptions(LoadDataFilterOptions.ALL& ~LoadDataFilterOptions.SHAPE);
}
if (sheet.getName().equals("NoConditionalFormatting")) {
//Load everything and filter conditional formatting
this.setLoadDataFilterOptions(LoadDataFilterOptions.ALL& ~LoadDataFilterOptions.CONDITIONAL_FORMATTING);
}
}
}
Propiedad CellsHelper.SignificantDigits añadida
Aspose.Cells 17.1.0 ha expuesto la propiedad SignificantDigits de la clase CellsHelper que permite obtener o establecer el número de dígitos significativos para valores numéricos en una hoja de cálculo. El valor predeterminado de la propiedad CellsHelper.SignificantDigits es 17 y solo es aplicable si el resultado debe almacenarse en formato de archivo XLSX.
Aquí hay un escenario simple para demostrar el uso de la propiedad CellsHelper.SignificantDigits.
Java
//Specify the number of significant digits
CellsHelper.setSignificantDigits(15);
Propiedad GlowEffect.Color añadida
Aspose.Cells 17.1.0 ha agregado la propiedad GlowEffect.Color que se puede utilizar para recuperar el color del efecto de resplandor.
El siguiente fragmento hace uso de la propiedad GlowEffect.Color.
Java
//Read the source Excel file
Workbook book = new Workbook(dir + "sample.xlsx");
//Access first worksheet
Worksheet sheet = book.getWorksheets().get(0);
//Access the first shape
Shape shape = sheet.getShapes().get(0);
//Read the glow effect color
GlowEffect glow = shape.getGlow();
CellsColor color = glow.getColor();
Propiedades PageSetup.PaperWidth y PaperHeight añadidas
Aspose.Cells 17.1.0 ha expuesto las propiedades PaperWidth y PaperHeight para la clase PageSetup. Las propiedades PageSetup.PaperWidth y PageSetup.PaperHeight son de tipo double que representan el ancho y alto del papel en unidades de pulgadas considerando la orientación de la página.
Propiedad WorkbookSettings.CheckCustomNumberFormat añadida
Aspose.Cells 17.1.0 ha agregado la propiedad CheckCustomNumberFormat a la clase WorkbookSettings. CheckCustomNumberFormat es útil para verificar si la propiedad Style.Custom se ha establecido correctamente. En caso de que la propiedad Style.Custom se haya establecido incorrectamente, es decir; el valor no corresponde a un patrón válido, entonces las API de Aspose.Cells lanzarán CellsException con el mensaje apropiado.
Java
//Create an instance of Workbook
Workbook book = new Workbook();
//Set CheckCustomNumberFormat property to true
book.getSettings().setCheckCustomNumberFormat(true);
//Access first worksheet
Worksheet sheet = book.getWorksheets().get(0);
//Access a cell
Cell cell = sheet.getCells().get("B5");
//Insert a value to the cell
cell.putValue(2347);
//Access cell's style
Style style = cell.getStyle();
//Set Custom property to an invalid pattern
style.setCustom("ggg @ fff");
//Set the modified style to the cell
cell.setStyle(style);
Añadido campo DisplayUnitType.PERCENTAGE
Aspose.Cells 17.1.0 también ha expuesto el campo PERCENTAGE en la enumeración DisplayUnitType. El campo DisplayUnitType.PERCENTAGE indica que los valores en el gráfico se dividirán por 0.01.
APIs Eliminadas
Variable de instancia m_LoadDataFilterOptions removida
Esta versión ha removido la variable de instancia m_LoadDataFilterOptions. Se recomienda utilizar en su lugar la propiedad LoadFilter.LoadDataFilterOptions.