Автоподбор высоты и ширины строк и столбцов

Microsoft Excel предоставляет хорошую возможность автоматического изменения ширины и высоты ячейки в соответствии с её содержимым. Эта возможность также доступна пользователям Aspose.Cells с возможностью автоматического изменения размеров ячейки во время выполнения.

Автоматическая подгонка размера

Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит коллекцию Worksheets, позволяющую получать доступ к каждому листу в файле Excel.

Лист представлен классом Worksheet. Класс Worksheet предоставляет множество свойств и методов для управления листом. В этой статье рассматривается использование класса Worksheet для автоподбора высоты строк или ширины столбцов.

Автоматическая подгонка строки - простой

Самый простой способ автоматически подогнать ширину и высоту строки — вызвать метод Worksheet.autoFitRow. Он принимает индекс строки, которую нужно изменить.

Автоподбор высоты строки в диапазоне ячеек

Строка состоит из множества столбцов. Aspose.Cells позволяет автоматического подогнать строку по содержимому диапазона ячеек внутри строки, вызвав перегруженную версию метода autoFitRow. Этот метод принимает параметры:

• Индекс строки, индекс строки, которую нужно автоматически подогнать.
• Индекс первого столбца, индекс первого столбца строки.
• Индекс последнего столбца, индекс последнего столбца строки.

Метод autoFitRow проверяет содержимое всех столбцов строки и автоматически настраивает высоту строки.

Автоподгонка столбца - Простая

Самый простой способ автоматически подогнать ширину и высоту столбца — вызвать метод Worksheet.autoFitColumn. Он принимает индекс столбца, который нужно изменить.

Автоподгонка столбца в диапазоне ячеек

Столбец состоит из множества строк. Можно автоматически подогнать ширину столбца на основе содержимого диапазона ячеек этого столбца, вызвав перегруженную версию метода autoFitColumn, которая принимает параметры:

• Индекс столбца, представляет индекс столбца, содержимое которого должно быть автоматически подогнано
• Индекс первой строки, представляет индекс первой строки столбца
• Индекс последней строки, представляет индекс последней строки столбца

Метод autoFitColumn проверяет содержимое всех строк в столбце и автоматически подгоняет ширину.

AutoFit строк для объединенных ячеек

С помощью Aspose.Cells можно автоматически подогнать строки даже для объединенных ячеек, используя API AutoFitterOptions. Класс AutoFitterOptions предоставляет свойство AutoFitMergedCellsType, которое можно использовать для автоматической подгонки строк для объединенных ячеек. AutoFitMergedCellsType принимает перечисление AutoFitMergedCellsType со следующими элементами:

• НИКАКОЙ: Игнорирует объединенные ячейки.
• FIRST_LINE: расширяет высоту только первой строки.
• LAST_LINE: расширяет высоту только последней строки.
• КАЖДАЯ_СТРОКА: Только увеличивает высоту каждой строки.

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

Сигнатуры вышеперечисленных методов следующие:

1. autoFitRows(int startRow, int endRow, AutoFitterOptions options)
2. autoFitColumns(int firstColumn, int lastColumn, AutoFitterOptions options)

Важно знать

Если ячейка объединена, то методы AutoFit не применяются, что соответствует поведению в Microsoft Excel. Более того, если текст в ячейке обернут, метод autoFitColumn также не будет применен. Еще одно важное замечание — методы AutoFit занимают много времени, поэтому их следует вызывать как можно реже для повышения эффективности вашего приложения.