Форматы ячеек

Добавление границ в ячейки

Microsoft Excel позволяет пользователям форматировать ячейки, добавляя границы.

Настройки границ в Microsoft Excel

todo:image_alt_text

Тип границы зависит от того, куда она добавлена. Например, верхняя граница - это граница, добавленная в верхнюю позицию ячейки. Пользователи также могут изменить стиль линии и цвет границ.

С помощью Aspose.Cells разработчики могут добавлять границы и настраивать их в том же гибком формате, что и в Microsoft Excel.

Добавление границ в ячейки

Aspose.Cells предоставляет класс Workbook, представляющий файл Microsoft Excel. Класс Workbook содержит коллекцию WorksheetCollection, которая позволяет получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet. Класс Worksheet содержит коллекцию Cells. Каждый элемент в коллекции Cells представляет объект класса Cell.

Aspose.Cells предоставляет метод setStyle в классе Cell, используемый для установки стилей форматирования ячейки. Также создается объект класса Style, который предоставляет свойства для настройки шрифтов.

Добавление границ к ячейке

Добавьте границы к ячейке с помощью метода setBorder объекта Style. Тип границы передается как параметр. Все типы границ предопределены в перечислении BorderType.

Типы границ	Описание
BOTTOM_BORDER	Линия нижней границы
DIAGONAL_DOWN	Диагональная линия слева сверху направо снизу
DIAGONAL_UP	Диагональная линия снизу слева вверх направо
LEFT_BORDER	Левая граница
RIGHT_BORDER	Правая граница
TOP_BORDER	Верхняя граница
HORIZONTAL	Только для динамического стиля, такого как условное форматирование.
VERTICAL	Только для динамического стиля, такого как условное форматирование.
Чтобы установить цвет линии, выберите цвет, используя перечисление Color, и передайте его в параметр setBorder метода объекта Style в качестве параметра Color. Стиль линий предопределён в перечислении CellBorderType.

Стили линий	Описание
DASH_DOT	Представляет тонкую линию точка-тире
DASH_DOT_DOT	Представляет тонкую линию тире-точка-тире
DASHED	Представляет пунктирную линию
DOTTED	Представляет пунктирную линию
DOUBLE	Представляет двойную линию
HAIR	Представляет линию волосковой толщины
MEDIUM_DASH_DOT	Представляет среднюю линию тире-точка
MEDIUM_DASH_DOT_DOT	Представляет линию средней пунктирной точечной линии
MEDIUM_DASHED	Представляет среднюю пунктирную линию
NONE	Представляет отсутствие линии
MEDIUM	Представляет среднюю линию
SLANTED_DASH_DOT	Представляет наклонную среднюю пунктирную линию
THICK	Представляет толстую линию
THIN	Представляет тонкую линию
Выберите один из вышеуказанных стилей линий и затем присвойте его объекту Style методом setBorder

Следующий вывод генерируется при выполнении приведенного ниже кода.

Границы применяются со всех сторон ячейки

todo:image_alt_text

Добавление границ для диапазона ячеек

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

Первая строка, первая строка диапазона.
Первый столбец, первый столбец диапазона.
Количество строк, количество строк в диапазоне.
Количество столбцов, количество столбцов в диапазоне.

Метод createRange возвращает объект Range, содержащий указанный диапазон. Объект Range предоставляет метод setOutlineBorders, который принимает следующие параметры:

CellBorderType, стиль линии границы, выбранный из перечисления CellBorderType.
Color, цвет линии границы, выбранный из перечисления Color.

Следующий вывод генерируется при выполнении приведенного ниже кода.

Границы применяются к диапазону ячеек

todo:image_alt_text

Цвета и палитра

Палитра - это количество цветов, доступных для использования при создании изображения. Использование стандартной палитры в презентации позволяет пользователю создавать однородный вид. Каждый файл Microsoft Excel (97-2003) имеет палитру из 56 цветов, которые могут быть применены к ячейкам, шрифтам, сеткам, графическим объектам, заливкам и линиям в диаграмме.

Настройки палитры в Microsoft Excel

todo:image_alt_text

С помощью Aspose.Cells можно не только использовать существующие цвета, но и создавать пользовательские цвета. Перед использованием пользовательского цвета добавьте его в палитру. В этой теме объясняется, как добавить пользовательские цвета в палитру.

Добавление пользовательских цветов в палитру

Aspose.Cells также поддерживает палитру из 56 цветов. Стандартная палитра цветов показана выше. Если вы хотите использовать пользовательский цвет, который не определен в палитре, вам нужно добавить этот цвет в палитру перед использованием.

Палитра вмещает только 56 цветов. Когда вы добавляете пользовательский цвет в палитру, палитра изменяется, и любой элемент в файле, отформатированный предыдущим цветом, изменяется. Поэтому, когда вы меняете палитру, будьте очень осторожны. Более того, это ограничение применимо только к формату файла XLS (Excel 97 - 2003), поскольку для форматов файлов XLSX или других более новых форматов MS Excel (2007/2010) такого ограничения нет.

Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс предоставляет метод changePalette, принимающий следующие параметры для добавления пользовательского цвета для изменения палитры:

Пользовательский цвет, пользовательский цвет, который будет добавлен в палитру.
Индекс, индекс цвета, который будет заменен пользовательским цветом. Должен быть от 0 до 55.

