Package org.apache.poi.ss.usermodel
Interface CellStyle
-
- All Known Subinterfaces:
DxfCellStyle,NamedStyle
- All Known Implementing Classes:
HSSFCellStyle,org.apache.poi.xssf.usermodel.XSSFCellStyle,XSSFDxfCellStyle,XSSFNamedStyle
public interface CellStyle
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description voidcloneStyleFrom(CellStyle source)Clones all the style information from another CellStyle, onto this one.HorizontalAlignmentgetAlignment()get the type of horizontal alignment for the cellBorderStylegetBorderBottom()get the type of border to use for the bottom border of the cellBorderStylegetBorderLeft()get the type of border to use for the left border of the cellBorderStylegetBorderRight()get the type of border to use for the right border of the cellBorderStylegetBorderTop()get the type of border to use for the top border of the cellshortgetBottomBorderColor()get the color to use for the left bordershortgetDataFormat()get the index of the data format.StringgetDataFormatString()Get the format stringshortgetFillBackgroundColor()get the background fill color, if the fill is defined with an indexed color.ColorgetFillBackgroundColorColor()Gets the color object representing the current background fill, resolving indexes using the supplied workbook.shortgetFillForegroundColor()get the foreground fill color, if the fill is defined with an indexed color.ColorgetFillForegroundColorColor()Gets the color object representing the current foreground fill, resolving indexes using the supplied workbook.FillPatternTypegetFillPattern()Get the fill patternintgetFontIndex()gets the index of the font for this styleintgetFontIndexAsInt()Deprecated.usegetFontIndex()insteadbooleangetHidden()get whether the cell's using this style are to be hiddenshortgetIndention()get the number of spaces to indent the text in the cellshortgetIndex()get the index within the Workbook (sequence within the collection of ExtendedFormat objects)shortgetLeftBorderColor()get the color to use for the left borderbooleangetLocked()get whether the cell's using this style are to be lockedbooleangetQuotePrefixed()Is "Quote Prefix" or "123 Prefix" enabled for the cell? Having this on is somewhat (but not completely, seeIgnoredErrorType) like prefixing the cell value with a ' in ExcelshortgetRightBorderColor()get the color to use for the left bordershortgetRotation()get the degree of rotation for the text in the cell.booleangetShrinkToFit()Should the Cell be auto-sized by Excel to shrink it to fit if this text is too long?shortgetTopBorderColor()get the color to use for the top borderVerticalAlignmentgetVerticalAlignment()get the type of vertical alignment for the cellbooleangetWrapText()get whether the text should be wrappedvoidsetAlignment(HorizontalAlignment align)set the type of horizontal alignment for the cellvoidsetBorderBottom(BorderStyle border)set the type of border to use for the bottom border of the cellvoidsetBorderLeft(BorderStyle border)set the type of border to use for the left border of the cellvoidsetBorderRight(BorderStyle border)set the type of border to use for the right border of the cellvoidsetBorderTop(BorderStyle border)set the type of border to use for the top border of the cellvoidsetBottomBorderColor(short color)set the color to use for the bottom bordervoidsetDataFormat(short fmt)set the data format (must be a valid format).voidsetFillBackgroundColor(short bg)set the background fill color.voidsetFillBackgroundColor(Color color)Set the background fill color.voidsetFillForegroundColor(short bg)set the foreground fill color Note: Ensure Foreground color is set prior to background color.voidsetFillForegroundColor(Color color)Set the foreground fill color.voidsetFillPattern(FillPatternType fp)setting to one fills the cell with the foreground color...voidsetFont(Font font)set the font for this stylevoidsetHidden(boolean hidden)set the cell's using this style to be hiddenvoidsetIndention(short indent)set the number of spaces to indent the text in the cellvoidsetLeftBorderColor(short color)set the color to use for the left bordervoidsetLocked(boolean locked)set the cell's using this style to be lockedvoidsetQuotePrefixed(boolean quotePrefix)Turn on or off "Quote Prefix" or "123 Prefix" for the style, which is used to tell Excel that the thing which looks like a number or a formula shouldn't be treated as on.voidsetRightBorderColor(short color)set the color to use for the right bordervoidsetRotation(short rotation)set the degree of rotation for the text in the cell.voidsetShrinkToFit(boolean shrinkToFit)Controls if the Cell should be auto-sized to shrink to fit if the text is too longvoidsetTopBorderColor(short color)set the color to use for the top bordervoidsetVerticalAlignment(VerticalAlignment align)set the type of vertical alignment for the cellvoidsetWrapText(boolean wrapped)Set whether the text should be wrapped.
-
-
-
Method Detail
-
getIndex
short getIndex()
get the index within the Workbook (sequence within the collection of ExtendedFormat objects)- Returns:
- unique index number of the underlying record this style represents (probably you don't care unless you're comparing which one is which)
-
setDataFormat
void setDataFormat(short fmt)
set the data format (must be a valid format). Built in formats are defined atBuiltinFormats.- See Also:
DataFormat
-
getDataFormat
short getDataFormat()
get the index of the data format. Built in formats are defined atBuiltinFormats.- See Also:
DataFormat
-
getDataFormatString
String getDataFormatString()
Get the format string
-
setFont
void setFont(Font font)
set the font for this style- Parameters:
font- a font object created or retrieved from the Workbook object- See Also:
Workbook.createFont(),Workbook.getFontAt(int)
-
getFontIndex
int getFontIndex()
gets the index of the font for this style- Since:
- 5.0.0 (used to return a short value)
- See Also:
Workbook.getFontAt(int)
-
getFontIndexAsInt
@Deprecated @Removal(version="6.0.0") int getFontIndexAsInt()
Deprecated.usegetFontIndex()insteadgets the index of the font for this style- Since:
- 4.0.0
- See Also:
Workbook.getFontAt(int)
-
setHidden
void setHidden(boolean hidden)
set the cell's using this style to be hidden- Parameters:
hidden- - whether the cell using this style should be hidden
-
getHidden
boolean getHidden()
get whether the cell's using this style are to be hidden- Returns:
- hidden - whether the cell using this style should be hidden
-
setLocked
void setLocked(boolean locked)
set the cell's using this style to be locked- Parameters:
locked- - whether the cell using this style should be locked
-
getLocked
boolean getLocked()
get whether the cell's using this style are to be locked- Returns:
- hidden - whether the cell using this style should be locked
-
setQuotePrefixed
void setQuotePrefixed(boolean quotePrefix)
Turn on or off "Quote Prefix" or "123 Prefix" for the style, which is used to tell Excel that the thing which looks like a number or a formula shouldn't be treated as on. Turning this on is somewhat (but not completely, seeIgnoredErrorType) like prefixing the cell value with a ' in Excel
-
getQuotePrefixed
boolean getQuotePrefixed()
Is "Quote Prefix" or "123 Prefix" enabled for the cell? Having this on is somewhat (but not completely, seeIgnoredErrorType) like prefixing the cell value with a ' in Excel
-
setAlignment
void setAlignment(HorizontalAlignment align)
set the type of horizontal alignment for the cell- Parameters:
align- - the type of alignment
-
getAlignment
HorizontalAlignment getAlignment()
get the type of horizontal alignment for the cell- Returns:
- align - the type of alignment
-
setWrapText
void setWrapText(boolean wrapped)
Set whether the text should be wrapped. Setting this flag totruemake all content visible within a cell by displaying it on multiple lines- Parameters:
wrapped- wrap text or not
-
getWrapText
boolean getWrapText()
get whether the text should be wrapped- Returns:
- wrap text or not
-
setVerticalAlignment
void setVerticalAlignment(VerticalAlignment align)
set the type of vertical alignment for the cell- Parameters:
align- the type of alignment
-
getVerticalAlignment
VerticalAlignment getVerticalAlignment()
get the type of vertical alignment for the cell- Returns:
- align the type of alignment
-
setRotation
void setRotation(short rotation)
set the degree of rotation for the text in the cell. Note: HSSF uses values from -90 to 90 degrees, whereas XSSF uses values from 0 to 180 degrees. The implementations of this method will map between these two value-ranges accordingly, however the corresponding getter is returning values in the range mandated by the current type of Excel file-format that this CellStyle is applied to.- Parameters:
rotation- degrees (see note above)
-
getRotation
short getRotation()
get the degree of rotation for the text in the cell. Note: HSSF uses values from -90 to 90 degrees, whereas XSSF uses values from 0 to 180 degrees. The implementations of this method will map between these two value-ranges value-range as used by the type of Excel file-format that this CellStyle is applied to.- Returns:
- rotation degrees (see note above)
-
setIndention
void setIndention(short indent)
set the number of spaces to indent the text in the cell- Parameters:
indent- - number of spaces
-
getIndention
short getIndention()
get the number of spaces to indent the text in the cell- Returns:
- indent - number of spaces
-
setBorderLeft
void setBorderLeft(BorderStyle border)
set the type of border to use for the left border of the cell- Parameters:
border- type- Since:
- POI 3.15
-
getBorderLeft
BorderStyle getBorderLeft()
get the type of border to use for the left border of the cell- Returns:
- border type
- Since:
- POI 4.0.0
-
setBorderRight
void setBorderRight(BorderStyle border)
set the type of border to use for the right border of the cell- Parameters:
border- type- Since:
- POI 3.15
-
getBorderRight
BorderStyle getBorderRight()
get the type of border to use for the right border of the cell- Returns:
- border type
- Since:
- POI 4.0.0
-
setBorderTop
void setBorderTop(BorderStyle border)
set the type of border to use for the top border of the cell- Parameters:
border- type- Since:
- POI 3.15
-
getBorderTop
BorderStyle getBorderTop()
get the type of border to use for the top border of the cell- Returns:
- border type
- Since:
- POI 4.0.0
-
setBorderBottom
void setBorderBottom(BorderStyle border)
set the type of border to use for the bottom border of the cell- Parameters:
border- type- Since:
- POI 3.15
-
getBorderBottom
BorderStyle getBorderBottom()
get the type of border to use for the bottom border of the cell- Returns:
- border type
- Since:
- POI 4.0.0
-
setLeftBorderColor
void setLeftBorderColor(short color)
set the color to use for the left border- Parameters:
color- The index of the color definition
-
getLeftBorderColor
short getLeftBorderColor()
get the color to use for the left border
-
setRightBorderColor
void setRightBorderColor(short color)
set the color to use for the right border- Parameters:
color- The index of the color definition
-
getRightBorderColor
short getRightBorderColor()
get the color to use for the left border- Returns:
- the index of the color definition
-
setTopBorderColor
void setTopBorderColor(short color)
set the color to use for the top border- Parameters:
color- The index of the color definition
-
getTopBorderColor
short getTopBorderColor()
get the color to use for the top border- Returns:
- the index of the color definition
-
setBottomBorderColor
void setBottomBorderColor(short color)
set the color to use for the bottom border- Parameters:
color- The index of the color definition
-
getBottomBorderColor
short getBottomBorderColor()
get the color to use for the left border- Returns:
- the index of the color definition
-
setFillPattern
void setFillPattern(FillPatternType fp)
setting to one fills the cell with the foreground color... No idea about other values- Parameters:
fp- fill pattern (set toFillPatternType.SOLID_FOREGROUNDto fill w/foreground color)- Since:
- POI 3.15 beta 3
-
getFillPattern
FillPatternType getFillPattern()
Get the fill pattern- Returns:
- the fill pattern, default value is
FillPatternType.NO_FILL - Since:
- POI 4.0.0
-
setFillBackgroundColor
void setFillBackgroundColor(short bg)
set the background fill color.- Parameters:
bg- color
-
setFillBackgroundColor
void setFillBackgroundColor(Color color)
Set the background fill color. Uses aColorinstead of an indexed color.- Parameters:
color- org.apache.poi.ss.usermodel.Color to set- Since:
- POI 5.2.3
-
getFillBackgroundColor
short getFillBackgroundColor()
get the background fill color, if the fill is defined with an indexed color.- Returns:
- fill color index, or 0 if not indexed (XSSF only)
-
getFillBackgroundColorColor
Color getFillBackgroundColorColor()
Gets the color object representing the current background fill, resolving indexes using the supplied workbook. This will work for both indexed and rgb defined colors.
-
setFillForegroundColor
void setFillForegroundColor(short bg)
set the foreground fill color Note: Ensure Foreground color is set prior to background color.- Parameters:
bg- color
-
setFillForegroundColor
void setFillForegroundColor(Color color)
Set the foreground fill color. Uses aColorinstead of an indexed color.- Parameters:
color- org.apache.poi.ss.usermodel.Color to set- Since:
- POI 5.2.3
-
getFillForegroundColor
short getFillForegroundColor()
get the foreground fill color, if the fill is defined with an indexed color.- Returns:
- fill color, or 0 if not indexed (XSSF only)
-
getFillForegroundColorColor
Color getFillForegroundColorColor()
Gets the color object representing the current foreground fill, resolving indexes using the supplied workbook. This will work for both indexed and rgb defined colors.
-
cloneStyleFrom
void cloneStyleFrom(CellStyle source)
Clones all the style information from another CellStyle, onto this one. This CellStyle will then have all the same properties as the source, but the two may be edited independently. Any stylings on this CellStyle will be lost! The source CellStyle could be from another Workbook if you like. This allows you to copy styles from one Workbook to another. However, both of the CellStyles will need to be of the same type (HSSFCellStyle or XSSFCellStyle)
-
setShrinkToFit
void setShrinkToFit(boolean shrinkToFit)
Controls if the Cell should be auto-sized to shrink to fit if the text is too long
-
getShrinkToFit
boolean getShrinkToFit()
Should the Cell be auto-sized by Excel to shrink it to fit if this text is too long?
-
-