You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@poi.apache.org by ni...@apache.org on 2015/07/18 06:51:52 UTC

svn commit: r1691676 - in /poi/trunk/src/java/org/apache/poi/ss/usermodel: ColorScaleFormatting.java DataBarFormatting.java

Author: nick
Date: Sat Jul 18 04:51:51 2015
New Revision: 1691676

URL: http://svn.apache.org/r1691676
Log:
#58130 Interface defintions for two more CF types

Added:
    poi/trunk/src/java/org/apache/poi/ss/usermodel/ColorScaleFormatting.java
    poi/trunk/src/java/org/apache/poi/ss/usermodel/DataBarFormatting.java

Added: poi/trunk/src/java/org/apache/poi/ss/usermodel/ColorScaleFormatting.java
URL: http://svn.apache.org/viewvc/poi/trunk/src/java/org/apache/poi/ss/usermodel/ColorScaleFormatting.java?rev=1691676&view=auto
==============================================================================
--- poi/trunk/src/java/org/apache/poi/ss/usermodel/ColorScaleFormatting.java (added)
+++ poi/trunk/src/java/org/apache/poi/ss/usermodel/ColorScaleFormatting.java Sat Jul 18 04:51:51 2015
@@ -0,0 +1,66 @@
+/*
+ *  ====================================================================
+ *    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.ss.usermodel;
+
+import org.apache.poi.hssf.record.cf.Threshold;
+
+/**
+ * High level representation for the Color Scale / Colour Scale /
+ *  Color Gradient Formatting component of Conditional Formatting settings
+ */
+public interface ColorScaleFormatting {
+    /**
+     * How many control points should be used to map 
+     *  the colours? Normally 2 or 3
+     */
+    int getNumControlPoints();
+    /**
+     * Sets the number of control points to use to map
+     *  the colours. Should normally be 2 or 3.
+     * <p>After updating, you need to ensure that the
+     *  {@link Threshold} count and Color count match
+     */
+    void setNumControlPoints(int num);
+
+    /**
+     * Gets the list of colours that are interpolated
+     *  between.
+     */
+    Color[] getColors();
+    /**
+     * Sets the list of colours that are interpolated
+     *  between. The number must match {@link #getNumControlPoints()}
+     */
+    void setColors(Color[] colors);
+    
+    /**
+     * Gets the list of thresholds
+     */
+    ConditionalFormattingThreshold[] getThresholds();
+    /**
+     * Sets the of thresholds. The number must match
+     *  {@link #getNumControlPoints()}
+     */
+    void setThresholds(ConditionalFormattingThreshold[] thresholds);
+    /**
+     * Creates a new, empty Threshold
+     */
+    ConditionalFormattingThreshold createThreshold();
+}

Added: poi/trunk/src/java/org/apache/poi/ss/usermodel/DataBarFormatting.java
URL: http://svn.apache.org/viewvc/poi/trunk/src/java/org/apache/poi/ss/usermodel/DataBarFormatting.java?rev=1691676&view=auto
==============================================================================
--- poi/trunk/src/java/org/apache/poi/ss/usermodel/DataBarFormatting.java (added)
+++ poi/trunk/src/java/org/apache/poi/ss/usermodel/DataBarFormatting.java Sat Jul 18 04:51:51 2015
@@ -0,0 +1,72 @@
+/*
+ *  ====================================================================
+ *    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.ss.usermodel;
+
+/**
+ * High level representation for the DataBar Formatting 
+ *  component of Conditional Formatting settings
+ */
+public interface DataBarFormatting {
+    /**
+     * Is the bar drawn from Left-to-Right, or from
+     *  Right-to-Left
+     */
+    boolean isLeftToRight();
+    /**
+     * Control if the bar is drawn from Left-to-Right,
+     *  or from Right-to-Left
+     */
+    void setLeftToRight(boolean ltr);
+    
+    /**
+     * Should Icon + Value be displayed, or only the Icon?
+     */
+    boolean isIconOnly();
+    /**
+     * Control if only the Icon is shown, or Icon + Value
+     */
+    void setIconOnly(boolean only);
+    
+    /**
+     * How much of the cell width, in %, should be given to
+     *  the min value?
+     */
+    int getWidthMin();
+    void setWidthMin(int width);
+    
+    /**
+     * How much of the cell width, in %, should be given to
+     *  the max value?
+     */
+    int getWidthMax();
+    void setWidthMax(int width);
+    
+    Color getColor();
+    void setColor(Color color);
+    
+    /**
+     * The threshold that defines "everything from here down is minimum"
+     */
+    ConditionalFormattingThreshold getMinThreshold();
+    /**
+     * The threshold that defines "everything from here up is maximum"
+     */
+    ConditionalFormattingThreshold getMaxThreshold();
+}



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org