diff options
author | PJ Fanning <fanningpj@apache.org> | 2017-06-30 11:48:23 +0000 |
---|---|---|
committer | PJ Fanning <fanningpj@apache.org> | 2017-06-30 11:48:23 +0000 |
commit | 95d9bec68b77d759b57fa8e0c57b5600ce8a1d18 (patch) | |
tree | e297c02c2179de9630ef53669735dc4305be9852 /src/java/org/apache/poi | |
parent | 2b1cc78d86308b56f09cfe6d6132ca54d726e3e6 (diff) | |
download | poi-95d9bec68b77d759b57fa8e0c57b5600ce8a1d18.tar.gz poi-95d9bec68b77d759b57fa8e0c57b5600ce8a1d18.zip |
Remove more deprecated code (especially from Spreadsheet Cell classes)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1800375 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'src/java/org/apache/poi')
-rw-r--r-- | src/java/org/apache/poi/common/usermodel/Hyperlink.java | 32 | ||||
-rw-r--r-- | src/java/org/apache/poi/hssf/model/HSSFFormulaParser.java | 29 | ||||
-rw-r--r-- | src/java/org/apache/poi/hssf/usermodel/HSSFCellStyle.java | 207 | ||||
-rw-r--r-- | src/java/org/apache/poi/hssf/util/HSSFCellUtil.java | 169 | ||||
-rw-r--r-- | src/java/org/apache/poi/hssf/util/HSSFRegionUtil.java | 18 | ||||
-rw-r--r-- | src/java/org/apache/poi/ss/usermodel/CellStyle.java | 476 | ||||
-rw-r--r-- | src/java/org/apache/poi/ss/usermodel/Workbook.java | 2 | ||||
-rw-r--r-- | src/java/org/apache/poi/ss/util/CellUtil.java | 58 | ||||
-rw-r--r-- | src/java/org/apache/poi/ss/util/RegionUtil.java | 113 |
9 files changed, 19 insertions, 1085 deletions
diff --git a/src/java/org/apache/poi/common/usermodel/Hyperlink.java b/src/java/org/apache/poi/common/usermodel/Hyperlink.java index abcdd112a6..648227b152 100644 --- a/src/java/org/apache/poi/common/usermodel/Hyperlink.java +++ b/src/java/org/apache/poi/common/usermodel/Hyperlink.java @@ -22,38 +22,6 @@ import org.apache.poi.util.Removal; * Represents a hyperlink. */ public interface Hyperlink { - /** - * Link to an existing file or web page - * - * @deprecated POI 3.15 beta 3. Use {@link HyperlinkType#URL} instead. - */ - @Removal(version="3.17") - public static final int LINK_URL = 1; // HyperlinkType.URL.getCode() - - /** - * Link to a place in this document - * - * @deprecated POI 3.15 beta 3. Use {@link HyperlinkType#DOCUMENT} instead. - */ - @Removal(version="3.17") - public static final int LINK_DOCUMENT = 2; // HyperlinkType.DOCUMENT.getCode() - - /** - * Link to an E-mail address - * - * @deprecated POI 3.15 beta 3. Use {@link HyperlinkType#EMAIL} instead. - */ - @Removal(version="3.17") - public static final int LINK_EMAIL = 3; // HyperlinkType.EMAIL.getCode() - - /** - * Link to an file - * - * @deprecated POI 3.15 beta 3. Use {@link HyperlinkType#FILE} instead. - */ - @Removal(version="3.17") - public static final int LINK_FILE = 4; // HyperlinkType.FILE.getCode() - /** * Hyperlink address. Depending on the hyperlink type it can be URL, e-mail, path to a file, etc. diff --git a/src/java/org/apache/poi/hssf/model/HSSFFormulaParser.java b/src/java/org/apache/poi/hssf/model/HSSFFormulaParser.java index 774eb788f3..e2ed227155 100644 --- a/src/java/org/apache/poi/hssf/model/HSSFFormulaParser.java +++ b/src/java/org/apache/poi/hssf/model/HSSFFormulaParser.java @@ -54,19 +54,6 @@ public final class HSSFFormulaParser { } /** - * @param formula The formula to parse, excluding the leading equals sign - * @param workbook The parent workbook - * @param formulaType a constant from {@link FormulaType} - * @return the parsed formula tokens - * @throws FormulaParseException if the formula has incorrect syntax or is otherwise invalid - * - * @deprecated POI 3.15 beta 3. Use {@link #parse(String, HSSFWorkbook, FormulaType)} instead. - */ - @Removal(version="3.17") - public static Ptg[] parse(String formula, HSSFWorkbook workbook, int formulaType) throws FormulaParseException { - return parse(formula, workbook, FormulaType.forInt(formulaType)); - } - /** * @param formula The formula to parse, excluding the leading equals sign * @param workbook The parent workbook * @param formulaType The type of formula @@ -78,22 +65,6 @@ public final class HSSFFormulaParser { } /** - * @param formula the formula to parse - * @param workbook the parent workbook - * @param formulaType a constant from {@link FormulaType} - * @param sheetIndex the 0-based index of the sheet this formula belongs to. - * The sheet index is required to resolve sheet-level names. <code>-1</code> means that - * the scope of the name will be ignored and the parser will match named ranges only by name - * - * @return the parsed formula tokens - * @throws FormulaParseException if the formula has incorrect syntax or is otherwise invalid - * @deprecated POI 3.15 beta 3. Use {@link #parse(String, HSSFWorkbook, FormulaType, int)} instead. - */ - @Removal(version="3.17") - public static Ptg[] parse(String formula, HSSFWorkbook workbook, int formulaType, int sheetIndex) throws FormulaParseException { - return parse(formula, workbook, FormulaType.forInt(formulaType), sheetIndex); - } - /** * @param formula The formula to parse * @param workbook The parent workbook * @param formulaType The type of formula diff --git a/src/java/org/apache/poi/hssf/usermodel/HSSFCellStyle.java b/src/java/org/apache/poi/hssf/usermodel/HSSFCellStyle.java index 2bbc18cd17..03f444751a 100644 --- a/src/java/org/apache/poi/hssf/usermodel/HSSFCellStyle.java +++ b/src/java/org/apache/poi/hssf/usermodel/HSSFCellStyle.java @@ -33,7 +33,6 @@ import org.apache.poi.ss.usermodel.FillPatternType; import org.apache.poi.ss.usermodel.Font; import org.apache.poi.ss.usermodel.HorizontalAlignment; import org.apache.poi.ss.usermodel.VerticalAlignment; -import org.apache.poi.util.Removal; /** * High level representation of the style of a cell in a sheet of a workbook. @@ -168,7 +167,7 @@ public final class HSSFCellStyle implements CellStyle { /** * set the font for this style - * @param font a font object created or retreived from the HSSFWorkbook object + * @param font a font object created or retrieved from the HSSFWorkbook object * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#createFont() * @see org.apache.poi.hssf.usermodel.HSSFWorkbook#getFontAt(short) */ @@ -265,26 +264,6 @@ public final class HSSFCellStyle implements CellStyle { /** * set the type of horizontal alignment for the cell * @param align - the type of alignment - * @see #ALIGN_GENERAL - * @see #ALIGN_LEFT - * @see #ALIGN_CENTER - * @see #ALIGN_RIGHT - * @see #ALIGN_FILL - * @see #ALIGN_JUSTIFY - * @see #ALIGN_CENTER_SELECTION - * @deprecated POI 3.15 beta 3. Use {@link #setAlignment(HorizontalAlignment)} instead. - */ - @Deprecated - @Removal(version="3.17") - @Override - public void setAlignment(short align) - { - _format.setIndentNotParentAlignment(true); - _format.setAlignment(align); - } - /** - * set the type of horizontal alignment for the cell - * @param align - the type of alignment */ @Override public void setAlignment(HorizontalAlignment align) @@ -296,13 +275,6 @@ public final class HSSFCellStyle implements CellStyle { /** * get the type of horizontal alignment for the cell * @return align - the type of alignment - * @see #ALIGN_GENERAL - * @see #ALIGN_LEFT - * @see #ALIGN_CENTER - * @see #ALIGN_RIGHT - * @see #ALIGN_FILL - * @see #ALIGN_JUSTIFY - * @see #ALIGN_CENTER_SELECTION * @deprecated POI 3.15 beta 3. Use {@link #getAlignmentEnum()} instead. */ @Deprecated @@ -345,23 +317,6 @@ public final class HSSFCellStyle implements CellStyle { /** * set the type of vertical alignment for the cell * @param align the type of alignment - * @see #VERTICAL_TOP - * @see #VERTICAL_CENTER - * @see #VERTICAL_BOTTOM - * @see #VERTICAL_JUSTIFY - * @see VerticalAlignment - * @deprecated POI 3.15 beta 3. Use {@link #setVerticalAlignment(VerticalAlignment)} instead. - */ - @Deprecated - @Removal(version="3.17") - @Override - public void setVerticalAlignment(short align) - { - _format.setVerticalAlignment(align); - } - /** - * set the type of vertical alignment for the cell - * @param align the type of alignment */ @Override public void setVerticalAlignment(VerticalAlignment align) @@ -372,10 +327,6 @@ public final class HSSFCellStyle implements CellStyle { /** * get the type of vertical alignment for the cell * @return align the type of alignment - * @see #VERTICAL_TOP - * @see #VERTICAL_CENTER - * @see #VERTICAL_BOTTOM - * @see #VERTICAL_JUSTIFY * @see VerticalAlignment * @deprecated POI 3.15 beta 3. Use {@link #getVerticalAlignmentEnum()} instead. */ @@ -465,33 +416,6 @@ public final class HSSFCellStyle implements CellStyle { { return _format.getIndent(); } - - /** - * set the type of border to use for the left border of the cell - * @param border type - * @see #BORDER_NONE - * @see #BORDER_THIN - * @see #BORDER_MEDIUM - * @see #BORDER_DASHED - * @see #BORDER_DOTTED - * @see #BORDER_THICK - * @see #BORDER_DOUBLE - * @see #BORDER_HAIR - * @see #BORDER_MEDIUM_DASHED - * @see #BORDER_DASH_DOT - * @see #BORDER_MEDIUM_DASH_DOT - * @see #BORDER_DASH_DOT_DOT - * @see #BORDER_MEDIUM_DASH_DOT_DOT - * @see #BORDER_SLANTED_DASH_DOT - * @deprecated 3.15 beta 2. Use {@link HSSFCellStyle#setBorderLeft(BorderStyle)} instead. - */ - @Deprecated - @Removal(version="3.17") - @Override - public void setBorderLeft(short border) { - _format.setIndentNotParentBorder(true); - _format.setBorderLeft(border); - } /** * set the type of border to use for the left border of the cell @@ -501,7 +425,8 @@ public final class HSSFCellStyle implements CellStyle { @Override public void setBorderLeft(BorderStyle border) { - setBorderLeft(border.getCode()); + _format.setIndentNotParentBorder(true); + _format.setBorderLeft(border.getCode()); } /** @@ -525,34 +450,6 @@ public final class HSSFCellStyle implements CellStyle { { return BorderStyle.valueOf(_format.getBorderLeft()); } - - /** - * set the type of border to use for the right border of the cell - * @param border type - * @see #BORDER_NONE - * @see #BORDER_THIN - * @see #BORDER_MEDIUM - * @see #BORDER_DASHED - * @see #BORDER_DOTTED - * @see #BORDER_THICK - * @see #BORDER_DOUBLE - * @see #BORDER_HAIR - * @see #BORDER_MEDIUM_DASHED - * @see #BORDER_DASH_DOT - * @see #BORDER_MEDIUM_DASH_DOT - * @see #BORDER_DASH_DOT_DOT - * @see #BORDER_MEDIUM_DASH_DOT_DOT - * @see #BORDER_SLANTED_DASH_DOT - * @deprecated 3.15 beta 2. Use {@link HSSFCellStyle#setBorderRight(BorderStyle)} instead. - */ - @Deprecated - @Removal(version="3.17") - @Override - public void setBorderRight(short border) - { - _format.setIndentNotParentBorder(true); - _format.setBorderRight(border); - } /** * set the type of border to use for the right border of the cell @@ -562,7 +459,8 @@ public final class HSSFCellStyle implements CellStyle { @Override public void setBorderRight(BorderStyle border) { - setBorderRight(border.getCode()); + _format.setIndentNotParentBorder(true); + _format.setBorderRight(border.getCode()); } /** @@ -586,34 +484,6 @@ public final class HSSFCellStyle implements CellStyle { { return BorderStyle.valueOf(_format.getBorderRight()); } - - /** - * set the type of border to use for the top border of the cell - * @param border type - * @see #BORDER_NONE - * @see #BORDER_THIN - * @see #BORDER_MEDIUM - * @see #BORDER_DASHED - * @see #BORDER_DOTTED - * @see #BORDER_THICK - * @see #BORDER_DOUBLE - * @see #BORDER_HAIR - * @see #BORDER_MEDIUM_DASHED - * @see #BORDER_DASH_DOT - * @see #BORDER_MEDIUM_DASH_DOT - * @see #BORDER_DASH_DOT_DOT - * @see #BORDER_MEDIUM_DASH_DOT_DOT - * @see #BORDER_SLANTED_DASH_DOT - * @deprecated 3.15 beta 2. Use {@link HSSFCellStyle#setBorderTop(BorderStyle)} instead. - */ - @Deprecated - @Removal(version="3.17") - @Override - public void setBorderTop(short border) - { - _format.setIndentNotParentBorder(true); - _format.setBorderTop(border); - } /** * set the type of border to use for the top border of the cell @@ -623,7 +493,8 @@ public final class HSSFCellStyle implements CellStyle { @Override public void setBorderTop(BorderStyle border) { - setBorderTop(border.getCode()); + _format.setIndentNotParentBorder(true); + _format.setBorderTop(border.getCode()); } /** @@ -647,34 +518,6 @@ public final class HSSFCellStyle implements CellStyle { { return BorderStyle.valueOf(_format.getBorderTop()); } - - /** - * set the type of border to use for the bottom border of the cell - * @param border type - * @see #BORDER_NONE - * @see #BORDER_THIN - * @see #BORDER_MEDIUM - * @see #BORDER_DASHED - * @see #BORDER_DOTTED - * @see #BORDER_THICK - * @see #BORDER_DOUBLE - * @see #BORDER_HAIR - * @see #BORDER_MEDIUM_DASHED - * @see #BORDER_DASH_DOT - * @see #BORDER_MEDIUM_DASH_DOT - * @see #BORDER_DASH_DOT_DOT - * @see #BORDER_MEDIUM_DASH_DOT_DOT - * @see #BORDER_SLANTED_DASH_DOT - * @deprecated 3.15 beta 2. Use {@link HSSFCellStyle#setBorderBottom(BorderStyle)} instead. - */ - @Deprecated - @Removal(version="3.17") - @Override - public void setBorderBottom(short border) - { - _format.setIndentNotParentBorder(true); - _format.setBorderBottom(border); - } /** * set the type of border to use for the bottom border of the cell @@ -684,7 +527,8 @@ public final class HSSFCellStyle implements CellStyle { @Override public void setBorderBottom(BorderStyle border) { - setBorderBottom(border.getCode()); + _format.setIndentNotParentBorder(true); + _format.setBorderBottom(border.getCode()); } /** @@ -792,39 +636,6 @@ public final class HSSFCellStyle implements CellStyle { { return _format.getBottomBorderPaletteIdx(); } - - /** - * setting to one fills the cell with the foreground color... No idea about - * other values - * - * @see #NO_FILL - * @see #SOLID_FOREGROUND - * @see #FINE_DOTS - * @see #ALT_BARS - * @see #SPARSE_DOTS - * @see #THICK_HORZ_BANDS - * @see #THICK_VERT_BANDS - * @see #THICK_BACKWARD_DIAG - * @see #THICK_FORWARD_DIAG - * @see #BIG_SPOTS - * @see #BRICKS - * @see #THIN_HORZ_BANDS - * @see #THIN_VERT_BANDS - * @see #THIN_BACKWARD_DIAG - * @see #THIN_FORWARD_DIAG - * @see #SQUARES - * @see #DIAMONDS - * - * @param fp fill pattern (set to 1 to fill w/foreground color) - * @deprecated POI 3.15 beta 3. Use {@link #setFillPattern(FillPatternType)} instead. - */ - @Deprecated - @Removal(version="3.17") - @Override - public void setFillPattern(short fp) - { - setFillPattern(FillPatternType.forInt(fp)); - } /** * setting to one fills the cell with the foreground color... No idea about diff --git a/src/java/org/apache/poi/hssf/util/HSSFCellUtil.java b/src/java/org/apache/poi/hssf/util/HSSFCellUtil.java deleted file mode 100644 index ae46a5a2e8..0000000000 --- a/src/java/org/apache/poi/hssf/util/HSSFCellUtil.java +++ /dev/null @@ -1,169 +0,0 @@ -/* ==================================================================== - 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.hssf.util; - -import org.apache.poi.hssf.usermodel.HSSFCell; -import org.apache.poi.hssf.usermodel.HSSFCellStyle; -import org.apache.poi.hssf.usermodel.HSSFFont; -import org.apache.poi.hssf.usermodel.HSSFRow; -import org.apache.poi.hssf.usermodel.HSSFSheet; -import org.apache.poi.hssf.usermodel.HSSFWorkbook; -import org.apache.poi.ss.usermodel.HorizontalAlignment; -import org.apache.poi.ss.util.CellUtil; -import org.apache.poi.util.Removal; - -/** - * Various utility functions that make working with a cells and rows easier. The various - * methods that deal with style's allow you to create your HSSFCellStyles as you need them. - * When you apply a style change to a cell, the code will attempt to see if a style already - * exists that meets your needs. If not, then it will create a new style. This is to prevent - * creating too many styles. there is an upper limit in Excel on the number of styles that - * can be supported. - * - * @deprecated 3.15 beta2. Use {@link org.apache.poi.ss.util.CellUtil} instead. - */ -@Deprecated -@Removal(version="3.17") -public final class HSSFCellUtil { - - private HSSFCellUtil() { - // no instances of this class - } - - /** - * Get a row from the spreadsheet, and create it if it doesn't exist. - * - * @param rowIndex The 0 based row number - * @param sheet The sheet that the row is part of. - * @return The row indicated by the rowCounter - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#getRow} instead. - */ - public static HSSFRow getRow(int rowIndex, HSSFSheet sheet) { - return (HSSFRow) CellUtil.getRow(rowIndex, sheet); - } - - /** - * Get a specific cell from a row. If the cell doesn't exist, - * then create it. - * - * @param row The row that the cell is part of - * @param columnIndex The column index that the cell is in. - * @return The cell indicated by the column. - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#getCell} instead. - */ - public static HSSFCell getCell(HSSFRow row, int columnIndex) { - return (HSSFCell) CellUtil.getCell(row, columnIndex); - } - - /** - * Creates a cell, gives it a value, and applies a style if provided - * - * @param row the row to create the cell in - * @param column the column index to create the cell in - * @param value The value of the cell - * @param style If the style is not null, then set - * @return A new HSSFCell - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#createCell} instead. - */ - public static HSSFCell createCell(HSSFRow row, int column, String value, HSSFCellStyle style) { - return (HSSFCell) CellUtil.createCell(row, column, value, style); - } - - /** - * Create a cell, and give it a value. - * - * @param row the row to create the cell in - * @param column the column index to create the cell in - * @param value The value of the cell - * @return A new HSSFCell. - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#createCell} instead. - */ - public static HSSFCell createCell(HSSFRow row, int column, String value) { - return createCell( row, column, value, null ); - } - - /** - * Take a cell, and align it. - * - * @param cell the cell to set the alignment for - * @param workbook The workbook that is being worked with. - * @param align the column alignment to use. - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#setAlignment} instead. - * - * @see HSSFCellStyle for alignment options - */ - public static void setAlignment(HSSFCell cell, HSSFWorkbook workbook, short align) { - setAlignment(cell, HorizontalAlignment.forInt(align)); - } - /** - * Take a cell, and align it. - * - * @param cell the cell to set the alignment for - * @param align the column alignment to use. - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#setAlignment} instead. - * - * @see HSSFCellStyle for alignment options - */ - public static void setAlignment(HSSFCell cell, HorizontalAlignment align) { - CellUtil.setAlignment(cell, align); - } - - /** - * Take a cell, and apply a font to it - * - * @param cell the cell to set the alignment for - * @param workbook The workbook that is being worked with. - * @param font The HSSFFont that you want to set. - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#setFont} instead. - */ - public static void setFont(HSSFCell cell, HSSFWorkbook workbook, HSSFFont font) { - CellUtil.setFont(cell, font); - } - - /** - * This method attempt to find an already existing HSSFCellStyle that matches - * what you want the style to be. If it does not find the style, then it - * creates a new one. If it does create a new one, then it applies the - * propertyName and propertyValue to the style. This is necessary because - * Excel has an upper limit on the number of Styles that it supports. - * - * @param workbook The workbook that is being worked with. - * @param propertyName The name of the property that is to be changed. - * @param propertyValue The value of the property that is to be changed. - * @param cell The cell that needs it's style changes - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#setCellStyleProperty} instead. - */ - public static void setCellStyleProperty(HSSFCell cell, HSSFWorkbook workbook, - String propertyName, Object propertyValue) { - CellUtil.setCellStyleProperty(cell, propertyName, propertyValue); - } - - /** - * Looks for text in the cell that should be unicode, like α and provides the - * unicode version of it. - * - * @param cell The cell to check for unicode values - * @return translated to unicode (the cell is modified in-place and returned) - * - * @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#translateUnicodeValues} instead. - */ - public static HSSFCell translateUnicodeValues(HSSFCell cell){ - CellUtil.translateUnicodeValues(cell); - return cell; - } -} diff --git a/src/java/org/apache/poi/hssf/util/HSSFRegionUtil.java b/src/java/org/apache/poi/hssf/util/HSSFRegionUtil.java index 826875a749..514c841fc4 100644 --- a/src/java/org/apache/poi/hssf/util/HSSFRegionUtil.java +++ b/src/java/org/apache/poi/hssf/util/HSSFRegionUtil.java @@ -19,8 +19,8 @@ package org.apache.poi.hssf.util; import org.apache.poi.hssf.usermodel.HSSFSheet; import org.apache.poi.hssf.usermodel.HSSFWorkbook; -import org.apache.poi.ss.util.RegionUtil; import org.apache.poi.ss.util.CellRangeAddress; +import org.apache.poi.ss.util.RegionUtil; /** * Various utility functions that make working with a region of cells easier. @@ -42,7 +42,7 @@ public final class HSSFRegionUtil { */ public static void setBorderLeft(int border, CellRangeAddress region, HSSFSheet sheet, HSSFWorkbook workbook) { - RegionUtil.setBorderLeft(border, region, sheet, workbook); + RegionUtil.setBorderLeft(border, region, sheet); } /** @@ -55,7 +55,7 @@ public final class HSSFRegionUtil { */ public static void setLeftBorderColor(int color, CellRangeAddress region, HSSFSheet sheet, HSSFWorkbook workbook) { - RegionUtil.setLeftBorderColor(color, region, sheet, workbook); + RegionUtil.setLeftBorderColor(color, region, sheet); } /** @@ -68,7 +68,7 @@ public final class HSSFRegionUtil { */ public static void setBorderRight(int border, CellRangeAddress region, HSSFSheet sheet, HSSFWorkbook workbook) { - RegionUtil.setBorderRight(border, region, sheet, workbook); + RegionUtil.setBorderRight(border, region, sheet); } /** @@ -81,7 +81,7 @@ public final class HSSFRegionUtil { */ public static void setRightBorderColor(int color, CellRangeAddress region, HSSFSheet sheet, HSSFWorkbook workbook) { - RegionUtil.setRightBorderColor(color, region, sheet, workbook); + RegionUtil.setRightBorderColor(color, region, sheet); } /** @@ -94,7 +94,7 @@ public final class HSSFRegionUtil { */ public static void setBorderBottom(int border, CellRangeAddress region, HSSFSheet sheet, HSSFWorkbook workbook) { - RegionUtil.setBorderBottom(border, region, sheet, workbook); + RegionUtil.setBorderBottom(border, region, sheet); } /** @@ -107,7 +107,7 @@ public final class HSSFRegionUtil { */ public static void setBottomBorderColor(int color, CellRangeAddress region, HSSFSheet sheet, HSSFWorkbook workbook) { - RegionUtil.setBottomBorderColor(color, region, sheet, workbook); + RegionUtil.setBottomBorderColor(color, region, sheet); } /** @@ -120,7 +120,7 @@ public final class HSSFRegionUtil { */ public static void setBorderTop(int border, CellRangeAddress region, HSSFSheet sheet, HSSFWorkbook workbook) { - RegionUtil.setBorderTop(border, region, sheet, workbook); + RegionUtil.setBorderTop(border, region, sheet); } /** @@ -133,6 +133,6 @@ public final class HSSFRegionUtil { */ public static void setTopBorderColor(int color, CellRangeAddress region, HSSFSheet sheet, HSSFWorkbook workbook) { - RegionUtil.setTopBorderColor(color, region, sheet, workbook); + RegionUtil.setTopBorderColor(color, region, sheet); } } diff --git a/src/java/org/apache/poi/ss/usermodel/CellStyle.java b/src/java/org/apache/poi/ss/usermodel/CellStyle.java index 80ce6e8c97..565fe6a53a 100644 --- a/src/java/org/apache/poi/ss/usermodel/CellStyle.java +++ b/src/java/org/apache/poi/ss/usermodel/CellStyle.java @@ -17,319 +17,9 @@ package org.apache.poi.ss.usermodel; -import org.apache.poi.util.Removal; - public interface CellStyle { /** - * general (normal) horizontal alignment - * @deprecated POI 3.15 beta 3. Use {@link HorizontalAlignment#GENERAL} instead. - */ - @Removal(version="3.17") - short ALIGN_GENERAL = 0x0; //HorizontalAlignment.GENERAL.getCode(); - - /** - * left-justified horizontal alignment - * @deprecated POI 3.15 beta 3. Use {@link HorizontalAlignment#LEFT} instead. - */ - @Removal(version="3.17") - short ALIGN_LEFT = 0x1; //HorizontalAlignment.LEFT.getCode(); - - /** - * center horizontal alignment - * @deprecated POI 3.15 beta 3. Use {@link HorizontalAlignment#CENTER} instead. - */ - @Removal(version="3.17") - short ALIGN_CENTER = 0x2; //HorizontalAlignment.CENTER.getCode(); - - /** - * right-justified horizontal alignment - * @deprecated POI 3.15 beta 3. Use {@link HorizontalAlignment#RIGHT} instead. - */ - @Removal(version="3.17") - short ALIGN_RIGHT = 0x3; //HorizontalAlignment.RIGHT.getCode(); - - /** - * fill? horizontal alignment - * @deprecated POI 3.15 beta 3. Use {@link HorizontalAlignment#FILL} instead. - */ - @Removal(version="3.17") - short ALIGN_FILL = 0x4; //HorizontalAlignment.FILL.getCode(); - - /** - * justified horizontal alignment - * @deprecated POI 3.15 beta 3. Use {@link HorizontalAlignment#JUSTIFY} instead. - */ - @Removal(version="3.17") - short ALIGN_JUSTIFY = 0x5; //HorizontalAlignment.JUSTIFY.getCode(); - - /** - * center-selection? horizontal alignment - * @deprecated POI 3.15 beta 3. Use {@link HorizontalAlignment#CENTER_SELECTION} instead. - */ - @Removal(version="3.17") - short ALIGN_CENTER_SELECTION = 0x6; //HorizontalAlignment.CENTER_SELECTION.getCode(); - - /** - * top-aligned vertical alignment - * @deprecated POI 3.15 beta 3. Use {@link VerticalAlignment#TOP} instead. - */ - @Removal(version="3.17") - short VERTICAL_TOP = 0x0; //VerticalAlignment.TOP.getCode(); - - /** - * center-aligned vertical alignment - * @deprecated POI 3.15 beta 3. Use {@link VerticalAlignment#CENTER} instead. - */ - @Removal(version="3.17") - short VERTICAL_CENTER = 0x1; //VerticalAlignment.CENTER.getCode(); - - /** - * bottom-aligned vertical alignment - * @deprecated POI 3.15 beta 3. Use {@link VerticalAlignment#BOTTOM} instead. - */ - @Removal(version="3.17") - short VERTICAL_BOTTOM = 0x2; //VerticalAlignment.BOTTOM.getCode(); - - /** - * vertically justified vertical alignment - * @deprecated POI 3.15 beta 3. Use {@link VerticalAlignment#JUSTIFY} instead. - */ - @Removal(version="3.17") - short VERTICAL_JUSTIFY = 0x3; //VerticalAlignment.JUSTIFY.getCode(); - - /** - * No border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#NONE} instead. - */ - @Removal(version="3.17") - short BORDER_NONE = 0x0; //BorderStyle.NONE.getCode(); - - /** - * Thin border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#THIN} instead. - */ - @Removal(version="3.17") - short BORDER_THIN = 0x1; //BorderStyle.THIN.getCode(); - - /** - * Medium border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#MEDIUM} instead. - */ - @Removal(version="3.17") - short BORDER_MEDIUM = 0x2; //BorderStyle.MEDIUM.getCode(); - - /** - * dash border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#DASHED} instead. - */ - @Removal(version="3.17") - short BORDER_DASHED = 0x3; //BorderStyle.DASHED.getCode(); - - /** - * dot border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#DOTTED} instead. - */ - @Removal(version="3.17") - short BORDER_DOTTED = 0x4; //BorderStyle.DOTTED.getCode(); - - /** - * Thick border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#THICK} instead. - */ - @Removal(version="3.17") - short BORDER_THICK = 0x5; //BorderStyle.THICK.getCode(); - - /** - * double-line border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#DOUBLE} instead. - */ - @Removal(version="3.17") - short BORDER_DOUBLE = 0x6; //BorderStyle.DOUBLE.getCode(); - - /** - * hair-line border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#HAIR} instead. - */ - @Removal(version="3.17") - short BORDER_HAIR = 0x7; //BorderStyle.HAIR.getCode(); - - /** - * Medium dashed border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#MEDIUM_DASHED} instead. - */ - @Removal(version="3.17") - short BORDER_MEDIUM_DASHED = 0x8; //BorderStyle.MEDIUM_DASHED.getCode(); - - /** - * dash-dot border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#DASH_DOT} instead. - */ - @Removal(version="3.17") - short BORDER_DASH_DOT = 0x9; //BorderStyle.DASH_DOT.getCode(); - - /** - * medium dash-dot border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#MEDIUM_DASH_DOT} instead. - */ - @Removal(version="3.17") - short BORDER_MEDIUM_DASH_DOT = 0xA; //BorderStyle.MEDIUM_DASH_DOT.getCode(); - - /** - * dash-dot-dot border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#DASH_DOT_DOT} instead. - */ - @Removal(version="3.17") - short BORDER_DASH_DOT_DOT = 0xB; //BorderStyle.DASH_DOT_DOT.getCode(); - - /** - * medium dash-dot-dot border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#MEDIUM_DASH_DOT_DOT} instead. - */ - @Removal(version="3.17") - short BORDER_MEDIUM_DASH_DOT_DOT = 0xC; //BorderStyle.MEDIUM_DASH_DOT_DOT.getCode(); - - /** - * slanted dash-dot border - * @deprecated 3.15 beta 2. Use {@link BorderStyle#SLANTED_DASH_DOT} instead. - */ - @Removal(version="3.17") - short BORDER_SLANTED_DASH_DOT = 0xD; //BorderStyle.SLANTED_DASH_DOT.getCode(); - - /** - * Fill Pattern: No background - * @deprecated 3.15 beta 3. Use {@link FillPatternType#NO_FILL} instead. - */ - @Removal(version="3.17") - short NO_FILL = 0; //FillPatternType.NO_FILL.getCode(); - - /** - * Fill Pattern: Solidly filled - * @deprecated 3.15 beta 3. Use {@link FillPatternType#SOLID_FOREGROUND} instead. - */ - @Removal(version="3.17") - short SOLID_FOREGROUND = 1; //FillPatternType.SOLID_FOREGROUND.getCode(); - - /** - * Fill Pattern: Small fine dots - * @deprecated 3.15 beta 3. Use {@link FillPatternType#FINE_DOTS} instead. - */ - @Removal(version="3.17") - short FINE_DOTS = 2; //FillPatternType.FINE_DOTS.getCode(); - - /** - * Fill Pattern: Wide dots - * @deprecated 3.15 beta 3. Use {@link FillPatternType#ALT_BARS} instead. - */ - @Removal(version="3.17") - short ALT_BARS = 3; //FillPatternType.ALT_BARS.getCode(); - - /** - * Fill Pattern: Sparse dots - * @deprecated 3.15 beta 3. Use {@link FillPatternType#SPARSE_DOTS} instead. - */ - @Removal(version="3.17") - short SPARSE_DOTS = 4; //FillPatternType.SPARSE_DOTS.getCode(); - - /** - * Fill Pattern: Thick horizontal bands - * @deprecated 3.15 beta 3. Use {@link FillPatternType#THICK_HORZ_BANDS} instead. - */ - @Removal(version="3.17") - short THICK_HORZ_BANDS = 5; //FillPatternType.THICK_HORZ_BANDS.getCode(); - - /** - * Fill Pattern: Thick vertical bands - * @deprecated 3.15 beta 3. Use {@link FillPatternType#THICK_VERT_BANDS} instead. - */ - @Removal(version="3.17") - short THICK_VERT_BANDS = 6; //FillPatternType.THICK_VERT_BANDS.getCode(); - - /** - * Fill Pattern: Thick backward facing diagonals - * @deprecated 3.15 beta 3. Use {@link FillPatternType#THICK_BACKWARD_DIAG} instead. - */ - @Removal(version="3.17") - short THICK_BACKWARD_DIAG = 7; //FillPatternType.THICK_BACKWARD_DIAG.getCode(); - - /** - * Fill Pattern: Thick forward facing diagonals - * @deprecated 3.15 beta 3. Use {@link FillPatternType#THICK_FORWARD_DIAG} instead. - */ - @Removal(version="3.17") - short THICK_FORWARD_DIAG = 8; //FillPatternType.THICK_FORWARD_DIAG.getCode(); - - /** - * Fill Pattern: Large spots - * @deprecated 3.15 beta 3. Use {@link FillPatternType#BIG_SPOTS} instead. - */ - @Removal(version="3.17") - short BIG_SPOTS = 9; //FillPatternType.BIG_SPOTS.getCode(); - - /** - * Fill Pattern: Brick-like layout - * @deprecated 3.15 beta 3. Use {@link FillPatternType#BRICKS} instead. - */ - @Removal(version="3.17") - short BRICKS = 10; //FillPatternType.BRICKS.getCode(); - - /** - * Fill Pattern: Thin horizontal bands - * @deprecated 3.15 beta 3. Use {@link FillPatternType#THIN_HORZ_BANDS} instead. - */ - @Removal(version="3.17") - short THIN_HORZ_BANDS = 11; //FillPatternType.THIN_HORZ_BANDS.getCode(); - - /** - * Fill Pattern: Thin vertical bands - * @deprecated 3.15 beta 3. Use {@link FillPatternType#THIN_VERT_BANDS} instead. - */ - @Removal(version="3.17") - short THIN_VERT_BANDS = 12; //FillPatternType.THIN_VERT_BANDS.getCode(); - - /** - * Fill Pattern: Thin backward diagonal - * @deprecated 3.15 beta 3. Use {@link FillPatternType#THIN_BACKWARD_DIAG} instead. - */ - @Removal(version="3.17") - short THIN_BACKWARD_DIAG = 13; //FillPatternType.THIN_BACKWARD_DIAG.getCode(); - - /** - * Fill Pattern: Thin forward diagonal - * @deprecated 3.15 beta 3. Use {@link FillPatternType#THIN_FORWARD_DIAG} instead. - */ - @Removal(version="3.17") - short THIN_FORWARD_DIAG = 14; //FillPatternType.THIN_FORWARD_DIAG.getCode(); - - /** - * Fill Pattern: Squares - * @deprecated 3.15 beta 3. Use {@link FillPatternType#SQUARES} instead. - */ - @Removal(version="3.17") - short SQUARES = 15; //FillPatternType.SQUARES.getCode(); - - /** - * Fill Pattern: Diamonds - * @deprecated 3.15 beta 3. Use {@link FillPatternType#DIAMONDS} instead. - */ - @Removal(version="3.17") - short DIAMONDS = 16; //FillPatternType.DIAMONDS.getCode(); - - /** - * Fill Pattern: Less Dots - * @deprecated 3.15 beta 3. Use {@link FillPatternType#LESS_DOTS} instead. - */ - @Removal(version="3.17") - short LESS_DOTS = 17; //FillPatternType.LESS_DOTS.getCode(); - - /** - * Fill Pattern: Least Dots - * @deprecated 3.15 beta 3. Use {@link FillPatternType#LEAST_DOTS} instead. - */ - @Removal(version="3.17") - short LEAST_DOTS = 18; //FillPatternType.LEAST_DOTS.getCode(); - - /** * get the index within the Workbook (sequence within the collection of ExtnededFormat objects) * @return unique index number of the underlying record this style represents (probably you don't care * unless you're comparing which one is which) @@ -417,32 +107,12 @@ public interface CellStyle { /** * set the type of horizontal alignment for the cell * @param align - the type of alignment - * @see #ALIGN_GENERAL - * @see #ALIGN_LEFT - * @see #ALIGN_CENTER - * @see #ALIGN_RIGHT - * @see #ALIGN_FILL - * @see #ALIGN_JUSTIFY - * @see #ALIGN_CENTER_SELECTION - * @deprecated POI 3.15 beta 3. Use {@link #setAlignment(HorizontalAlignment)} instead. - */ - void setAlignment(short align); - /** - * set the type of horizontal alignment for the cell - * @param align - the type of alignment */ void setAlignment(HorizontalAlignment align); /** * get the type of horizontal alignment for the cell * @return align - the type of alignment - * @see #ALIGN_GENERAL - * @see #ALIGN_LEFT - * @see #ALIGN_CENTER - * @see #ALIGN_RIGHT - * @see #ALIGN_FILL - * @see #ALIGN_JUSTIFY - * @see #ALIGN_CENTER_SELECTION * @deprecated POI 3.15 beta 3. Use {@link #getAlignmentEnum()} instead. */ short getAlignment(); @@ -472,26 +142,12 @@ public interface CellStyle { /** * set the type of vertical alignment for the cell * @param align the type of alignment - * @see #VERTICAL_TOP - * @see #VERTICAL_CENTER - * @see #VERTICAL_BOTTOM - * @see #VERTICAL_JUSTIFY - * @deprecated POI 3.15 beta 3. Use {@link #setVerticalAlignment(VerticalAlignment)} instead. - */ - void setVerticalAlignment(short align); - /** - * set the type of vertical alignment for the cell - * @param align the type of alignment */ void setVerticalAlignment(VerticalAlignment align); /** * get the type of vertical alignment for the cell * @return align the type of alignment - * @see #VERTICAL_TOP - * @see #VERTICAL_CENTER - * @see #VERTICAL_BOTTOM - * @see #VERTICAL_JUSTIFY * @deprecated POI 3.15 beta 3. Use {@link #getVerticalAlignmentEnum()} instead. */ short getVerticalAlignment(); @@ -541,28 +197,6 @@ public interface CellStyle { /** * set the type of border to use for the left border of the cell * @param border type - * @see #BORDER_NONE - * @see #BORDER_THIN - * @see #BORDER_MEDIUM - * @see #BORDER_DASHED - * @see #BORDER_DOTTED - * @see #BORDER_THICK - * @see #BORDER_DOUBLE - * @see #BORDER_HAIR - * @see #BORDER_MEDIUM_DASHED - * @see #BORDER_DASH_DOT - * @see #BORDER_MEDIUM_DASH_DOT - * @see #BORDER_DASH_DOT_DOT - * @see #BORDER_MEDIUM_DASH_DOT_DOT - * @see #BORDER_SLANTED_DASH_DOT - * @deprecated 3.15 beta 2. Use {@link #setBorderLeft(BorderStyle)} instead - */ - @Removal(version="3.17") - void setBorderLeft(short border); - - /** - * set the type of border to use for the left border of the cell - * @param border type * @since POI 3.15 */ void setBorderLeft(BorderStyle border); @@ -584,28 +218,6 @@ public interface CellStyle { /** * set the type of border to use for the right border of the cell * @param border type - * @see #BORDER_NONE - * @see #BORDER_THIN - * @see #BORDER_MEDIUM - * @see #BORDER_DASHED - * @see #BORDER_DOTTED - * @see #BORDER_THICK - * @see #BORDER_DOUBLE - * @see #BORDER_HAIR - * @see #BORDER_MEDIUM_DASHED - * @see #BORDER_DASH_DOT - * @see #BORDER_MEDIUM_DASH_DOT - * @see #BORDER_DASH_DOT_DOT - * @see #BORDER_MEDIUM_DASH_DOT_DOT - * @see #BORDER_SLANTED_DASH_DOT - * @deprecated 3.15 beta 2. Use {@link #setBorderRight(BorderStyle)} instead - */ - @Removal(version="3.17") - void setBorderRight(short border); - - /** - * set the type of border to use for the right border of the cell - * @param border type * @since POI 3.15 */ void setBorderRight(BorderStyle border); @@ -627,28 +239,6 @@ public interface CellStyle { /** * set the type of border to use for the top border of the cell * @param border type - * @see #BORDER_NONE - * @see #BORDER_THIN - * @see #BORDER_MEDIUM - * @see #BORDER_DASHED - * @see #BORDER_DOTTED - * @see #BORDER_THICK - * @see #BORDER_DOUBLE - * @see #BORDER_HAIR - * @see #BORDER_MEDIUM_DASHED - * @see #BORDER_DASH_DOT - * @see #BORDER_MEDIUM_DASH_DOT - * @see #BORDER_DASH_DOT_DOT - * @see #BORDER_MEDIUM_DASH_DOT_DOT - * @see #BORDER_SLANTED_DASH_DOT - * @deprecated 3.15 beta 2. Use {@link #setBorderTop(BorderStyle)} instead - */ - @Removal(version="3.17") - void setBorderTop(short border); - - /** - * set the type of border to use for the top border of the cell - * @param border type * @since POI 3.15 */ void setBorderTop(BorderStyle border); @@ -666,28 +256,6 @@ public interface CellStyle { * @since POI 3.15 */ BorderStyle getBorderTopEnum(); - - /** - * set the type of border to use for the bottom border of the cell - * @param border type - * @see #BORDER_NONE - * @see #BORDER_THIN - * @see #BORDER_MEDIUM - * @see #BORDER_DASHED - * @see #BORDER_DOTTED - * @see #BORDER_THICK - * @see #BORDER_DOUBLE - * @see #BORDER_HAIR - * @see #BORDER_MEDIUM_DASHED - * @see #BORDER_DASH_DOT - * @see #BORDER_MEDIUM_DASH_DOT - * @see #BORDER_DASH_DOT_DOT - * @see #BORDER_MEDIUM_DASH_DOT_DOT - * @see #BORDER_SLANTED_DASH_DOT - * @deprecated 3.15 beta 2. Use {@link #setBorderBottom(BorderStyle)} instead. - */ - @Removal(version="3.17") - void setBorderBottom(short border); /** * set the type of border to use for the bottom border of the cell @@ -761,50 +329,6 @@ public interface CellStyle { * setting to one fills the cell with the foreground color... No idea about * other values * - * @see #NO_FILL - * @see #SOLID_FOREGROUND - * @see #FINE_DOTS - * @see #ALT_BARS - * @see #SPARSE_DOTS - * @see #THICK_HORZ_BANDS - * @see #THICK_VERT_BANDS - * @see #THICK_BACKWARD_DIAG - * @see #THICK_FORWARD_DIAG - * @see #BIG_SPOTS - * @see #BRICKS - * @see #THIN_HORZ_BANDS - * @see #THIN_VERT_BANDS - * @see #THIN_BACKWARD_DIAG - * @see #THIN_FORWARD_DIAG - * @see #SQUARES - * @see #DIAMONDS - * - * @param fp fill pattern (set to 1 to fill w/foreground color) - * @deprecated POI 3.15 beta 3. Use {@link #setFillPattern(FillPatternType)} instead. - */ - void setFillPattern(short fp); - /** - * setting to one fills the cell with the foreground color... No idea about - * other values - * - * @see #NO_FILL - * @see #SOLID_FOREGROUND - * @see #FINE_DOTS - * @see #ALT_BARS - * @see #SPARSE_DOTS - * @see #THICK_HORZ_BANDS - * @see #THICK_VERT_BANDS - * @see #THICK_BACKWARD_DIAG - * @see #THICK_FORWARD_DIAG - * @see #BIG_SPOTS - * @see #BRICKS - * @see #THIN_HORZ_BANDS - * @see #THIN_VERT_BANDS - * @see #THIN_BACKWARD_DIAG - * @see #THIN_FORWARD_DIAG - * @see #SQUARES - * @see #DIAMONDS - * * @param fp fill pattern (set to {@link FillPatternType#SOLID_FOREGROUND} to fill w/foreground color) * @since POI 3.15 beta 3 */ diff --git a/src/java/org/apache/poi/ss/usermodel/Workbook.java b/src/java/org/apache/poi/ss/usermodel/Workbook.java index dbac00bffb..4e3d001f53 100644 --- a/src/java/org/apache/poi/ss/usermodel/Workbook.java +++ b/src/java/org/apache/poi/ss/usermodel/Workbook.java @@ -261,7 +261,7 @@ public interface Workbook extends Closeable, Iterable<Sheet> { /** * Get the Sheet object at the given index. * - * @param index of the sheet number (0-based physical & logical) + * @param index of the sheet number (0-based physical & logical) * @return Sheet at the provided index * @throws IllegalArgumentException if the index is out of range (index * < 0 || index >= getNumberOfSheets()). diff --git a/src/java/org/apache/poi/ss/util/CellUtil.java b/src/java/org/apache/poi/ss/util/CellUtil.java index c35cba4050..7c54cff814 100644 --- a/src/java/org/apache/poi/ss/util/CellUtil.java +++ b/src/java/org/apache/poi/ss/util/CellUtil.java @@ -23,7 +23,6 @@ import java.util.HashMap; import java.util.HashSet; import java.util.Locale; import java.util.Map; -import java.util.Map.Entry; import java.util.Set; import org.apache.poi.ss.usermodel.BorderStyle; @@ -198,29 +197,6 @@ public final class CellUtil { * style if no match exists. * * @param cell the cell to set the alignment for - * @param workbook The workbook that is being worked with. - * @param align the column alignment to use. - * - * @deprecated 3.15-beta2. Use {@link #setAlignment(Cell, HorizontalAlignment)} instead. - * - * @see CellStyle for alignment options - */ - @Deprecated - @Removal(version="3.17") - public static void setAlignment(Cell cell, Workbook workbook, short align) { - setAlignment(cell, HorizontalAlignment.forInt(align)); - } - - /** - * Take a cell, and align it. - * - * This is superior to cell.getCellStyle().setAlignment(align) because - * this method will not modify the CellStyle object that may be referenced - * by multiple cells. Instead, this method will search for existing CellStyles - * that match the desired CellStyle, creating a new CellStyle with the desired - * style if no match exists. - * - * @param cell the cell to set the alignment for * @param align the horizontal alignment to use. * * @see HorizontalAlignment for alignment options @@ -659,40 +635,6 @@ public final class CellUtil { } /** - * Utility method that puts the named short value to the given map. - * - * @param properties map of properties (String -> Object) - * @param name property name - * @param value property value - */ - private static void putShort(Map<String, Object> properties, String name, short value) { - properties.put(name, value); - } - - /** - * Utility method that puts the named BorderStyle, HorizontalAlignment, VerticalAlignment, etc - * value to the given map. - * - * @param properties map of properties (String -> Object) - * @param name property name - * @param value property value - */ - private static void putEnum(Map<String, Object> properties, String name, Enum<?> value) { - properties.put(name, value); - } - - /** - * Utility method that puts the named boolean value to the given map. - * - * @param properties map of properties (String -> Object) - * @param name property name - * @param value property value - */ - private static void putBoolean(Map<String, Object> properties, String name, boolean value) { - properties.put(name, value); - } - - /** * Looks for text in the cell that should be unicode, like α and provides the * unicode version of it. * diff --git a/src/java/org/apache/poi/ss/util/RegionUtil.java b/src/java/org/apache/poi/ss/util/RegionUtil.java index caec5a0092..8e86dbf597 100644 --- a/src/java/org/apache/poi/ss/util/RegionUtil.java +++ b/src/java/org/apache/poi/ss/util/RegionUtil.java @@ -21,7 +21,6 @@ import org.apache.poi.ss.usermodel.BorderStyle; import org.apache.poi.ss.usermodel.Cell; import org.apache.poi.ss.usermodel.Row; import org.apache.poi.ss.usermodel.Sheet; -import org.apache.poi.ss.usermodel.Workbook; import org.apache.poi.util.Removal; /** @@ -64,20 +63,6 @@ public final class RegionUtil { * * @param border The new border * @param region The region that should have the border - * @param workbook The workbook that the region is on. - * @param sheet The sheet that the region is on. - * @deprecated 3.15 beta 2. Use {@link #setBorderLeft(BorderStyle, CellRangeAddress, Sheet)}. - */ - @Removal(version="3.17") - public static void setBorderLeft(int border, CellRangeAddress region, Sheet sheet, Workbook workbook) { - setBorderLeft(border, region, sheet); - } - /** - * Sets the left border style for a region of cells by manipulating the cell style of the individual - * cells on the left - * - * @param border The new border - * @param region The region that should have the border * @param sheet The sheet that the region is on. * @since POI 3.15 beta 2 * @deprecated 3.16 beta 1. Use {@link #setBorderLeft(BorderStyle, CellRangeAddress, Sheet)}. @@ -119,20 +104,6 @@ public final class RegionUtil { * * @param color The color of the border * @param region The region that should have the border - * @param workbook The workbook that the region is on. - * @param sheet The sheet that the region is on. - * @deprecated 3.15 beta 2. Use {@link #setLeftBorderColor(int, CellRangeAddress, Sheet)}. - */ - @Removal(version="3.17") - public static void setLeftBorderColor(int color, CellRangeAddress region, Sheet sheet, Workbook workbook) { - setLeftBorderColor(color, region, sheet); - } - /** - * Sets the left border color for a region of cells by manipulating the cell style of the individual - * cells on the left - * - * @param color The color of the border - * @param region The region that should have the border * @param sheet The sheet that the region is on. * @since POI 3.15 beta 2 */ @@ -153,20 +124,6 @@ public final class RegionUtil { * * @param border The new border * @param region The region that should have the border - * @param workbook The workbook that the region is on. - * @param sheet The sheet that the region is on. - * @deprecated 3.15 beta 2. Use {@link #setBorderRight(BorderStyle, CellRangeAddress, Sheet)}. - */ - @Removal(version="3.17") - public static void setBorderRight(int border, CellRangeAddress region, Sheet sheet, Workbook workbook) { - setBorderRight(border, region, sheet); - } - /** - * Sets the right border style for a region of cells by manipulating the cell style of the individual - * cells on the right - * - * @param border The new border - * @param region The region that should have the border * @param sheet The sheet that the region is on. * @since POI 3.15 beta 2 * @deprecated POI 3.16 beta 1. Use {@link #setBorderRight(BorderStyle, CellRangeAddress, Sheet)}. @@ -208,20 +165,6 @@ public final class RegionUtil { * * @param color The color of the border * @param region The region that should have the border - * @param workbook The workbook that the region is on. - * @param sheet The sheet that the region is on. - * @deprecated 3.15 beta 2. Use {@link #setRightBorderColor(int, CellRangeAddress, Sheet)}. - */ - @Removal(version="3.17") - public static void setRightBorderColor(int color, CellRangeAddress region, Sheet sheet, Workbook workbook) { - setRightBorderColor(color, region, sheet); - } - /** - * Sets the right border color for a region of cells by manipulating the cell style of the individual - * cells on the right - * - * @param color The color of the border - * @param region The region that should have the border * @param sheet The sheet that the region is on. * @since POI 3.15 beta 2 */ @@ -242,20 +185,6 @@ public final class RegionUtil { * * @param border The new border * @param region The region that should have the border - * @param workbook The workbook that the region is on. - * @param sheet The sheet that the region is on. - * @deprecated 3.15 beta 2. Use {@link #setBorderBottom(BorderStyle, CellRangeAddress, Sheet)}. - */ - @Removal(version="3.17") - public static void setBorderBottom(int border, CellRangeAddress region, Sheet sheet, Workbook workbook) { - setBorderBottom(border, region, sheet); - } - /** - * Sets the bottom border style for a region of cells by manipulating the cell style of the individual - * cells on the bottom - * - * @param border The new border - * @param region The region that should have the border * @param sheet The sheet that the region is on. * @since POI 3.15 beta 2 * @deprecated POI 3.16 beta 1. Use {@link #setBorderBottom(BorderStyle, CellRangeAddress, Sheet)}. @@ -297,20 +226,6 @@ public final class RegionUtil { * * @param color The color of the border * @param region The region that should have the border - * @param workbook The workbook that the region is on. - * @param sheet The sheet that the region is on. - * @deprecated 3.15 beta 2. Use {@link #setBottomBorderColor(int, CellRangeAddress, Sheet)}. - */ - @Removal(version="3.17") - public static void setBottomBorderColor(int color, CellRangeAddress region, Sheet sheet, Workbook workbook) { - setBottomBorderColor(color, region, sheet); - } - /** - * Sets the bottom border color for a region of cells by manipulating the cell style of the individual - * cells on the bottom - * - * @param color The color of the border - * @param region The region that should have the border * @param sheet The sheet that the region is on. * @since POI 3.15 beta 2 */ @@ -331,20 +246,6 @@ public final class RegionUtil { * * @param border The new border * @param region The region that should have the border - * @param workbook The workbook that the region is on. - * @param sheet The sheet that the region is on. - * @deprecated 3.15 beta 2. Use {@link #setBorderTop(BorderStyle, CellRangeAddress, Sheet)}. - */ - @Removal(version="3.17") - public static void setBorderTop(int border, CellRangeAddress region, Sheet sheet, Workbook workbook) { - setBorderTop(border, region, sheet); - } - /** - * Sets the top border style for a region of cells by manipulating the cell style of the individual - * cells on the top - * - * @param border The new border - * @param region The region that should have the border * @param sheet The sheet that the region is on. * @since POI 3.15 beta 2 * @deprecated 3.16 beta 1. Use {@link #setBorderTop(BorderStyle, CellRangeAddress, Sheet)}. @@ -386,20 +287,6 @@ public final class RegionUtil { * * @param color The color of the border * @param region The region that should have the border - * @param workbook The workbook that the region is on. - * @param sheet The sheet that the region is on. - * @deprecated 3.15 beta 2. Use {@link #setTopBorderColor(int, CellRangeAddress, Sheet)}. - */ - @Removal(version="3.17") - public static void setTopBorderColor(int color, CellRangeAddress region, Sheet sheet, Workbook workbook) { - setTopBorderColor(color, region, sheet); - } - /** - * Sets the top border color for a region of cells by manipulating the cell style of the individual - * cells on the top - * - * @param color The color of the border - * @param region The region that should have the border * @param sheet The sheet that the region is on. * @since POI 3.15 beta 2 */ |