Настройки границ
Добавление границ в ячейки
Microsoft Excel позволяет пользователям форматировать ячейки, добавляя границы. Тип границы зависит от того, куда она добавляется. Например, верхняя граница - это граница, добавленная в верхнюю часть ячейки. Пользователи также могут изменять стиль и цвет линий границ.
С Aspose.Cells для Python via .NET разработчики могут добавлять границы и настраивать их внешний вид так же гибко, как в Microsoft Excel.
Добавление границ в ячейки
Aspose.Cells для Python via .NET предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит коллекцию worksheets, позволяющую получать доступ к каждому листу в файле Excel. Лист представлен классом Worksheet. Класс Worksheet предоставляет коллекцию Cells. Каждый элемент коллекции Cells представляет объект класса Cell.
Aspose.Cells для Python via .NET предоставляет метод get_style в классе Cell. Метод set_style используется для установки параметров форматирования ячейки. Класс Style предоставляет свойства для добавления границ к ячейкам.
Добавление границ к ячейке
Разработчики могут добавлять границы к ячейке, используя коллекцию Style объекта borders. Тип границы передается в качестве индекса коллекции borders. Все типы границ предварительно определены в перечислении BorderType.
Перечисление границ
| Типы границ | Описание |
|---|---|
| BOTTOM_BORDER | Линия нижней границы |
| DIAGONAL_DOWN | Диагональная линия сверху слева вниз направо |
| DIAGONAL_UP | Диагональная линия снизу слева вверх направо |
| LEFT_BORDER | Линия левой границы |
| RIGHT_BORDER | Линия правой границы |
| TOP_BORDER | Линия верхней границы |
The borders collection stores all borders. Each border in the Borders collection is represented by a Border object which provides two properties, color and line_style to set a border’s line color and style respectively.
Установка цвета линии границы осуществляется путем выбора цвета с использованием перечисления Color (часть .NET Framework) и присваивания его свойству Color объекта Border.
Стиль линии границы устанавливается путем выбора стиля линии из перечисления 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 | Тонкая линия |
| Выберите один из стилей линий и затем назначьте его для свойства объекта line_style Border. |
Добавление границ для диапазона ячеек
Также есть возможность добавить границы для диапазона ячеек, а не только для одной ячейки. Для этого сначала создайте диапазон ячеек, вызвав метод create_range коллекции Cells. Он принимает следующие параметры:
- Первая строка, первая строка диапазона.
- Первый столбец, представляет первый столбец диапазона.
- Количество строк, количество строк в диапазоне.
- Количество столбцов, количество столбцов в диапазоне.
Метод create_range возвращает объект Range, который содержит указанный диапазон ячеек. Объект Range предоставляет метод set_outline_border, который принимает следующие параметры для добавления границы к диапазону ячеек:
- Тип границы, тип границы, выбранный из перечисления BorderType.
- Стиль линии, стиль линии границы, выбранный из перечисления CellBorderType.
- Цвет, цвет линии, выбранный из перечисления Color.