Общедоступный API Изменения в Aspose.Cells 8.8.1
Добавлены API
Отфильтровать данные для загрузки
Aspose.Cells for Java 8.8.1 предоставляет перечисление LoadDataFilterOptions вместе со свойством LoadOptions.LoadDataFilterOptions, которое можно использовать для указания типа данных, которые должны быть загружены при создании книги из файла шаблона. Фильтрация загружаемых данных может повысить производительность для специальных целей, особенно при использовании API LightCells.
Перечисление 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 загружает только фигуры.
- СТИЛЬ загружает форматирование ячеек.
- 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 используется для управления аспектами текста в фигурах. В следующем фрагменте указанное свойство используется для установки эффекта тени текста в TextBox.
Java
//Создаем экземпляр Workbook
Книга рабочей книги = новая рабочая книга();
//Доступ к первому рабочему листу рабочей книги
Рабочий лист = book.getWorksheets().get(0);
// Добавляем TextBox в ShapeCollection
int index = sheet.getTextBoxes().add(2, 2, 100, 400);
TextBox textBox = лист.getTextBoxes().get(index);
//Устанавливаем текст TextBox
textBox.setText("Этот текст имеет следующие настройки.\n\nТекстовые эффекты > Тень > Смещение снизу");
//Устанавливаем эффект тени для текста
для (целое я = 0; я< textBox.getTextBody().getCount(); i++)
{
textBox.getTextBody().get(i).getShapeFont().getFillFormat().getShadowEffect().setPresetType(PresetShadowType.OFFSET_BOTTOM);
}
Добавлен метод Worksheet.calculateFormula(строковая формула, параметры CalculationOptions)
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.