org.apache.poi.xssf.usermodel
Class XSSFConditionalFormattingRule

java.lang.Object
  extended by org.apache.poi.xssf.usermodel.XSSFConditionalFormattingRule
All Implemented Interfaces:
ConditionalFormattingRule, DifferentialStyleProvider

public class XSSFConditionalFormattingRule
extends java.lang.Object
implements ConditionalFormattingRule

XSSF support for Conditional Formatting rules


Method Summary
 XSSFBorderFormatting createBorderFormatting()
          Create a new border formatting structure if it does not exist, otherwise just return existing object.
 XSSFColorScaleFormatting createColorScaleFormatting()
           
 XSSFDataBarFormatting createDataBarFormatting(XSSFColor color)
           
 XSSFFontFormatting createFontFormatting()
          Create a new font formatting structure if it does not exist, otherwise just return existing object.
 XSSFIconMultiStateFormatting createMultiStateFormatting(IconMultiStateFormatting.IconSet iconSet)
           
 XSSFPatternFormatting createPatternFormatting()
          Create a new pattern formatting structure if it does not exist, otherwise just return existing object.
 XSSFBorderFormatting getBorderFormatting()
           
 XSSFColorScaleFormatting getColorScaleFormatting()
           
 byte getComparisonOperation()
          The comparison function used when the type of conditional formatting is set to ConditionType.CELL_VALUE_IS
 ConditionFilterType getConditionFilterType()
          Will return null if getConditionType() != ConditionType.FILTER
 ConditionType getConditionType()
          Type of conditional formatting rule.
 XSSFDataBarFormatting getDataBarFormatting()
           
 ConditionFilterData getFilterConfiguration()
           
 XSSFFontFormatting getFontFormatting()
           
 java.lang.String getFormula1()
          The formula used to evaluate the first operand for the conditional formatting rule.
 java.lang.String getFormula2()
          The formula used to evaluate the second operand of the comparison when comparison type is ConditionType.CELL_VALUE_IS and operator is either ComparisonOperator.BETWEEN or ComparisonOperator.NOT_BETWEEN
 XSSFIconMultiStateFormatting getMultiStateFormatting()
           
 ExcelNumberFormat getNumberFormat()
          Return the number format from the dxf style record if present, null if not
 XSSFPatternFormatting getPatternFormatting()
           
 int getPriority()
           
 boolean getStopIfTrue()
           
 int getStripeSize()
          Conditional format rules don't define stripes, so always 0
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getPriority

public int getPriority()
Specified by:
getPriority in interface ConditionalFormattingRule

getStopIfTrue

public boolean getStopIfTrue()
Specified by:
getStopIfTrue in interface ConditionalFormattingRule

createBorderFormatting

public XSSFBorderFormatting createBorderFormatting()
Create a new border formatting structure if it does not exist, otherwise just return existing object.

Specified by:
createBorderFormatting in interface ConditionalFormattingRule
Returns:
- border formatting object, never returns null.

getBorderFormatting

public XSSFBorderFormatting getBorderFormatting()
Specified by:
getBorderFormatting in interface ConditionalFormattingRule
Specified by:
getBorderFormatting in interface DifferentialStyleProvider
Returns:
- border formatting object if defined, null otherwise

createFontFormatting

public XSSFFontFormatting createFontFormatting()
Create a new font formatting structure if it does not exist, otherwise just return existing object.

Specified by:
createFontFormatting in interface ConditionalFormattingRule
Returns:
- font formatting object, never returns null.

getFontFormatting

public XSSFFontFormatting getFontFormatting()
Specified by:
getFontFormatting in interface ConditionalFormattingRule
Specified by:
getFontFormatting in interface DifferentialStyleProvider
Returns:
- font formatting object if defined, null otherwise

createPatternFormatting

public XSSFPatternFormatting createPatternFormatting()
Create a new pattern formatting structure if it does not exist, otherwise just return existing object.

Specified by:
createPatternFormatting in interface ConditionalFormattingRule
Returns:
- pattern formatting object, never returns null.

getPatternFormatting

public XSSFPatternFormatting getPatternFormatting()
Specified by:
getPatternFormatting in interface ConditionalFormattingRule
Specified by:
getPatternFormatting in interface DifferentialStyleProvider
Returns:
- pattern formatting object if defined, null otherwise

createDataBarFormatting

public XSSFDataBarFormatting createDataBarFormatting(XSSFColor color)
Parameters:
color -
Returns:
data bar formatting

getDataBarFormatting

public XSSFDataBarFormatting getDataBarFormatting()
Specified by:
getDataBarFormatting in interface ConditionalFormattingRule

createMultiStateFormatting

public XSSFIconMultiStateFormatting createMultiStateFormatting(IconMultiStateFormatting.IconSet iconSet)

getMultiStateFormatting

public XSSFIconMultiStateFormatting getMultiStateFormatting()
Specified by:
getMultiStateFormatting in interface ConditionalFormattingRule

createColorScaleFormatting

public XSSFColorScaleFormatting createColorScaleFormatting()

getColorScaleFormatting

public XSSFColorScaleFormatting getColorScaleFormatting()
Specified by:
getColorScaleFormatting in interface ConditionalFormattingRule

getNumberFormat

public ExcelNumberFormat getNumberFormat()
Return the number format from the dxf style record if present, null if not

Specified by:
getNumberFormat in interface ConditionalFormattingRule
Specified by:
getNumberFormat in interface DifferentialStyleProvider
See Also:
ConditionalFormattingRule.getNumberFormat()

getConditionType

public ConditionType getConditionType()
Type of conditional formatting rule.

Specified by:
getConditionType in interface ConditionalFormattingRule

getConditionFilterType

public ConditionFilterType getConditionFilterType()
Will return null if getConditionType() != ConditionType.FILTER

Specified by:
getConditionFilterType in interface ConditionalFormattingRule
See Also:
ConditionalFormattingRule.getConditionFilterType()

getFilterConfiguration

public ConditionFilterData getFilterConfiguration()
Specified by:
getFilterConfiguration in interface ConditionalFormattingRule

getComparisonOperation

public byte getComparisonOperation()
The comparison function used when the type of conditional formatting is set to ConditionType.CELL_VALUE_IS

MUST be a constant from ComparisonOperator

Specified by:
getComparisonOperation in interface ConditionalFormattingRule
Returns:
the conditional format operator

getFormula1

public java.lang.String getFormula1()
The formula used to evaluate the first operand for the conditional formatting rule.

If the condition type is ConditionType.CELL_VALUE_IS, this field is the first operand of the comparison. If type is ConditionType.FORMULA, this formula is used to determine if the conditional formatting is applied.

If comparison type is ConditionType.FORMULA the formula MUST be a Boolean function

Specified by:
getFormula1 in interface ConditionalFormattingRule
Returns:
the first formula

getFormula2

public java.lang.String getFormula2()
The formula used to evaluate the second operand of the comparison when comparison type is ConditionType.CELL_VALUE_IS and operator is either ComparisonOperator.BETWEEN or ComparisonOperator.NOT_BETWEEN

Specified by:
getFormula2 in interface ConditionalFormattingRule
Returns:
the second formula

getStripeSize

public int getStripeSize()
Conditional format rules don't define stripes, so always 0

Specified by:
getStripeSize in interface DifferentialStyleProvider
See Also:
DifferentialStyleProvider.getStripeSize()