Настройки границ
Добавление границ в ячейки
Microsoft Excel позволяет пользователям форматировать ячейки, добавляя границы. Тип границы зависит от того, куда она добавляется. Например, верхняя граница - это граница, добавленная в верхнюю часть ячейки. Пользователи также могут изменять стиль и цвет линий границ.
С помощью Aspose.Cells разработчики могут добавлять границы и настраивать их внешний вид таким же гибким способом, как в Microsoft Excel.
Добавление границ в ячейки
Aspose.Cells предоставляет класс Workbook, который представляет файл Microsoft Excel. Класс Workbook содержит коллекцию Worksheets, которая позволяет получить доступ к каждому листу в файле Excel. Лист представлен классом Worksheet. Класс Worksheet предоставляет коллекцию Cells. Каждый элемент в коллекции Cells представляет объект класса Cell.
Aspose.Cells предоставляет метод GetStyle в классе Cell. Метод SetStyle используется для установки стиля форматирования ячейки. Класс Style предоставляет свойства для добавления границ к ячейкам.
Добавление границ к ячейке
Разработчики могут добавлять границы к ячейке, используя коллекцию Style объекта Borders. Тип границы передается в качестве индекса коллекции Borders. Все типы границ предварительно определены в перечислении BorderType.
Перечисление границ
| Типы границ | Описание |
|---|---|
| BottomBorder | Линия нижней границы |
| DiagonalDown | Диагональная линия от верхнего левого до нижнего правого |
| DiagonalUp | Диагональная линия от нижнего левого до верхнего правого |
| LeftBorder | Линия левой границы |
| RightBorder | Линия правой границы |
| TopBorder | Линия верхней границы |
The Borders collection stores all borders. Each border in the Borders collection is represented by a Border object which provides two properties, Color and LineStyle to set a border’s line color and style respectively.
Установка цвета линии границы осуществляется путем выбора цвета с использованием перечисления Color (часть .NET Framework) и присваивания его свойству 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.