bug 59338: patch from Mark Murphy to deprecate HSSFCellUtil class in favor of CellUtil.
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1739531 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
parent
7d07ef4439
commit
6043813e67
@ -17,7 +17,6 @@
|
|||||||
|
|
||||||
package org.apache.poi.hssf.util;
|
package org.apache.poi.hssf.util;
|
||||||
|
|
||||||
|
|
||||||
import org.apache.poi.hssf.usermodel.HSSFCell;
|
import org.apache.poi.hssf.usermodel.HSSFCell;
|
||||||
import org.apache.poi.hssf.usermodel.HSSFCellStyle;
|
import org.apache.poi.hssf.usermodel.HSSFCellStyle;
|
||||||
import org.apache.poi.hssf.usermodel.HSSFFont;
|
import org.apache.poi.hssf.usermodel.HSSFFont;
|
||||||
@ -27,12 +26,14 @@ import org.apache.poi.hssf.usermodel.HSSFWorkbook;
|
|||||||
import org.apache.poi.ss.util.CellUtil;
|
import org.apache.poi.ss.util.CellUtil;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Various utility functions that make working with a cells and rows easier. The various
|
* 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.
|
* 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
|
* 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
|
* 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
|
* creating too many styles. there is an upper limit in Excel on the number of styles that
|
||||||
* can be supported.
|
* can be supported.
|
||||||
|
*
|
||||||
|
* @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil} instead.
|
||||||
*/
|
*/
|
||||||
public final class HSSFCellUtil {
|
public final class HSSFCellUtil {
|
||||||
|
|
||||||
@ -43,9 +44,10 @@ public final class HSSFCellUtil {
|
|||||||
/**
|
/**
|
||||||
* Get a row from the spreadsheet, and create it if it doesn't exist.
|
* Get a row from the spreadsheet, and create it if it doesn't exist.
|
||||||
*
|
*
|
||||||
*@param rowIndex The 0 based row number
|
* @param rowIndex The 0 based row number
|
||||||
*@param sheet The sheet that the row is part of.
|
* @param sheet The sheet that the row is part of.
|
||||||
*@return The row indicated by the rowCounter
|
* @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) {
|
public static HSSFRow getRow(int rowIndex, HSSFSheet sheet) {
|
||||||
return (HSSFRow) CellUtil.getRow(rowIndex, sheet);
|
return (HSSFRow) CellUtil.getRow(rowIndex, sheet);
|
||||||
@ -55,9 +57,10 @@ public final class HSSFCellUtil {
|
|||||||
* Get a specific cell from a row. If the cell doesn't exist,
|
* Get a specific cell from a row. If the cell doesn't exist,
|
||||||
* then create it.
|
* then create it.
|
||||||
*
|
*
|
||||||
*@param row The row that the cell is part of
|
* @param row The row that the cell is part of
|
||||||
*@param columnIndex The column index that the cell is in.
|
* @param columnIndex The column index that the cell is in.
|
||||||
*@return The cell indicated by the column.
|
* @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) {
|
public static HSSFCell getCell(HSSFRow row, int columnIndex) {
|
||||||
return (HSSFCell) CellUtil.getCell(row, columnIndex);
|
return (HSSFCell) CellUtil.getCell(row, columnIndex);
|
||||||
@ -71,6 +74,7 @@ public final class HSSFCellUtil {
|
|||||||
* @param value The value of the cell
|
* @param value The value of the cell
|
||||||
* @param style If the style is not null, then set
|
* @param style If the style is not null, then set
|
||||||
* @return A new HSSFCell
|
* @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) {
|
public static HSSFCell createCell(HSSFRow row, int column, String value, HSSFCellStyle style) {
|
||||||
return (HSSFCell) CellUtil.createCell(row, column, value, style);
|
return (HSSFCell) CellUtil.createCell(row, column, value, style);
|
||||||
@ -79,10 +83,11 @@ public final class HSSFCellUtil {
|
|||||||
/**
|
/**
|
||||||
* Create a cell, and give it a value.
|
* Create a cell, and give it a value.
|
||||||
*
|
*
|
||||||
*@param row the row to create the cell in
|
* @param row the row to create the cell in
|
||||||
*@param column the column index to create the cell in
|
* @param column the column index to create the cell in
|
||||||
*@param value The value of the cell
|
* @param value The value of the cell
|
||||||
*@return A new HSSFCell.
|
* @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) {
|
public static HSSFCell createCell(HSSFRow row, int column, String value) {
|
||||||
return createCell( row, column, value, null );
|
return createCell( row, column, value, null );
|
||||||
@ -91,9 +96,10 @@ public final class HSSFCellUtil {
|
|||||||
/**
|
/**
|
||||||
* Take a cell, and align it.
|
* Take a cell, and align it.
|
||||||
*
|
*
|
||||||
*@param cell the cell to set the alignment for
|
* @param cell the cell to set the alignment for
|
||||||
*@param workbook The workbook that is being worked with.
|
* @param workbook The workbook that is being worked with.
|
||||||
*@param align the column alignment to use.
|
* @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
|
* @see HSSFCellStyle for alignment options
|
||||||
*/
|
*/
|
||||||
@ -104,9 +110,10 @@ public final class HSSFCellUtil {
|
|||||||
/**
|
/**
|
||||||
* Take a cell, and apply a font to it
|
* Take a cell, and apply a font to it
|
||||||
*
|
*
|
||||||
*@param cell the cell to set the alignment for
|
* @param cell the cell to set the alignment for
|
||||||
*@param workbook The workbook that is being worked with.
|
* @param workbook The workbook that is being worked with.
|
||||||
*@param font The HSSFFont that you want to set...
|
* @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) {
|
public static void setFont(HSSFCell cell, HSSFWorkbook workbook, HSSFFont font) {
|
||||||
CellUtil.setFont(cell, workbook, font);
|
CellUtil.setFont(cell, workbook, font);
|
||||||
@ -119,12 +126,11 @@ public final class HSSFCellUtil {
|
|||||||
* propertyName and propertyValue to the style. This is necessary because
|
* propertyName and propertyValue to the style. This is necessary because
|
||||||
* Excel has an upper limit on the number of Styles that it supports.
|
* Excel has an upper limit on the number of Styles that it supports.
|
||||||
*
|
*
|
||||||
*@param workbook The workbook that is being worked with.
|
* @param workbook The workbook that is being worked with.
|
||||||
*@param propertyName The name of the property that is to be
|
* @param propertyName The name of the property that is to be changed.
|
||||||
* changed.
|
* @param propertyValue The value of the property that is to be changed.
|
||||||
*@param propertyValue The value of the property that is to be
|
* @param cell The cell that needs it's style changes
|
||||||
* changed.
|
* @deprecated 3.15 beta2. Removed in 3.17. Use {@link org.apache.poi.ss.util.CellUtil#setCellStyleProperty} instead.
|
||||||
*@param cell The cell that needs it's style changes
|
|
||||||
*/
|
*/
|
||||||
public static void setCellStyleProperty(HSSFCell cell, HSSFWorkbook workbook,
|
public static void setCellStyleProperty(HSSFCell cell, HSSFWorkbook workbook,
|
||||||
String propertyName, Object propertyValue) {
|
String propertyName, Object propertyValue) {
|
||||||
@ -135,8 +141,10 @@ public final class HSSFCellUtil {
|
|||||||
* Looks for text in the cell that should be unicode, like α and provides the
|
* Looks for text in the cell that should be unicode, like α and provides the
|
||||||
* unicode version of it.
|
* unicode version of it.
|
||||||
*
|
*
|
||||||
*@param cell The cell to check for unicode values
|
* @param cell The cell to check for unicode values
|
||||||
*@return translated to unicode
|
* @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){
|
public static HSSFCell translateUnicodeValues(HSSFCell cell){
|
||||||
CellUtil.translateUnicodeValues(cell);
|
CellUtil.translateUnicodeValues(cell);
|
||||||
|
Loading…
Reference in New Issue
Block a user