org.apache.poi.hssf.util
Class HSSFColor

java.lang.Object
  org.apache.poi.hssf.util.HSSFColor

All Implemented Interfaces:

Color

Direct Known Subclasses:

HSSFColor.AQUA, HSSFColor.AUTOMATIC, HSSFColor.BLACK, HSSFColor.BLUE, HSSFColor.BLUE_GREY, HSSFColor.BRIGHT_GREEN, HSSFColor.BROWN, HSSFColor.CORAL, HSSFColor.CORNFLOWER_BLUE, HSSFColor.DARK_BLUE, HSSFColor.DARK_GREEN, HSSFColor.DARK_RED, HSSFColor.DARK_TEAL, HSSFColor.DARK_YELLOW, HSSFColor.GOLD, HSSFColor.GREEN, HSSFColor.GREY_25_PERCENT, HSSFColor.GREY_40_PERCENT, HSSFColor.GREY_50_PERCENT, HSSFColor.GREY_80_PERCENT, HSSFColor.INDIGO, HSSFColor.LAVENDER, HSSFColor.LEMON_CHIFFON, HSSFColor.LIGHT_BLUE, HSSFColor.LIGHT_CORNFLOWER_BLUE, HSSFColor.LIGHT_GREEN, HSSFColor.LIGHT_ORANGE, HSSFColor.LIGHT_TURQUOISE, HSSFColor.LIGHT_YELLOW, HSSFColor.LIME, HSSFColor.MAROON, HSSFColor.OLIVE_GREEN, HSSFColor.ORANGE, HSSFColor.ORCHID, HSSFColor.PALE_BLUE, HSSFColor.PINK, HSSFColor.PLUM, HSSFColor.RED, HSSFColor.ROSE, HSSFColor.ROYAL_BLUE, HSSFColor.SEA_GREEN, HSSFColor.SKY_BLUE, HSSFColor.TAN, HSSFColor.TEAL, HSSFColor.TURQUOISE, HSSFColor.VIOLET, HSSFColor.WHITE, HSSFColor.YELLOW

public class HSSFColor
extends java.lang.Object
implements Color

Intends to provide support for the very evil index to triplet issue and will likely replace the color constants interface for HSSF 2.0. This class contains static inner class members for representing colors. Each color has an index (for the standard palette in Excel (tm) ), native (RGB) triplet and string triplet. The string triplet is as the color would be represented by Gnumeric. Having (string) this here is a bit of a collision of function between HSSF and the HSSFSerializer but I think its a reasonable one in this case.

HSSFColor

public HSSFColor()

Creates a new instance of HSSFColor

HSSFColor

public HSSFColor(int index,
                 int index2,
                 java.awt.Color color)

getIndexHash

public static final java.util.Map<java.lang.Integer,HSSFColor> getIndexHash()

This function returns all the colours in an unmodifiable Map. The map is cached on first use.

Returns:

a Map containing all colours keyed by Integer excel-style palette indexes

getMutableIndexHash

public static final java.util.Map<java.lang.Integer,HSSFColor> getMutableIndexHash()

This function returns all the Colours, stored in a Map that can be edited. No caching is performed. If you don't need to edit the table, then call getIndexHash() which returns a statically cached imuatable map of colours.

getTripletHash

public static java.util.Map<java.lang.String,HSSFColor> getTripletHash()

this function returns all colors in a hastable. Its not implemented as a static member/staticly initialized because that would be dirty in a server environment as it is intended. This means you'll eat the time it takes to create it once per request but you will not hold onto it if you have none of those requests.

Returns:

a Map containing all colors keyed by String gnumeric-like triplets

getIndex

public short getIndex()

returns color standard palette index

Returns:

index to the standard palette

getIndex2

public short getIndex2()

returns alternative color standard palette index

Returns:

alternative index to the standard palette, if -1 this index is not defined

getTriplet

public short[] getTriplet()

returns RGB triplet (0, 0, 0)

Returns:

triplet representation like that in Excel

getHexString

public java.lang.String getHexString()

returns colon-delimited hex string "0:0:0"

Returns:

a hex string exactly like a gnumeric triplet

toHSSFColor

public static HSSFColor toHSSFColor(Color color)

Checked type cast color to an HSSFColor.

Parameters:

color - the color to type cast

Returns:

the type casted color

Throws:

java.lang.IllegalArgumentException - if color is null or is not an instance of HSSFColor