Настройки границ
Добавление границ в ячейки
Microsoft Excel позволяет пользователям форматировать ячейки, добавляя границы. Тип границы зависит от её расположения. Например, верхняя граница добавляется к верхней стороне ячейки. Также можно изменить стиль линии и цвет границы.
С Aspose.Cells for Node.js via C++ разработчики могут добавлять границы и настраивать их внешний вид так же гибко, как в Microsoft Excel.
Добавление границ в ячейки
Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит коллекцию worksheets, позволяющую получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet. Класс Worksheet обеспечивает коллекцию cells. Каждый элемент коллекции cells представляет объект класса Cell.
Aspose.Cells предоставляет метод getStyle в классе Cell. Метод setStyle используется для установки стиля форматирования ячейки. Класс Style предоставляет свойства для добавления границ к ячейкам.
Добавление границ к ячейке
Разработчики могут добавлять границы к ячейке, используя коллекцию borders объекта Style. Тип границы передается как индекс в коллекцию borders. Все типы границ предопределены в перечислении BorderType.
Перечисление границ
| Типы границ | Описание |
|---|---|
| BottomBorder | Линия нижней границы |
| DiagonalDown | Диагональная линия от верхнего левого до нижнего правого |
| DiagonalUp | Диагональная линия от нижнего левого до верхнего правого |
| LeftBorder | Линия левой границы |
| RightBorder | Линия правой границы |
| TopBorder | Линия верхней границы |
Коллекция borders хранит все границы. Каждая граница в коллекции borders представлена объектом Border, который обеспечивает два свойства: setColor и setLineStyle для установки цвета линии границы и стиля соответственно.
Чтобы установить цвет линии границы, выберите цвет с помощью перечисления Color (часть Node.js) и присвойте его свойству color объекта Border.
Стиль линии границы устанавливается выбором стиля линии из перечисления CellBorderType.
Перечисление типов границ ячейки
| Стили линий | Описание |
|---|---|
| DashDot | Тонкая пунктирная линия |
| DashDotDot | Тонкая штрих-пунктирная линия |
| Dashed | Пунктирная линия |
| Dotted | Точечная линия |
| Double | Двойная линия |
| Hair | Линия минимальной толщины |
| MediumDashDot | Средняя штрих-пунктирная линия |
| MediumDashDotDot | Средняя штрих-точечно-пунктирная линия |
| MediumDashed | Средняя пунктирная линия |
| None | Нет линии |
| Medium | Средняя линия |
| SlantedDashDot | Наклоненная средняя штрих-пунктирная линия |
| Thick | Толстая линия |
| Thin | Тонкая линия |
| Выберите один из стилей линий и затем присвойте его свойству lineStyle объекта Border. |
Добавление границ для диапазона ячеек
Также возможно добавлять границы к диапазону ячеек, а не только к одной ячейке. Для этого сначала создайте диапазон ячеек, вызвав метод createRange коллекции cells. Он принимает следующие параметры:
- Первая строка, первая строка диапазона.
- Первый столбец, представляет первый столбец диапазона.
- Количество строк, количество строк в диапазоне.
- Количество столбцов, количество столбцов в диапазоне.
Метод createRange возвращает объект Range, который содержит указанный диапазон ячеек. Объект Range предоставляет метод setOutlineBorder, который принимает следующие параметры для добавления границы к диапазону ячеек:
- Тип границы, тип границы, выбранный из перечисления BorderType.
- Стиль линии, стиль линии границы, выбранный из перечисления CellBorderType.
- Цвет, цвет линии, выбранный из перечисления Color.