Приведенный ниже пример добавляет пользовательский цвет в палитру перед его применением к шрифту.

Цвета и фоновые узоры

Microsoft Excel может устанавливать передний (контур) и задний (заливка) цвета ячеек и фоновые узоры, как показано ниже.

Установка цветов и фоновых узоров в Microsoft Excel

todo:image_alt_text

Aspose.Cells также поддерживает эти функции гибким образом. В этой теме мы узнаем, как использовать эти функции с использованием Aspose.Cells.

Установка цветов и фоновых узоров

Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит WorksheetCollection, которая позволяет получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet. Класс Worksheet предоставляет коллекцию Cells. Каждый элемент в коллекции Cells представляет объект класса Cell.

Aspose.Cells предоставляет метод setStyle, используемый для установки форматирования ячейки. Также объект класса Style можно использовать для настройки шрифтов.

Чтобы установить передний или задний цвет ячейки, используйте свойства объекта Style setBackgroundColor или setForegroundColor. Эти свойства вступают в силу только в том случае, если свойство объекта Style setPattern настроено.

Свойство setForegroundColor устанавливает цвет затемнения ячейки.

Свойство setPattern указывает фоновый узор, используемый для переднего или заднего цвета. Aspose.Cells предоставляет перечисление BackgroundType, которое содержит набор предопределенных типов фоновых узоров.

Тип узора	Описание
DIAGONAL_CROSSHATCH	Представляет диагональный кросс-хэтч паттерн
DIAGONAL_STRIPE	Представляет диагональную полоску узора
GRAY_6	Представляет серый узор 6.25%
GRAY_12	Представляет серый узор 12.5%
GRAY_25	Представляет серый узор 25%
GRAY_50	Представляет серый узор 50%
GRAY_75	Представляет серый узор 75%
HORIZONTAL_STRIPE	Представляет горизонтальную полоску узора
NONE	Представляет отсутствие фона
REVERSE_DIAGONAL_STRIPE	Представляет обратную диагональную полоску узора
SOLID	Представляет сплошной узор
THICK_DIAGONAL_CROSSHATCH	Представляет толстый диагональный кросс-хэтч узор
THIN_DIAGONAL_CROSSHATCH	Представляет тонкий диагональный кросс-хэтч узор
THIN_DIAGONAL_STRIPE	Представляет тонкую диагональную полоску узора
THIN_HORIZONTAL_CROSSHATCH	Представляет тонкий горизонтальный кросс-хэтч узор
THIN_HORIZONTAL_STRIPE	Представляет тонкую горизонтальную полоску узора
THIN_REVERSE_DIAGONAL_STRIPE	Представляет тонкую обратную диагональную полоску узора
THIN_VERTICAL_STRIPE	Представляет тонкую вертикальную полоску узора
VERTICAL_STRIPE	Представляет вертикальную полоску узора
В приведенном ниже примере цвет переднего плана ячейки A1 установлен, но ячейка A2 настроена иметь как передний, так и фоновый цвета с фоновым узором вертикальных полос.

Следующий вывод генерируется при выполнении кода.

Применены цвета переднего плана и фона на ячейках с фоновыми узорами

todo:image_alt_text

Важно знать

Чтобы установить передний или задний фон ячейки, используйте свойство ForegroundColor или BackgroundColor объекта Style. Оба свойства вступят в силу только если свойство Pattern объекта Style настроено.
Свойство ForegroundColor устанавливает оттенок цвета ячейки. Свойство Pattern определяет тип используемого фонового узора для переднего или заднего цвета. Aspose.Cells предоставляет перечисление, BackgroundType, которое содержит набор предопределенных типов фоновых узоров.
Если выбрать значение BackgroundType.NONE из перечисления BackgroundType, передний цвет не применяется. Точно так же, задний цвет не применяется, если выбраны значения BackgroundType.NONE или BackgroundType.SOLID.
При извлечении заливки ячейки, если Style.Pattern равно BackgroundType.NONE, Style.ForegroundColor вернет Color.Empty.

Форматирование выбранных символов в ячейке

Working with Font Settings объясняет, как форматировать ячейки, но только как форматировать содержимое всей ячейки. Что делать, если вы хотите отформатировать только выбранные символы?

Aspose.Cells поддерживает эту функцию. В этой теме объясняется, как использовать эту функцию.

Форматирование выбранных символов

Класс Cell предоставляет метод characters, который принимает следующие параметры для выбора диапазона символов в ячейке:

Индекс начала, индекс начального символа для выбора.
Количество символов, количество выбираемых символов.

В выходном файле, в ячейке A1, слово ‘Visit’ форматируется стандартным шрифтом, но ‘Aspose!’ выделено жирным и синим.

Форматирование выбранных символов

todo:image_alt_text

Если вас интересует форматирование части текста с богатым форматированием в ячейке, используйте методы Cell.getCharacters и Cell.setCharacters. Метод Cell.getCharacters используется для доступа к фрагментам текста, а затем можно вносить изменения с помощью метода Cell.setCharacters, в то время как метод get возвращает массив объектов FontSetting, которые можно изменять для настройки различных свойств, таких как название шрифта, цвет шрифта, полужирность и т. д., а метод set используется для применения изменений.

Продвинутые темы

Формулы Расчет формул