公共 API Aspose.Cells 8.8.1 的变化

添加的 API

过滤加载数据

Aspose.Cells for Java 8.8.1 公开了 LoadDataFilterOptions 枚举以及 LoadOptions.LoadDataFilterOptions 属性，可用于指定从模板文件构建工作簿时应加载的数据类型。过滤加载的数据可以提高特殊用途的性能，尤其是在使用 LightCells API 时。

LoadDataFilterOptions 枚举提供以下选择。

  1. ALL 从电子表格加载所有内容。
  2. NONE 从电子表格中加载任何内容。
  3. CELL_BLANK 加载值为空的单元格。
  4. CELL_BOOL 加载值为布尔值的单元格。
  5. CELL_DATA 加载单元格数据，包括值、公式和格式。
  6. CELL_ERROR 加载值错误的单元格。
  7. CELL_NUMERIC 加载值为数字（包括日期和时间）的单元格。
  8. CELL_STRING 加载值为文本/字符串的单元格。
  9. CELL_VALUE 仅加载单元格值（所有类型）。
  10. CHART 仅加载图表。
  11. CONDITIONAL_FORMATTING 仅加载条件格式规则。
  12. DATA_VALIDATION 仅加载数据验证规则。
  13. DOCUMENT_PROPERTIES 仅加载文档属性。
  14. FORMULA 加载包括已定义名称的公式。
  15. MERGED_AREA 仅加载合并的单元格。
  16. PIVOT_TABLE 加载数据透视表。
  17. 设置仅加载工作簿和工作表设置。
  18. SHAPE 仅加载形状。
  19. STYLE 加载单元格格式。
  20. TABLE 加载 Excel 表格/列表对象。

以下是简单的使用场景。

Java

 //Create an instance of LoadOptions & initialize it with type of template to be loaded

LoadOptions options = new LoadOptions(LoadFormat.XLSX);

//Set LoadDataFilterOptions to load only shapes

options.setLoadDataFilterOptions(LoadDataFilterOptions.SHAPE);

//Create an instance of Workbook from a existing spreadsheet using instance of LoadOptions

Workbook book = new Workbook(filePath, options);

直接转换 Chart 为 PDF

Aspose.Cells API 已经提供了在使用 Chart.toPdf 方法时向 PDF 呈现图表的工具。在此版本中，API 公开了上述方法的另一个重载版本，它可以接受 OutputStream 的实例，允许用户将图表的 PDF 保存在 ByteArrayOutputStream 的实例中。

以下是简单的使用场景。

Java

 //Create an instance of Workbook and load an existing spreadsheet with a chart

Workbook workbook = new Workbook(filePath);

//Access first worksheet containing a chart

Worksheet worksheet = workbook.getWorksheets().get(0);

//Access first chart from the worksheet

Chart chart = worksheet.getCharts().get(0);

//Save the chart to PDF as Stream

ByteArrayOutputStream outStream = new ByteArrayOutputStream();

chart.toPdf(outStream);

添加了 WorkbookSettings.PaperSize 属性

Aspose.Cells for Java 8.8.1 公开了 WorkbookSettings.PaperSize 属性，以便为整个电子表格设置默认打印纸张大小。 WorkbookSettings.PaperSize 属性接受来自 PaperSizeType 枚举的值，该枚举包含最广泛使用的打印纸张类型的预定义尺寸。

Java

 //Create an instance of Workbook

//Optionally load an existing spreadsheet

Workbook book = new Workbook();

//Access WorkbookSettings from the Workbook

WorkbookSettings settings = book.getSettings();

//Set the default printing paper size for the Workbook

settings.setPaperSize(PaperSizeType.PAPER_A_4);

添加了 Shape.TextBody 属性

此版本 Aspose.Cells for Java API 公开了 Shape.TextBody 以便操纵形状中文本的各个方面。下面的代码片段使用上述属性来设置 TextBox 中文本的阴影效果。

Java

//创建工作簿实例

工作簿 book = new Workbook();

//访问工作簿的第一个工作表

工作表 sheet = book.getWorksheets().get(0);

//添加一个TextBox到ShapeCollection

int index = sheet.getTextBoxes().add(2, 2, 100, 400);

TextBox textBox = sheet.getTextBoxes().get(index);

//设置TextBox的文本

textBox.setText("此文本具有以下设置。\n\n文本效果 > 阴影 > 偏移底部");

//设置文字阴影效果

对于 (int i = 0; i< textBox.getTextBody().getCount(); i++)

{

  textBox.getTextBody().get(i).getShapeFont().getFillFormat().getShadowEffect().setPresetType(PresetShadowType.OFFSET_BOTTOM);

}

添加了 Worksheet.calculateFormula(string formula, CalculationOptions opts) 方法

Aspose.Cells for Java 8.8.1 公开了 Worksheet.calculateFormula 方法的另一个重载，它提供了使用自定义选项直接计算给定公式的能力。

添加了 GridCell.createValidation 方法

Aspose.Cells.GridWeb 提供了在使用 GridCell.createValidation 方法时直接将验证规则添加到单个单元格的功能。所述方法需要2个参数。第一个是确定验证类型的 GridValidationType 类型，而第二个参数 (isRequied) 是布尔类型。

Java

 //Access first worksheet

GridWorksheet sheet = gridweb.getWorkSheets().get(0);

//Access cell B3

GridCell cell = sheet.getCells().get("B3");

//Add validation inside the GridCell

//Any value which is not between 20 and 40 will cause error in a GridCell

GridValidation val = cell.createValidation(GridValidationType.WHOLE_NUMBER, true);

val.setFormula1("=20");

val.setFormula2("=40");

val.setOperator(OperatorType.BETWEEN);

val.setShowError(true);

val.setShowInput(true);

添加了 GridCell.removeValidation 方法

Aspose.Cells.GridWeb 还提供了在使用 GridCell.removeValidation 方法时从 GridCell 中删除数据验证规则的功能。

过时的 API

废弃的 Shape.TextFrame 属性

建议改用 Shape.TextBody.TextAlignment 属性。

公共 API Aspose.Cells 8.8.0 的变化 公共 API Aspose.Cells 8.8.2 的变化