Aspose.Cells for Java 17.02.0 Примечания к выпуску

Public API и обратно несовместимые изменения

Ниже приведен список любых изменений, внесенных в общедоступный номер API, таких как добавленные, переименованные, удаленные или устаревшие члены, а также любые несовместимые с предыдущими изменениями, внесенные в номер Aspose.Cells for Java. Если у вас есть сомнения по поводу каких-либо перечисленных изменений, сообщите об этом на форум поддержки Aspose.Cells.

Добавлено свойство HTMLLoadOptions.AutoFitColsAndRows.

В этом выпуске Aspose.Cells for Java API добавлено свойство HTMLLoadOptions.AutoFitColsAndRows, которое указывает, должен ли API автоматически подбирать столбцы и строки при импорте HTML в объектном режиме. Свойство логического типа имеет значение по умолчанию false, что означает, что высота и ширина ячеек будут импортированы как есть, однако, когда для вышеупомянутого свойства установлено значение true, API пытается настроить ширину столбцов и высоту строк в соответствии с содержимым .

Вот простой сценарий использования свойства HTMLLoadOptions.AutoFitColsAndRows.

 // Create an instance of HTMLLoadOptions

HTMLLoadOptions loadOptions = new HTMLLoadOptions();

// Set the AutoFitColsAndRows property to true

loadOptions.setAutoFitColsAndRows(true);

// Create an instance of Workbook and load HTML while passing

// the object of HTMLLoadOptions class created above

Workbook book = new Workbook(dir + "sample.htm", loadOptions);

Добавлены свойства WorkbookSettings.WarningCallback и LoadOptions.WarningCallback.

Aspose.Cells for Java 17.02.0 предоставило свойство WarningCallback классам LoadOptions и WorkbookSettings для получения или установки обратного вызова предупреждения. Разработчики должны реализовать интерфейс IWarningCallback, чтобы получать настраиваемые предупреждения в своих приложениях.

Вот простой сценарий использования свойства LoadOptions.WarningCallback для получения предупреждений, когда входная электронная таблица содержит повторяющиеся именованные диапазоны.

 public class WarningCallback implements IWarningCallback

{

	public void warning(WarningInfo warningInfo)

    {

        if (warningInfo.getWarningType() == WarningType.DUPLICATE_DEFINED_NAME)

        {

            System.out.println("Duplicate Defined Names Found as " + warningInfo.getDescription());

        }

    }

}

Вот как использовать пользовательский класс, определенный выше.

 // Create an instance of LoadOptions class

LoadOptions options = new LoadOptions();

// Set the WarningCallback property to custom class

options.setWarningCallback(new WarningCallback());

// Load a sample spreadsheet in an instance of Workbook while 

// passing the object of LoadOptions class as defined above

Workbook book = new Workbook(dir + "sample.xlsx", options);

Добавлен метод Cells.textToColumns.

Последняя версия API Aspose.Cells for Java предоставила метод Cells.textToColumns, чтобы имитироватьТекст в столбцыособенность. Excel предоставляет эту функцию изИнструменты данныхподДанныевкладка Обратите внимание, что для разделения содержимого столбца на несколько столбцов данные должны содержать определенный разделитель, например запятую (или любой другой символ), на основе которого API пытается разделить содержимое ячейки на несколько ячеек.

Вот простой сценарий использования, демонстрирующий использование недавно выставленного API.

 // Create an instance of Workbook and load a sample

Workbook book = new Workbook(dir + "sample.xlsx");

// Retrieve the cells collection of the first worksheet in the sample

Cells cells = book.getWorksheets().get(0).getCells();

// Create an instance of TxtLoadOptions

TxtLoadOptions options = new TxtLoadOptions();

// Specify the separator

options.setSeparator(',');

// Split the data in range B2:B4

cells.textToColumns(1, 1, 3, options);

Добавлен метод Workbook.getFonts

Aspose.Cells for Java 17.02.0 предоставил метод getFonts для класса Workbook. Метод Workbook.getFonts возвращает список отдельных шрифтов, используемых для форматирования содержимого ячеек данной электронной таблицы. Тип возвращаемого значения вышеупомянутого метода — массив класса typeFont.

Следующий фрагмент кода демонстрирует использование метода Workbook.getFonts.

 // Создаем экземпляр Workbook и загружаем образец

Книга рабочей книги = новая рабочая книга (каталог + "sample.xlsx");

// Получить список шрифтов, используемых в электронной таблице

Шрифт[]шрифты = book.getFonts();

// Перебираем список и записываем имя шрифта

 для (целое я = 0; я< fonts.length; i ++)

{

	Font font = fonts[i];

	System.out.println(font.getName());

}

Добавлено свойство TxtSaveOptions.TrimLeadingBlankRowAndColumn.

В этой версии Aspose.Cells for Java представлено свойство TrimLeadingBlankRowAndColumn логического типа для класса TxtSaveOptions, которое указывает, следует ли обрезать ведущие пустые строки и столбцы, как это делает Excel, при экспорте данных в форматы CSV или с разделителями табуляции. Значение по умолчанию для вышеупомянутого свойства — false. Если данные на листе не начинаются с первой ячейки, то есть: A1, приложение Excel удаляет начальные пустые строки и столбцы при экспорте данных в форматы CSV или с разделителями табуляции, однако API-интерфейсы Aspose.Cells по умолчанию сохраняют пустые строки и столбцы для одного и того же образца, чтобы сохранить местоположение данных, если экспортированные файлы CSV или файлы с разделителями табуляцией должны быть импортированы обратно с использованием API Aspose.Cells.

Вот простой сценарий использования свойства TrimLeadingBlankRowAndColumn.

 // Create an instance of Workbook and load a sample

Workbook book = new Workbook(dir + "sample.xlsx");

// Create an instance of TxtSaveOptions

TxtSaveOptions options = new TxtSaveOptions();

// Set TrimLeadingBlankRowAndColumn property to true

options.setTrimLeadingBlankRowAndColumn(true);

// Export to CSV format while removing the leading blank rows & columns

book.save(dir + "output.csv", options);

Добавлено свойство BuiltInDocumentPropertyCollection.Revision и устаревшее свойство BuiltInDocumentPropertyCollection.RevisionNumber.

Вместо этого используйте свойство BuiltInDocumentPropertyCollection.Revision.

Добавлено свойство Shape.TextShapeType.

Свойство Shape.TextShapeType получает или задает предустановленный тип текстовой фигуры из списка предопределенных типов, хранящихся в перечислении AutoShapeType.

Примеры использования

Пожалуйста, проверьте список разделов справки, добавленных в Aspose.Cells вики-документы:

1. Автоподбор столбцов и строк при загрузке HTML в книгу
2. Преобразование текста в столбцы с помощью Aspose.Cells
3. Получить список шрифтов, используемых в электронной таблице или книге
4. Получать предупреждения при загрузке файла Excel
5. Чтение и обработка диаграмм Excel 2016
6. Обрезать начальные пустые строки и столбцы при экспорте электронных таблиц в формат CSV