Изменения в публичном API в Aspose.Cells 8.8.1
Добавленные API
Фильтрация данных при загрузке
Aspose.Cells for Java 8.8.1 добавило перечисление LoadDataFilterOptions вместе со свойством LoadOptions.LoadDataFilterOptions, которое можно использовать для указания типа данных, который должен быть загружен при создании рабочей книги из шаблонного файла. Фильтрация загруженных данных может улучшить производительность для особых целей, особенно при использовании LightCells API.
Перечисление LoadDataFilterOptions предоставляет следующие варианты выбора.
- ALL для загрузки всего из электронной таблицы.
- NONE для загрузки ничего из электронной таблицы.
- CELL_BLANK загружает ячейки, значения которых пусты.
- CELL_BOOL загружает ячейки, значения которых являются логическими.
- CELL_DATA загружает данные ячеек, включая значения, формулы и форматирование.
- CELL_ERROR загружает ячейки, значения которых являются ошибками.
- CELL_NUMERIC загружает ячейки, значения которых являются числовыми (включая даты и время).
- CELL_STRING загружает ячейки, значения которых являются текстовыми/строковыми.
- CELL_VALUE загружает только значения ячеек (все типы).
- CHART загружает только графики.
- CONDITIONAL_FORMATTING загружает только правила условного форматирования.
- DATA_VALIDATION загружает только правила проверки данных.
- DOCUMENT_PROPERTIES загружает только свойства документа.
- FORMULA загружает формулы, включая определенные имена.
- MERGED_AREA загружает только объединенные ячейки.
- PIVOT_TABLE загружает сводные таблицы.
- SETTINGS загружает только настройки книги и листов.
- SHAPE загружает только формы.
- STYLE загружает форматирование ячеек.
- 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);
Преобразование графика в PDF напрямую
API Aspose.Cells уже предоставило возможность рендеринга графиков в PDF с помощью метода Chart.toPdf. В этом выпуске 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 для управления аспектами текста в форме. В следующем фрагменте использовано это свойство для установки эффекта тени текста в текстовом поле.
Java
//Create an instance of Workbook
Workbook book = new Workbook();
//Access first worksheet of the Workbook
Worksheet sheet = book.getWorksheets().get(0);
//Add a TextBox to the ShapeCollection
int index = sheet.getTextBoxes().add(2, 2, 100, 400);
TextBox textBox = sheet.getTextBoxes().get(index);
//Set the text of the TextBox
textBox.setText("This text has the following settings.\n\nText Effects > Shadow > Offset Bottom");
//Set shadow effect for text
for (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) имеет тип Boolean.
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 при использовании метода GridCell.removeValidation.
Устаревшие API
Устаревшее свойство Shape.TextFrame
Рекомендуется использовать свойство Shape.TextBody.TextAlignment вместо.