123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943 |
- /* ====================================================================
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You under the Apache License, Version 2.0
- (the "License"); you may not use this file except in compliance with
- the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- ==================================================================== */
-
- package org.apache.poi.ss.util;
-
- import java.util.Collections;
- import java.util.HashMap;
- import java.util.HashSet;
- import java.util.Map;
- import java.util.Map.Entry;
- import java.util.Set;
-
- import org.apache.poi.ss.SpreadsheetVersion;
- import org.apache.poi.ss.usermodel.BorderStyle;
- import org.apache.poi.ss.usermodel.Cell;
- import org.apache.poi.ss.usermodel.IndexedColors;
- import org.apache.poi.ss.usermodel.Row;
- import org.apache.poi.ss.usermodel.Sheet;
- import org.apache.poi.util.Beta;
-
- /**
- * <p>
- * A BorderPropertyTemplate is a template that can be applied to any sheet in
- * a project. It contains all the border type and color attributes needed to
- * draw all the borders for a single sheet. That template can be applied to any
- * sheet in any workbook.
- *
- * <p>
- * This class requires the full spreadsheet to be in memory so
- * {@link org.apache.poi.xssf.streaming.SXSSFWorkbook} spreadsheets may not work. The same
- * BorderPropertyTemplate can be reused on different types of workbooks, such as
- * {@link org.apache.poi.hssf.usermodel.HSSFWorkbook} and
- * {@link org.apache.poi.xssf.usermodel.XSSFWorkbook} instances.
- * Portions of the border that fall outside the max range of the
- * sheet are ignored.
- * </p>
- *
- * <p>
- * This may be merged with {@link RegionUtil} in the future.
- * </p>
- * @since 3.15 beta 2
- */
- @Beta
- public final class BorderPropertyTemplate {
-
- /**
- * Provides various extents of the properties being added to the template
- * Note that the Border BorderExtent differs from a BorderStyle. A BorderStyle
- * refers to the border around a single cell while a BorderExtent refers to
- * borders around and through an area of cells.
- * @since 3.15 beta 2
- */
- public enum BorderExtent {
- /**
- * No properties defined. This can be used to remove existing
- * properties.
- */
- NONE,
-
- /**
- * All borders, that is top, bottom, left and right, including interior
- * borders for the range. Does not include diagonals which are different
- * and not implemented here.
- */
- ALL,
-
- /**
- * All inside borders. This is top, bottom, left, and right borders, but
- * restricted to the interior borders for the range. For a range of one
- * cell, this will produce no borders.
- */
- INSIDE,
-
- /**
- * All outside borders. That is top, bottom, left and right borders that
- * bound the range only.
- */
- OUTSIDE,
-
- /**
- * This is just the top border for the range. No interior borders will
- * be produced.
- */
- TOP,
-
- /**
- * This is just the bottom border for the range. No interior borders
- * will be produced.
- */
- BOTTOM,
-
- /**
- * This is just the left border for the range, no interior borders will
- * be produced.
- */
- LEFT,
-
- /**
- * This is just the right border for the range, no interior borders will
- * be produced.
- */
- RIGHT,
-
- /**
- * This is all horizontal borders for the range, including interior and
- * outside borders.
- */
- HORIZONTAL,
-
- /**
- * This is just the interior horizontal borders for the range.
- */
- INSIDE_HORIZONTAL,
-
- /**
- * This is just the outside horizontal borders for the range.
- */
- OUTSIDE_HORIZONTAL,
-
- /**
- * This is all vertical borders for the range, including interior and
- * outside borders.
- */
- VERTICAL,
-
- /**
- * This is just the interior vertical borders for the range.
- */
- INSIDE_VERTICAL,
-
- /**
- * This is just the outside vertical borders for the range.
- */
- OUTSIDE_VERTICAL
- }
-
- /**
- * A set of the border color property names
- */
- private static final Set<String> BORDER_COLOR_PROPERTY_NAMES;
- static {
- Set<String> properties = new HashSet<String>();
- properties.add(CellUtil.TOP_BORDER_COLOR);
- properties.add(CellUtil.BOTTOM_BORDER_COLOR);
- properties.add(CellUtil.LEFT_BORDER_COLOR);
- properties.add(CellUtil.RIGHT_BORDER_COLOR);
- BORDER_COLOR_PROPERTY_NAMES = Collections.unmodifiableSet(properties);
- }
-
- /**
- * A set of the border direction property names
- */
- private static final Set<String> BORDER_DIRECTION_PROPERTY_NAMES;
- static {
- Set<String> properties = new HashSet<String>();
- properties.add(CellUtil.BORDER_TOP);
- properties.add(CellUtil.BORDER_BOTTOM);
- properties.add(CellUtil.BORDER_LEFT);
- properties.add(CellUtil.BORDER_RIGHT);
- BORDER_DIRECTION_PROPERTY_NAMES = Collections.unmodifiableSet(properties);
- }
-
- // this must be greater than or equal to the workbooks used in #applyBorders
- private static final SpreadsheetVersion _ss = SpreadsheetVersion.EXCEL2007;
-
- /**
- * This is a list of cell properties for one shot application to a range of
- * cells at a later time.
- *
- * Data types:
- * _propertyTemplate as {A1: property map}
- * property map as {property key : property value}
- * property key as String as (border direction as CellUtil.BORDER_*) or (border color as CellUtil.*_BORDER_COLOR)
- * property value as (border line style as BorderStyle) or (color as short)
- */
- private final Map<CellAddress, Map<String, Object>> _propertyTemplate;
-
- /**
- * Create a new Border Property Template to stage border formatting changes to a spreadsheet
- * @since 3.15 beta 2
- */
- public BorderPropertyTemplate() {
- _propertyTemplate = new HashMap<CellAddress, Map<String, Object>>();
- }
-
- /**
- * Copy constructor
- *
- * Create a template from an existing template.
- * Changes made to either template do not affect the other template.
- * @since 3.15 beta 2
- */
- public BorderPropertyTemplate(BorderPropertyTemplate prototype) {
- this();
- // deep copy the _propertyTemplate map from prototype
- for (Entry<CellAddress, Map<String, Object>> other : prototype._propertyTemplate.entrySet()) {
- CellAddress cell = other.getKey();
- Map<String, Object> otherMap = other.getValue();
-
- // The keys in otherMap are immutable Strings
- // The values in otherMap are immutable Shorts or BorderStyles
- // Therefore, this map's data cannot be modified through protoype
- Map<String, Object> map = new HashMap<String, Object>(otherMap);
-
- // CellAddress is an immutable class, therefore it is ok to reference the same instance
- _propertyTemplate.put(cell, map);
- }
- }
-
- /**
- * Add a group of cell borders for a cell range to the border property template.
- * The borders are not applied to the cells at this time, just the template is drawn
- * (<code>drawBorders</code> stages changes using the border property template).
- * To apply the drawn borders to a sheet, use {@link #applyBorders}.
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- * @param extent BorderExtent of the borders to be applied.
- * @since 3.15 beta 2
- */
- public void drawBorders(CellRangeAddress range, BorderStyle borderType, BorderExtent extent) {
- switch (extent) {
- case NONE:
- removeBorders(range);
- break;
- case ALL:
- drawHorizontalBorders(range, borderType, BorderExtent.ALL);
- drawVerticalBorders(range, borderType, BorderExtent.ALL);
- break;
- case INSIDE:
- drawHorizontalBorders(range, borderType, BorderExtent.INSIDE);
- drawVerticalBorders(range, borderType, BorderExtent.INSIDE);
- break;
- case OUTSIDE:
- drawOutsideBorders(range, borderType, BorderExtent.ALL);
- break;
- case TOP:
- drawTopBorder(range, borderType);
- break;
- case BOTTOM:
- drawBottomBorder(range, borderType);
- break;
- case LEFT:
- drawLeftBorder(range, borderType);
- break;
- case RIGHT:
- drawRightBorder(range, borderType);
- break;
- case HORIZONTAL:
- drawHorizontalBorders(range, borderType, BorderExtent.ALL);
- break;
- case INSIDE_HORIZONTAL:
- drawHorizontalBorders(range, borderType, BorderExtent.INSIDE);
- break;
- case OUTSIDE_HORIZONTAL:
- drawOutsideBorders(range, borderType, BorderExtent.HORIZONTAL);
- break;
- case VERTICAL:
- drawVerticalBorders(range, borderType, BorderExtent.ALL);
- break;
- case INSIDE_VERTICAL:
- drawVerticalBorders(range, borderType, BorderExtent.INSIDE);
- break;
- case OUTSIDE_VERTICAL:
- drawOutsideBorders(range, borderType, BorderExtent.VERTICAL);
- break;
- }
- }
-
- /**
- * Add a group of cell borders and colors for a cell range to the border property template.
- * The borders are not applied to the cells at this time, just the template is drawn
- * (<code>drawBorders</code> stages changes using the border property template).
- * To apply the drawn borders to a sheet, use {@link #applyBorders}.
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- * @param extent BorderExtent of the borders to be applied.
- * @since 3.15 beta 2
- */
- public void drawColoredBorders(CellRangeAddress range, BorderStyle borderType, short color, BorderExtent extent) {
- drawBorders(range, borderType, extent);
- if (borderType != BorderStyle.NONE) {
- drawBorderColors(range, color, extent);
- }
- }
-
- /**
- * <p>
- * Draws the top border for a range of cells
- * </p>
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- */
- private void drawTopBorder(CellRangeAddress range, BorderStyle borderType) {
- int row = range.getFirstRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- boolean addBottom = (borderType == BorderStyle.NONE && row > 0);
- for (int i = firstCol; i <= lastCol; i++) {
- addProperty(row, i, CellUtil.BORDER_TOP, borderType);
- if (addBottom) {
- addProperty(row - 1, i, CellUtil.BORDER_BOTTOM, borderType);
- }
- }
- }
-
- /**
- * <p>
- * Draws the bottom border for a range of cells
- * </p>
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- */
- private void drawBottomBorder(CellRangeAddress range, BorderStyle borderType) {
- int row = range.getLastRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- boolean addTop = (borderType == BorderStyle.NONE && row < _ss.getLastRowIndex());
- for (int i = firstCol; i <= lastCol; i++) {
- addProperty(row, i, CellUtil.BORDER_BOTTOM, borderType);
- if (addTop) {
- addProperty(row + 1, i, CellUtil.BORDER_TOP, borderType);
- }
- }
- }
-
- /**
- * <p>
- * Draws the left border for a range of cells
- * </p>
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- */
- private void drawLeftBorder(CellRangeAddress range, BorderStyle borderType) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int col = range.getFirstColumn();
- boolean addRight = (borderType == BorderStyle.NONE && col > 0);
- for (int i = firstRow; i <= lastRow; i++) {
- addProperty(i, col, CellUtil.BORDER_LEFT, borderType);
- if (addRight) {
- addProperty(i, col - 1, CellUtil.BORDER_RIGHT, borderType);
- }
- }
- }
-
- /**
- * <p>
- * Draws the right border for a range of cells
- * </p>
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- */
- private void drawRightBorder(CellRangeAddress range, BorderStyle borderType) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int col = range.getLastColumn();
- boolean addLeft = (borderType == BorderStyle.NONE && col < _ss.getLastColumnIndex());
- for (int i = firstRow; i <= lastRow; i++) {
- addProperty(i, col, CellUtil.BORDER_RIGHT, borderType);
- if (addLeft) {
- addProperty(i, col + 1, CellUtil.BORDER_LEFT, borderType);
- }
- }
- }
-
- /**
- * <p>
- * Draws the outside borders for a range of cells.
- * </p>
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- * @param extent BorderExtent of the borders to be applied. Valid Values are:
- * <ul>
- * <li>Extent.ALL</li>
- * <li>Extent.HORIZONTAL</li>
- * <li>Extent.VERTICAL</li>
- * </ul>
- */
- private void drawOutsideBorders(CellRangeAddress range, BorderStyle borderType, BorderExtent extent) {
- switch (extent) {
- case ALL:
- drawTopBorder(range, borderType);
- drawBottomBorder(range, borderType);
- drawLeftBorder(range, borderType);
- drawRightBorder(range, borderType);
- break;
- case HORIZONTAL:
- drawTopBorder(range, borderType);
- drawBottomBorder(range, borderType);
- break;
- case VERTICAL:
- drawLeftBorder(range, borderType);
- drawRightBorder(range, borderType);
- break;
- default:
- throw new IllegalArgumentException(
- "Illegal BorderExtent. Allowed: ALL, HORIZONTAL, and VERTICAL");
- }
- }
-
- /**
- * <p>
- * Draws the horizontal borders for a range of cells.
- * </p>
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- * @param extent BorderExtent of the borders to be applied. Valid Values are:
- * <ul>
- * <li>Extent.ALL</li>
- * <li>Extent.INSIDE</li>
- * </ul>
- */
- private void drawHorizontalBorders(CellRangeAddress range, BorderStyle borderType, BorderExtent extent) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- switch (extent) {
- case ALL:
- for (int i = firstRow; i <= lastRow; i++) {
- CellRangeAddress row = new CellRangeAddress(i, i, firstCol, lastCol);
- drawTopBorder(row, borderType);
- drawBottomBorder(row, borderType);
- }
- break;
- case INSIDE:
- for (int i = firstRow; i <= lastRow; i++) {
- CellRangeAddress row = new CellRangeAddress(i, i, firstCol, lastCol);
- if (i > firstRow) drawTopBorder(row, borderType);
- if (i < lastRow) drawBottomBorder(row, borderType);
- }
- break;
- default:
- throw new IllegalArgumentException("Illegal BorderExtent. Allowed: ALL and INSIDE");
- }
- }
-
- /**
- * <p>
- * Draws the vertical borders for a range of cells.
- * </p>
- *
- * @param range range of cells on which borders are drawn.
- * @param borderType Type of border to draw.
- * @param extent BorderExtent of the borders to be applied. Valid Values are:
- * <ul>
- * <li>Extent.ALL</li>
- * <li>Extent.INSIDE</li>
- * </ul>
- */
- private void drawVerticalBorders(CellRangeAddress range, BorderStyle borderType, BorderExtent extent) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- switch (extent) {
- case ALL:
- for (int i = firstCol; i <= lastCol; i++) {
- CellRangeAddress row = new CellRangeAddress(firstRow, lastRow, i, i);
- drawLeftBorder(row, borderType);
- drawRightBorder(row, borderType);
- }
- break;
- case INSIDE:
- for (int i = firstCol; i <= lastCol; i++) {
- CellRangeAddress row = new CellRangeAddress(firstRow, lastRow, i, i);
- if (i > firstCol) drawLeftBorder(row, borderType);
- if (i < lastCol) drawRightBorder(row, borderType);
- }
- break;
- default:
- throw new IllegalArgumentException("Illegal BorderExtent. Allowed: ALL and INSIDE");
- }
- }
-
- /**
- * Removes all border properties from this BorderPropertyTemplate for the
- * specified range.
- *
- * @param range - range of cells to remove borders.
- */
- private void removeBorders(CellRangeAddress range) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- for (int row = firstRow; row <= lastRow; row++) {
- for (int col = firstCol; col <= lastCol; col++) {
- CellAddress cell = new CellAddress(row, col);
- removeProperties(cell, BORDER_DIRECTION_PROPERTY_NAMES);
- }
- }
- removeBorderColors(range);
- }
-
- /**
- * Applies the drawn borders to a Sheet. The borders that are applied are
- * the ones that have been drawn by {@link #drawColoredBorders}, {@link #drawBorders} and
- * {@link #drawBorderColors}.
- * The same border property template can be applied to multiple sheets
- * from the same or different workbooks.
- *
- * If the border property template contains cell addresses outside the valid range
- * of <code>sheet</code>, borders for those cell addresses are quietly ignored and
- * not applied to <code>sheet</code>.
- *
- * @param sheet Sheet on which to apply borders
- * @since 3.15 beta 2
- */
- public void applyBorders(Sheet sheet) {
- SpreadsheetVersion ss = sheet.getWorkbook().getSpreadsheetVersion();
- int lastValidRow = ss.getLastRowIndex();
- int lastValidCol = ss.getLastColumnIndex();
- for (Entry<CellAddress, Map<String, Object>> entry : _propertyTemplate.entrySet()) {
- CellAddress cellAddress = entry.getKey();
- int r = cellAddress.getRow();
- int c = cellAddress.getColumn();
- if (r <= lastValidRow && c <= lastValidCol) {
- Row row = CellUtil.getRow(r, sheet);
- Cell cell = CellUtil.getCell(row, c);
- Map<String, Object> properties = entry.getValue();
- CellUtil.setCellStyleProperties(cell, properties);
- }
- }
- }
-
- /**
- * Sets the color for a group of cell borders for a cell range to the border property template.
- * The borders are not applied to the cells at this time, just the template is drawn
- * (<code>drawBorders</code> stages changes using the border property template).
- * If the borders do not exist, a {@link BorderStyle#THIN} border is used.
- * To apply the drawn borders to a sheet, use {@link #applyBorders}.
- *
- * @param range range of cells on which colors are set.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- * @param extent BorderExtent of the borders for which colors are set.
- * @since 3.15 beta 2
- */
- public void drawBorderColors(CellRangeAddress range, short color, BorderExtent extent) {
- switch (extent) {
- case NONE:
- removeBorderColors(range);
- break;
- case ALL:
- drawHorizontalBorderColors(range, color, BorderExtent.ALL);
- drawVerticalBorderColors(range, color, BorderExtent.ALL);
- break;
- case INSIDE:
- drawHorizontalBorderColors(range, color, BorderExtent.INSIDE);
- drawVerticalBorderColors(range, color, BorderExtent.INSIDE);
- break;
- case OUTSIDE:
- drawOutsideBorderColors(range, color, BorderExtent.ALL);
- break;
- case TOP:
- drawTopBorderColor(range, color);
- break;
- case BOTTOM:
- drawBottomBorderColor(range, color);
- break;
- case LEFT:
- drawLeftBorderColor(range, color);
- break;
- case RIGHT:
- drawRightBorderColor(range, color);
- break;
- case HORIZONTAL:
- drawHorizontalBorderColors(range, color, BorderExtent.ALL);
- break;
- case INSIDE_HORIZONTAL:
- drawHorizontalBorderColors(range, color, BorderExtent.INSIDE);
- break;
- case OUTSIDE_HORIZONTAL:
- drawOutsideBorderColors(range, color, BorderExtent.HORIZONTAL);
- break;
- case VERTICAL:
- drawVerticalBorderColors(range, color, BorderExtent.ALL);
- break;
- case INSIDE_VERTICAL:
- drawVerticalBorderColors(range, color, BorderExtent.INSIDE);
- break;
- case OUTSIDE_VERTICAL:
- drawOutsideBorderColors(range, color, BorderExtent.VERTICAL);
- break;
- }
- }
-
- /**
- * <p>
- * Sets the color of the top border for a range of cells.
- * </p>
- *
- * @param range range of cells on which colors are set.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- */
- private void drawTopBorderColor(CellRangeAddress range, short color) {
- int row = range.getFirstRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- for (int i = firstCol; i <= lastCol; i++) {
- CellAddress cell = new CellAddress(row, i);
- // if BORDER_TOP is not set on BorderPropertyTemplate, make a thin border so that there's something to color
- if (borderIsNotSet(cell, CellUtil.BORDER_TOP)) {
- drawTopBorder(new CellRangeAddress(row, row, i, i), BorderStyle.THIN);
- }
- addProperty(cell, CellUtil.TOP_BORDER_COLOR, color);
- }
- }
-
- /**
- * <p>
- * Sets the color of the bottom border for a range of cells.
- * </p>
- *
- * @param range range of cells on which colors are set.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- */
- private void drawBottomBorderColor(CellRangeAddress range, short color) {
- int row = range.getLastRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- for (int i = firstCol; i <= lastCol; i++) {
- CellAddress cell = new CellAddress(row, i);
- // if BORDER_BOTTOM is not set on BorderPropertyTemplate, make a thin border so that there's something to color
- if (borderIsNotSet(cell, CellUtil.BORDER_BOTTOM)) {
- drawBottomBorder(new CellRangeAddress(row, row, i, i), BorderStyle.THIN);
- }
- addProperty(cell, CellUtil.BOTTOM_BORDER_COLOR, color);
- }
- }
-
- /**
- * <p>
- * Sets the color of the left border for a range of cells.
- * </p>
- *
- * @param range range of cells on which colors are set.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- */
- private void drawLeftBorderColor(CellRangeAddress range, short color) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int col = range.getFirstColumn();
- for (int i = firstRow; i <= lastRow; i++) {
- CellAddress cell = new CellAddress(i, col);
- // if BORDER_LEFT is not set on BorderPropertyTemplate, make a thin border so that there's something to color
- if (borderIsNotSet(cell, CellUtil.BORDER_LEFT)) {
- drawLeftBorder(new CellRangeAddress(i, i, col, col), BorderStyle.THIN);
- }
- addProperty(cell, CellUtil.LEFT_BORDER_COLOR, color);
- }
- }
-
- /**
- * A helper method to set the border line style before setting the color if the
- * current line style is not set.
- */
- private boolean borderIsNotSet(CellAddress cell, String borderDirection) {
- Object borderLineStyle = getTemplateProperty(cell, borderDirection);
- return (borderLineStyle == null);
- }
-
- /**
- * <p>
- * Sets the color of the right border for a range of cells. If the border is
- * not drawn, it defaults to {@link BorderStyle#THIN}
- * </p>
- *
- * @param range range of cells on which colors are set.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- */
- private void drawRightBorderColor(CellRangeAddress range, short color) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int col = range.getLastColumn();
- for (int i = firstRow; i <= lastRow; i++) {
- CellAddress cell = new CellAddress(i, col);
- // if BORDER_RIGHT is not set on BorderPropertyTemplate, make a thin border so that there's something to color
- if (borderIsNotSet(cell, CellUtil.BORDER_RIGHT)) {
- drawRightBorder(new CellRangeAddress(i, i, col, col), BorderStyle.THIN);
- }
- addProperty(cell, CellUtil.RIGHT_BORDER_COLOR, color);
- }
- }
-
- /**
- * <p>
- * Sets the color of the outside borders for a range of cells.
- * </p>
- *
- * @param range range of cells on which colors are set.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- * @param extent BorderExtent of the borders for which colors are set. Valid Values are:
- * <ul>
- * <li>Extent.ALL</li>
- * <li>Extent.HORIZONTAL</li>
- * <li>Extent.VERTICAL</li>
- * </ul>
- */
- private void drawOutsideBorderColors(CellRangeAddress range, short color, BorderExtent extent) {
- switch (extent) {
- case ALL:
- drawTopBorderColor(range, color);
- drawBottomBorderColor(range, color);
- drawLeftBorderColor(range, color);
- drawRightBorderColor(range, color);
- break;
- case HORIZONTAL:
- drawTopBorderColor(range, color);
- drawBottomBorderColor(range, color);
- break;
- case VERTICAL:
- drawLeftBorderColor(range, color);
- drawRightBorderColor(range, color);
- break;
- default:
- throw new IllegalArgumentException(
- "Illegal BorderExtent. Allowed: ALL, HORIZONTAL, and VERTICAL");
- }
- }
-
- /**
- * <p>
- * Sets the color of the horizontal borders for a range of cells.
- * </p>
- *
- * @param range range of cells on which colors are set.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- * @param extent BorderExtent of the borders for which colors are set. Valid Values are:
- * <ul>
- * <li>Extent.ALL</li>
- * <li>Extent.INSIDE</li>
- * </ul>
- */
- private void drawHorizontalBorderColors(CellRangeAddress range, short color, BorderExtent extent) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- switch (extent) {
- case ALL:
- for (int i = firstRow; i <= lastRow; i++) {
- CellRangeAddress row = new CellRangeAddress(i, i, firstCol, lastCol);
- drawTopBorderColor(row, color);
- drawBottomBorderColor(row, color);
- }
- break;
- case INSIDE:
- for (int i = firstRow; i <= lastRow; i++) {
- CellRangeAddress row = new CellRangeAddress(i, i, firstCol, lastCol);
- if (i > firstRow) drawTopBorderColor(row, color);
- if (i < lastRow) drawBottomBorderColor(row, color);
- }
- break;
- default:
- throw new IllegalArgumentException("Illegal BorderExtent. Allowed: ALL and INSIDE");
- }
- }
-
- /**
- * <p>
- * Sets the color of the vertical borders for a range of cells.
- * </p>
- *
- * @param range range of cells on which colors are set.
- * @param color Color index from {@link IndexedColors} used to draw the borders.
- * @param extent BorderExtent of the borders for which colors are set. Valid Values are:
- * <ul>
- * <li>Extent.ALL</li>
- * <li>Extent.INSIDE</li>
- * </ul>
- */
- private void drawVerticalBorderColors(CellRangeAddress range, short color, BorderExtent extent) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int firstCol = range.getFirstColumn();
- int lastCol = range.getLastColumn();
- switch (extent) {
- case ALL:
- for (int i = firstCol; i <= lastCol; i++) {
- CellRangeAddress row = new CellRangeAddress(firstRow, lastRow, i, i);
- drawLeftBorderColor(row, color);
- drawRightBorderColor(row, color);
- }
- break;
- case INSIDE:
- for (int i = firstCol; i <= lastCol; i++) {
- CellRangeAddress row = new CellRangeAddress(firstRow, lastRow, i, i);
- if (i > firstCol) drawLeftBorderColor(row, color);
- if (i < lastCol) drawRightBorderColor(row, color);
- }
- break;
- default:
- throw new IllegalArgumentException("Illegal BorderExtent. Allowed: ALL and INSIDE");
- }
- }
-
- /**
- * Removes all border properties from this BorderPropertyTemplate for the
- * specified range.
- *
- * @param range - range of cells to remove borders.
- */
- private void removeBorderColors(CellRangeAddress range) {
- int firstRow = range.getFirstRow();
- int lastRow = range.getLastRow();
- int firstColumn = range.getFirstColumn();
- int lastColumn = range.getLastColumn();
- for (int row = firstRow; row <= lastRow; row++) {
- for (int col = firstColumn; col <= lastColumn; col++) {
- CellAddress cell = new CellAddress(row, col);
- removeProperties(cell, BORDER_COLOR_PROPERTY_NAMES);
- }
- }
- }
-
- /**
- * Adds a property to this BorderPropertyTemplate for a given cell
- *
- * @param cell The cell to add the property to in the property template.
- * @param property The property key to add to the property template.
- * @param value The property value to add to the property template.
- */
- private void addProperty(CellAddress cell, String property, Object value) {
- Map<String, Object> cellProperties = _propertyTemplate.get(cell);
- if (cellProperties == null) {
- cellProperties = new HashMap<String, Object>();
- }
- cellProperties.put(property, value);
- _propertyTemplate.put(cell, cellProperties);
- }
- /**
- * Adds a property to this BorderPropertyTemplate for a given cell
- *
- * @param row The row number of the cell to add the property to
- * @param col
- * @param property The property key to add to the property template.
- * @param value The property value to add to the property template.
- */
- private void addProperty(int row, int col, String property, Object value) {
- CellAddress cell = new CellAddress(row, col);
- addProperty(cell, property, value);
- }
-
- /**
- * Removes a set of properties from this BorderPropertyTemplate for a
- * given cell
- *
- * @param row the row index of the cell to remove properties from
- * @param col the column index of the cell to remove properties from
- * @param properties a list of the property names to remove from the cell
- */
- private void removeProperties(CellAddress cell, Set<String> properties) {
- Map<String, Object> cellProperties = _propertyTemplate.get(cell);
- if (cellProperties != null) {
- cellProperties.keySet().removeAll(properties);
- if (cellProperties.isEmpty()) {
- _propertyTemplate.remove(cell);
- } else {
- _propertyTemplate.put(cell, cellProperties);
- }
- }
- }
-
- /**
- * Retrieves the number of borders assigned to a cell (a value between 0 and 4)
- *
- * @param cell the cell to count the number of borders on
- * @since 3.15 beta 2
- */
- public int getNumBorders(CellAddress cell) {
- Map<String, Object> cellProperties = _propertyTemplate.get(cell);
- if (cellProperties == null) {
- return 0;
- }
-
- int count = 0;
- if (cellProperties.containsKey(CellUtil.BORDER_TOP)) count++;
- if (cellProperties.containsKey(CellUtil.BORDER_LEFT)) count++;
- if (cellProperties.containsKey(CellUtil.BORDER_RIGHT)) count++;
- if (cellProperties.containsKey(CellUtil.BORDER_BOTTOM)) count++;
- return count;
- }
-
- /**
- * Retrieves the number of border colors assigned to a cell
- *
- * @param cell
- * @since 3.15 beta 2
- */
- public int getNumBorderColors(CellAddress cell) {
- Map<String, Object> cellProperties = _propertyTemplate.get(cell);
- if (cellProperties == null) {
- return 0;
- }
-
- int count = 0;
- if (cellProperties.containsKey(CellUtil.TOP_BORDER_COLOR)) count++;
- if (cellProperties.containsKey(CellUtil.LEFT_BORDER_COLOR)) count++;
- if (cellProperties.containsKey(CellUtil.RIGHT_BORDER_COLOR)) count++;
- if (cellProperties.containsKey(CellUtil.BOTTOM_BORDER_COLOR)) count++;
- return count;
- }
-
- /**
- * Retrieves the border style for a given cell
- *
- * @param cell The cell to get a template property from.
- * @param property The template property to get from the BorderPropertyTemplate. Example: {@link CellUtil#BORDER_TOP}.
- * @return The stored template property. If property has not be set on the BorderPropertyTemplate, returns <code>null</code>.
- * @since 3.15 beta 2
- */
- public Object getTemplateProperty(CellAddress cell, String property) {
- Map<String, Object> cellProperties = _propertyTemplate.get(cell);
- if (cellProperties != null) {
- return cellProperties.get(property);
- }
- return null;
- }
- }
|