Aspose.Cells 16.11.0 的公共 API 变更。
添加的 API
支持全球化设置。
Aspose.Cells 16.11.0 已公开了 GlobalizationSettings 类以及 WorkbookSettings.GlobalizationSettings 属性，以便强制 Aspose.Cells API 使用自定义标签来进行小计。GlobalizationSettings 类具有以下方法，可以在自定义实现中重写这些方法，以为“总计”和“总计”标签提供所需的名称。
- GlobalizationSettings.getTotalName: 获取函数的总名称。
- GlobalizationSettings.getGrandTotalName: 获取函数的累计总名称。
这里是一个简单的自定义类，它扩展了 GlobalizationSettings 类，并重写了上述方法，以返回合并函数 Average 的自定义标签。
Java
public class CustomSettings extends GlobalizationSettings
{
public String getTotalName(int functionType)
{
switch (functionType)
{
case ConsolidationFunction.AVERAGE:
return "AVG";
default:
return super.getTotalName(functionType);
}
}
public String getGrandTotalName(int functionType)
{
switch (functionType)
{
case ConsolidationFunction.AVERAGE:
return "GRAND AVG";
default:
return super.getGrandTotalName(functionType);
}
}
}
以下代码段加载现有电子表格并在工作表中已有的数据上添加类型为平均值的小计。在添加小计到工作表时将调用CustomSettings类及其getTotalName和getGrandTotalName方法。
Java
//Loads an existing spreadsheet containing some data
Workbook book = new Workbook(dir + "sample.xlsx");
//Assigns the GlobalizationSettings property of the WorkbookSettings class
//to the class created in first step
book.getSettings().setGlobalizationSettings(new CustomSettings());
//Accesses the 1st worksheet from the collection which contains data
//Data resides in the cell range A2:B9
Worksheet sheet = book.getWorksheets().get(0);
//Adds SubTotal of type Average to the worksheet
sheet.getCells().subtotal(CellArea.createCellArea("A2", "B9"), 0, ConsolidationFunction.AVERAGE, new int[] { 0,1 });
//Calculates Formulas
book.calculateFormula();
//Auto fits all columns
sheet.autoFitColumns();
//Saves the workbook on disc
book.save(dir + "output.xlsx");
GlobalizationSettings类还提供getOtherName方法，用于获取饼图的’其他’标签名称。以下是GlobalizationSettings.getOtherName方法的简单用法场景。
Java
public class CustomSettings extends GlobalizationSettings
{
public String getOtherName()
{
String language = Locale.getDefault().getLanguage();
System.out.println(language);
switch (language)
{
case "en":
return "Other";
case "fr":
return "Autre";
case "de":
return "Andere";
//Do other cases
default:
return super.getOtherName();
}
}
}
以下代码片段加载了包含饼图的现有电子表格，并在利用上述创建的 CustomSettings 类的情况下将图表呈现为图像。
Java
//Loads an existing spreadsheet containing a pie chart
Workbook book = new Workbook(dir + "sample.xlsx");
//Assigns the GlobalizationSettings property of the WorkbookSettings class
//to the class created in first step
book.getSettings().setGlobalizationSettings(new CustomSettings());
//Accesses the 1st worksheet from the collection which contains pie chart
Worksheet sheet = book.getWorksheets().get(0);
//Accesses the 1st chart from the collection
Chart chart = sheet.getCharts().get(0);
//Refreshes the chart
chart.calculate();
//Renders the chart to image
chart.toImage(dir + "output.png", new ImageOrPrintOptions());
添加了CellsFactory类
Aspose.Cells 16.11.0现已公开了CellsFactory类，目前有一个方法，即createStyle。CellsFactory.createStyle方法可用于创建Style类的实例，而无需将其添加到工作簿样式池中。
CellsFactory.createStyle方法的简单使用场景。
Java
//Initializes the CellsFactory class
CellsFactory factory = new CellsFactory();
//Creates an instance of Style
Style style = factory.createStyle();
添加了Workbook.AbsolutePath属性
Aspose.Cells 16.11.0已经暴露了Workbook.AbsolutePath属性，允许获取或设置存储在workbook.xml文件中的绝对工作簿路径。此属性在仅更新外部链接时非常有用。
添加了GridHyperlinkCollection.getHyperlink方法
Aspose.Cells.GridWeb 16.11.0已公开了GridHyperlinkCollection类的getHyperlink方法，允许通过传递GridCell实例或对应于行列索引的一对整数来获取GridHyperlink的实例。
getHyperlink方法的简单使用场景
Java
//Gets the active worksheet from the collection
GridWorksheet sheet = gridWeb1.getWorkSheets().get(gridWeb1.getActiveSheetIndex());
//Accesses the GridHyperlinkCollection
GridHyperlinkCollection links = sheet.getHyperlinks();
//Gets hyperlink from cell A1
GridHyperlink link = links.getHyperlink(sheet.getCells().get("A1"));
//Gets hyperlink from cell D1
link = links.getHyperlink(0, 3);
已弃用的API
已弃用的Style构造函数
请作为替代使用cellsFactory.createStyle方法。
删除的API
删除了Cell.getConditionalStyle方法
请改用Cell.getConditionalFormattingResult方法。
删除了Cells.getMaxDataRowInColumn(int column)方法
请作为替代使用Cells.getLastDataRow(int)方法。
删除的PageSetup.Draft属性
建议改用PageSetup.PrintDraft属性。
删除的AutoFilter.FilterColumnCollection属性
请考虑使用 AutoFilter.FilterColumns 属性来实现相同的目标。
已删除 TickLabels.Rotation 属性
请改用 TickLabels.RotationAngle 属性。