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

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

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.