Форматирование данных
Подходы к форматированию данных в ячейках
Общеизвестный факт, что если ячейки листа отформатированы правильно, то пользователям становится проще читать содержимое (данные) ячейки. Существует множество способов форматирования ячеек и их содержимого. Самый простой способ - отформатировать ячейки с помощью Microsoft Excel в среде WYSIWYG при создании дизайнерской таблицы. После создания дизайнерской таблицы вы можете открыть таблицу с помощью Aspose.Cells, сохранив все настройки формата вместе с таблицей. Другой способ отформатировать ячейки и их содержимое - использовать API Aspose.Cells. В этой теме мы опишем два подхода к форматированию ячеек и их содержимого с использованием API Aspose.Cells.
Форматирование ячеек
Разработчики могут форматировать ячейки и их содержимое с использованием гибкого API Aspose.Cells. Aspose.Cells предоставляет класс Workbook, который представляет собой файл Microsoft Excel. Класс Workbook содержит коллекцию WorksheetCollection, позволяющую получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet. Класс Worksheet предоставляет коллекцию Cells. Каждый элемент коллекции Cells представляет объект класса Cell.
Aspose.Cells предоставляет свойство Style в классе Cell, используемое для задания стиля форматирования ячейки. Кроме того, Aspose.Cells также предоставляет класс Style, который используется для того же целя. Применяйте различные виды стилей форматирования для ячеек, устанавливая их фоновые или передние цвета, границы, шрифты, горизонтальное и вертикальное выравнивание, отступ, направление текста, угол поворота и многое другое.
Использование метода setStyle
При применении различных стилей форматирования к разным ячейкам лучше использовать метод setStyle класса Cell. Ниже приведен пример использования метода setStyle для применения различных настроек форматирования к ячейке.
Использование объекта Style
При применении одного и того же стиля форматирования к разным ячейкам используйте объект Style.
- Добавьте объект Style в коллекцию Styles класса Workbook, вызвав метод createStyle класса Workbook.
- Получите только что добавленный объект Style из коллекции Styles.
- Установите желаемые свойства объекта Style, чтобы применить необходимые настройки форматирования.
- Присвойте настроенный объект Style свойству Style любой желаемой ячейки.
Этот подход может значительно повысить эффективность ваших приложений и сэкономить память.
Применение эффектов градиентного заливки
Чтобы применить желаемые эффекты градиентного заливки к ячейке, используйте метод setTwoColorGradient объекта стиля соответственно.
Пример кода
Нижеприведенный вывод достигается выполнением кода ниже.
Применение эффектов градиентного заливки
Настройка настроек выравнивания
Любой, кто использовал Microsoft Excel для форматирования ячеек, будет знаком с настройками выравнивания в Microsoft Excel.
Параметры выравнивания в Microsoft Excel
Как видно на приведенной выше фигуре, существуют различные варианты выравнивания:
- Выравнивание текста (горизонтальное и вертикальное)
- Отступ.
- Ориентация.
- Управление текстом.
- Направление текста.
Все эти настройки выравнивания полностью поддерживаются Aspose.Cells и обсуждаются более подробно ниже.
Настройка настроек выравнивания
Aspose.Cells предоставляет класс Workbook, который представляет собой файл Excel. Класс Workbook содержит коллекцию Worksheet, которая позволяет получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet.
Класс Worksheet предоставляет коллекцию Cells. Каждый элемент в коллекции Cells представляет объект класса Cell.
Aspose.Cells предоставляет метод setStyle в классе Cell, который используется для форматирования ячейки. Класс Style предоставляет полезные свойства для настройки параметров шрифта.
Выберите любой тип выравнивания текста, используя перечисление TextAlignmentType. Предопределенные типы выравнивания текста в перечислении TextAlignmentType:
| Типы выравнивания текста | Описание |
|---|---|
| Bottom | Представляет выравнивание текста по нижнему краю |
| Center | Представляет выравнивание текста по центру |
| CenterAcross | Представляет выравнивание текста по центру с наложением |
| Distributed | Представляет распределенное выравнивание текста |
| Fill | Представляет выравнивание текста по заливке |
| General | Представляет общее выравнивание текста |
| Justify | Представляет выравнивание текста по ширине |
| Left | Представляет выравнивание текста влево |
| Right | Представляет выравнивание текста вправо |
| Top | Представляет верхнее выравнивание текста |
|
Также можно применить настройку равномерного распределения с помощью метода Style.setJustifyDistributed().
|
Горизонтальное выравнивание
Используйте метод setHorizontalAlignment объекта Style, чтобы выровнять текст горизонтально.
Следующий результат достигается при выполнении приведенного ниже примера кода:
Выравнивание текста горизонтально
Вертикальное выравнивание
Используйте метод setVerticalAlignment объекта Style, чтобы выровнять текст вертикально.
Следующий результат достигается, когда VerticalAlignment установлено в центр.
Выравнивание текста вертикально
Отступ
Возможно установить уровень отступа текста в ячейке, используя метод setIndentLevel объекта Style.
Следующий вывод получается при установке уровня отступа равным 2.
Уровень отступа установлен на 2
Ориентация
Установка ориентации (поворота) текста в ячейке с помощью метода setRotationAngle объекта Style.
Следующий вывод получается при установке угла поворота равным 25.
Угол поворота установлен на 25
Управление текстом
В следующем разделе рассматривается управление текстом с помощью установки переноса текста, уменьшения для подгонки и других параметров форматирования.
Перенос текста
Перенос текста в ячейке упрощает его чтение: высота ячейки автоматически ajusts для размещения всего текста вместо его обрезания или переполнения смежными ячейками.
Установите перенос текста включенным или выключенным с помощью метода setTextWrapped объекта Style.
Следующий вывод получается при включении переноса текста.
Текст перенесен внутри ячейки
Уменьшение для подгонки
Опция переноса текста в ячейке состоит в уменьшении размера текста для соответствия размерам ячейки. Это делается путем установки свойства IsTextWrapped объекта Style в true.
Следующий вывод получается при уменьшении текста для соответствия ячейке.
Текст уменьшен для соответствия границам ячейки
Объединение ячеек
Как и Microsoft Excel, Aspose.Cells поддерживает объединение нескольких ячеек в одну.
Следующий результат достигается, если объединить три ячейки в первой строке, чтобы создать большую одиночную ячейку.
Три ячейки объединены для создания большой ячейки
Используйте метод Merge коллекции Cells для объединения ячеек. Метод Merge принимает следующие параметры:
- Первая строка, первая строка, с которой начинается объединение.
- Первая колонка, первая колонка, с которой начинается объединение.
- Количество строк, количество строк для объединения.
- Количество столбцов, количество столбцов для объединения.
Направление текста
Возможно установить порядок чтения текста в ячейках. Порядок чтения - это визуальный порядок, в котором отображаются символы, слова и т.д. Например, английский - это язык с направлением слева направо, в то время как арабский - справа налево.
Порядок чтения устанавливается с помощью свойства TextDirection объекта Style. Aspose.Cells предоставляет предопределенные типы направления текста в перечислении TextDirectionType.
| ** Типы направления текста ** | ** Описание ** |
|---|---|
| Context | Порядок чтения согласуется с языком первого введенного символа |
| LeftToRight | Порядок чтения слева направо |
| RightToLeft | Порядок чтения справа налево |
Следующий результат достигается, если направление чтения текста установлено справа налево.
Установка направления чтения текста справа налево
Форматирование выбранных символов в ячейке
Работа с настройками шрифта объяснил, как форматировать ячейки, но только как форматировать содержимое всей ячейки. Что если вы хотите отформатировать только выбранные символы?
Aspose.Cells поддерживает эту функцию. В этой теме объясняется, как использовать эту функцию.
Форматирование выбранных символов
Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит коллекцию Worksheets, которая позволяет получить доступ к каждому листу в файл Excel. Лист представлен классом Worksheet. Класс Worksheet предоставляет коллекцию Cells. Каждый элемент в коллекции Cells представляет объект класса Cell.
Класс Cell предоставляет метод characters, который принимает следующие параметры для выбора диапазона символов в ячейке:
- Индекс начала, индекс начального символа для выбора.
- Количество символов, количество выбираемых символов.
В выходном файле, в ячейке A1, слово ‘Visit’ форматируется стандартным шрифтом, но ‘Aspose!’ выделено жирным и синим.
Форматирование выбранных символов
Активация листов и установка активной ячейки или выбор диапазона ячеек на листе
Иногда вам может потребоваться активировать определенный лист, чтобы он был первым, который отображается, когда кто-то открывает файл в Microsoft Excel. Вам также может понадобиться активировать определенную ячейку таким образом, чтобы полосы прокрутки прокручивались к активной ячейке, чтобы она была четко видна. Aspose.Cells способен выполнить все вышеупомянутые задачи.
Активным листом является лист, над которым вы работаете в книге. По умолчанию имя на вкладке активного листа выделено жирным. Активная ячейка, между тем, - это выбранная ячейка, в которую вводятся данные при начале ввода. Одновременно активной ячейкой является только одна ячейка. Активная ячейка окружена тяжелой рамкой, чтобы она выделялась среди других ячеек. Aspose.Cells также позволяет выбирать диапазон ячеек на листе.
Активация листа и установка активной ячейки
Aspose.Cells предоставляет специальный API для этих задач. Например, метод WorksheetCollection.setActiveSheetIndex полезен для установки активного листа. Аналогично, метод Worksheet.setActiveCell используется для установки и получения активной ячейки на листе.
Если вы хотите, чтобы горизонтальные и вертикальные полосы прокрутки прокручивались к позиции индекса строки и столбца для обеспечения хорошего вида выбранных данных при открытии файла в Microsoft Excel, используйте свойства Worksheet.setFirstVisibleRow и Worksheet.setFirstVisibleColumn.
В следующем примере показано, как активировать лист и сделать в нем активной ячейку. Полосы прокрутки прокручиваются, чтобы сделать 2-й ряд и 2-й столбец их первым видимым рядом и столбцом.
Установить ячейку B2 в качестве активной ячейки
Выбор диапазона ячеек на листе
Aspose.Cells предоставляет метод Worksheet.selectRange(int startRow, int startColumn, int totalRows, int totalColumns, bool removeOthers). Используя последний параметр - removeOthers - true, выбор других ячеек или диапазонов ячеек на листе удаляется.
В следующем примере показано, как выбрать диапазон ячеек на активном листе.
Форматирование строк и столбцов
Форматирование строк и столбцов в таблице для создания отчета —, вероятно, наиболее широко используемая функция приложения Excel.There is an introductory phrase fragment. Consider revising. Экспоненты.Aspose.Cells API-интерфейсы также предоставляют эту функциональность через свою модель данных, путем открытия класса Style, который в основном обрабатывает все связанные с оформлением функции, такие как шрифт и его атрибуты, выравнивание текста, цвета фона/переднего плана, границы, формат отображения для чисел и литералов даты и так далее. Еще один полезный класс, который предоставляют API Aspose.Cells-это StyleFlag, который позволяет повторное использование объекта Style.
В данной статье мы постараемся объяснить, как использовать Aspose.Cells for Java API для применения форматирования к строкам и столбцам.
Форматирование строк и столбцов
Aspose.Cells предоставляет класс, Workbook, который представляет собой файл Microsoft Excel. Класс Workbook содержит коллекцию рабочих листов, что позволяет получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet. Класс Worksheet предоставляет коллекцию Cells. Коллекция Cells предоставляет коллекцию Rows.
Форматирование строки
Каждый элемент в коллекции Rows представляет объект Row. Объект Row предлагает метод applyStyle, используемый для применения форматирования к строке.
Чтобы применить одно и то же форматирование к строке, используйте объект Style:
- Добавьте объект Style к классу Workbook, вызвав его метод createStyle.
- Установите свойства объекта Style для применения параметров форматирования.
- Назначьте настроенный объект Style методу applyStyle объекта Row.
Форматирование столбца
Коллекция Cells предоставляет коллекцию столбцов. Каждый элемент в коллекции Columns представляет объект Column. Аналогично объекту Row, объект Column предлагает метод applyStyle, используемый для установки форматирования столбца. Используйте метод applyStyle объекта Column для форматирования столбца также, как и строку.
Установка формата отображения чисел и дат для строк и столбцов
Если требуется установить формат отображения чисел и дат для целой строки или столбца, то процесс примерно тот же, что и обсуждался выше, однако вместо установки параметров для текстового содержимого, вы будете устанавливать форматирование для чисел и дат с использованием Style.Number или Style.Custom. Обратите внимание, что свойство Style.Number имеет тип integer и относится к встроенным числовым и датам форматам, тогда как свойство Style.Custom имеет тип string и принимает допустимые шаблоны.