defaultintervalcategorydataset.html

jfreechart1。0。2的api。

<FONT color="green">460</FONT>    <a name="line.460"></a>
<FONT color="green">461</FONT>        /**<a name="line.461"></a>
<FONT color="green">462</FONT>         * Returns the end data value for one category in a series.<a name="line.462"></a>
<FONT color="green">463</FONT>         *<a name="line.463"></a>
<FONT color="green">464</FONT>         * @param series  the required series.<a name="line.464"></a>
<FONT color="green">465</FONT>         * @param category  the required category.<a name="line.465"></a>
<FONT color="green">466</FONT>         *<a name="line.466"></a>
<FONT color="green">467</FONT>         * @return The end data value for one category in a series (null possible).<a name="line.467"></a>
<FONT color="green">468</FONT>         */<a name="line.468"></a>
<FONT color="green">469</FONT>        public Number getEndValue(Comparable series, Comparable category) {<a name="line.469"></a>
<FONT color="green">470</FONT>            int seriesIndex = getSeriesIndex(series);<a name="line.470"></a>
<FONT color="green">471</FONT>            int itemIndex = getColumnIndex(category);<a name="line.471"></a>
<FONT color="green">472</FONT>            return getEndValue(seriesIndex, itemIndex);<a name="line.472"></a>
<FONT color="green">473</FONT>        }<a name="line.473"></a>
<FONT color="green">474</FONT>    <a name="line.474"></a>
<FONT color="green">475</FONT>        /**<a name="line.475"></a>
<FONT color="green">476</FONT>         * Returns the end data value for one category in a series.<a name="line.476"></a>
<FONT color="green">477</FONT>         *<a name="line.477"></a>
<FONT color="green">478</FONT>         * @param series  the required series (zero based index).<a name="line.478"></a>
<FONT color="green">479</FONT>         * @param category  the required category.<a name="line.479"></a>
<FONT color="green">480</FONT>         *<a name="line.480"></a>
<FONT color="green">481</FONT>         * @return The end data value for one category in a series (null possible).<a name="line.481"></a>
<FONT color="green">482</FONT>         */<a name="line.482"></a>
<FONT color="green">483</FONT>        public Number getEndValue(int series, int category) {<a name="line.483"></a>
<FONT color="green">484</FONT>    <a name="line.484"></a>
<FONT color="green">485</FONT>            // check arguments...<a name="line.485"></a>
<FONT color="green">486</FONT>            if ((series &lt; 0) || (series &gt;= getSeriesCount())) {<a name="line.486"></a>
<FONT color="green">487</FONT>                throw new IllegalArgumentException(<a name="line.487"></a>
<FONT color="green">488</FONT>                    "DefaultIntervalCategoryDataset.getValue(): "<a name="line.488"></a>
<FONT color="green">489</FONT>                    + "series index out of range.");<a name="line.489"></a>
<FONT color="green">490</FONT>            }<a name="line.490"></a>
<FONT color="green">491</FONT>    <a name="line.491"></a>
<FONT color="green">492</FONT>            if ((category &lt; 0) || (category &gt;= getCategoryCount())) {<a name="line.492"></a>
<FONT color="green">493</FONT>                throw new IllegalArgumentException(<a name="line.493"></a>
<FONT color="green">494</FONT>                    "DefaultIntervalCategoryDataset.getValue(): "<a name="line.494"></a>
<FONT color="green">495</FONT>                    + "category index out of range.");<a name="line.495"></a>
<FONT color="green">496</FONT>            }<a name="line.496"></a>
<FONT color="green">497</FONT>    <a name="line.497"></a>
<FONT color="green">498</FONT>            // fetch the value...<a name="line.498"></a>
<FONT color="green">499</FONT>            return this.endData[series][category];<a name="line.499"></a>
<FONT color="green">500</FONT>    <a name="line.500"></a>
<FONT color="green">501</FONT>        }<a name="line.501"></a>
<FONT color="green">502</FONT>    <a name="line.502"></a>
<FONT color="green">503</FONT>        /**<a name="line.503"></a>
<FONT color="green">504</FONT>         * Sets the start data value for one category in a series.<a name="line.504"></a>
<FONT color="green">505</FONT>         * <a name="line.505"></a>
<FONT color="green">506</FONT>         * @param series  the series (zero-based index).<a name="line.506"></a>
<FONT color="green">507</FONT>         * @param category  the category.<a name="line.507"></a>
<FONT color="green">508</FONT>         * <a name="line.508"></a>
<FONT color="green">509</FONT>         * @param value The value.<a name="line.509"></a>
<FONT color="green">510</FONT>         */<a name="line.510"></a>
<FONT color="green">511</FONT>        public void setStartValue(int series, Comparable category, Number value) {<a name="line.511"></a>
<FONT color="green">512</FONT>    <a name="line.512"></a>
<FONT color="green">513</FONT>            // does the series exist?<a name="line.513"></a>
<FONT color="green">514</FONT>            if ((series &lt; 0) || (series &gt; getSeriesCount())) {<a name="line.514"></a>
<FONT color="green">515</FONT>                throw new IllegalArgumentException(<a name="line.515"></a>
<FONT color="green">516</FONT>                    "DefaultIntervalCategoryDataset.setValue: "<a name="line.516"></a>
<FONT color="green">517</FONT>                    + "series outside valid range.");<a name="line.517"></a>
<FONT color="green">518</FONT>            }<a name="line.518"></a>
<FONT color="green">519</FONT>    <a name="line.519"></a>
<FONT color="green">520</FONT>            // is the category valid?<a name="line.520"></a>
<FONT color="green">521</FONT>            int categoryIndex = getCategoryIndex(category);<a name="line.521"></a>
<FONT color="green">522</FONT>            if (categoryIndex &lt; 0) {<a name="line.522"></a>
<FONT color="green">523</FONT>                throw new IllegalArgumentException(<a name="line.523"></a>
<FONT color="green">524</FONT>                    "DefaultIntervalCategoryDataset.setValue: "<a name="line.524"></a>
<FONT color="green">525</FONT>                    + "unrecognised category.");<a name="line.525"></a>
<FONT color="green">526</FONT>            }<a name="line.526"></a>
<FONT color="green">527</FONT>    <a name="line.527"></a>
<FONT color="green">528</FONT>            // update the data...<a name="line.528"></a>
<FONT color="green">529</FONT>            this.startData[series][categoryIndex] = value;<a name="line.529"></a>
<FONT color="green">530</FONT>            fireDatasetChanged();<a name="line.530"></a>
<FONT color="green">531</FONT>    <a name="line.531"></a>
<FONT color="green">532</FONT>        }<a name="line.532"></a>
<FONT color="green">533</FONT>    <a name="line.533"></a>
<FONT color="green">534</FONT>        /**<a name="line.534"></a>
<FONT color="green">535</FONT>         * Sets the end data value for one category in a series.<a name="line.535"></a>
<FONT color="green">536</FONT>         *<a name="line.536"></a>
<FONT color="green">537</FONT>         * @param series  the series (zero-based index).<a name="line.537"></a>
<FONT color="green">538</FONT>         * @param category  the category.<a name="line.538"></a>
<FONT color="green">539</FONT>         *<a name="line.539"></a>
<FONT color="green">540</FONT>         * @param value the value.<a name="line.540"></a>
<FONT color="green">541</FONT>         */<a name="line.541"></a>
<FONT color="green">542</FONT>        public void setEndValue(int series, Comparable category, Number value) {<a name="line.542"></a>
<FONT color="green">543</FONT>    <a name="line.543"></a>
<FONT color="green">544</FONT>            // does the series exist?<a name="line.544"></a>
<FONT color="green">545</FONT>            if ((series &lt; 0) || (series &gt; getSeriesCount())) {<a name="line.545"></a>
<FONT color="green">546</FONT>                throw new IllegalArgumentException(<a name="line.546"></a>
<FONT color="green">547</FONT>                    "DefaultIntervalCategoryDataset.setValue: "<a name="line.547"></a>
<FONT color="green">548</FONT>                    + "series outside valid range.");<a name="line.548"></a>
<FONT color="green">549</FONT>            }<a name="line.549"></a>
<FONT color="green">550</FONT>    <a name="line.550"></a>
<FONT color="green">551</FONT>            // is the category valid?<a name="line.551"></a>
<FONT color="green">552</FONT>            int categoryIndex = getCategoryIndex(category);<a name="line.552"></a>
<FONT color="green">553</FONT>            if (categoryIndex &lt; 0) {<a name="line.553"></a>
<FONT color="green">554</FONT>                throw new IllegalArgumentException(<a name="line.554"></a>
<FONT color="green">555</FONT>                    "DefaultIntervalCategoryDataset.setValue: "<a name="line.555"></a>
<FONT color="green">556</FONT>                    + "unrecognised category.");<a name="line.556"></a>
<FONT color="green">557</FONT>            }<a name="line.557"></a>
<FONT color="green">558</FONT>    <a name="line.558"></a>
<FONT color="green">559</FONT>            // update the data...<a name="line.559"></a>
<FONT color="green">560</FONT>            this.endData[series][categoryIndex] = value;<a name="line.560"></a>
<FONT color="green">561</FONT>            fireDatasetChanged();<a name="line.561"></a>
<FONT color="green">562</FONT>    <a name="line.562"></a>
<FONT color="green">563</FONT>        }<a name="line.563"></a>
<FONT color="green">564</FONT>    <a name="line.564"></a>
<FONT color="green">565</FONT>        /**<a name="line.565"></a>
<FONT color="green">566</FONT>         * Returns the index for the given category.<a name="line.566"></a>
<FONT color="green">567</FONT>         *<a name="line.567"></a>
<FONT color="green">568</FONT>         * @param category  the category.<a name="line.568"></a>
<FONT color="green">569</FONT>         *<a name="line.569"></a>
<FONT color="green">570</FONT>         * @return The index.<a name="line.570"></a>
<FONT color="green">571</FONT>         */<a name="line.571"></a>
<FONT color="green">572</FONT>        private int getCategoryIndex(Comparable category) {<a name="line.572"></a>
<FONT color="green">573</FONT>            int result = -1;<a name="line.573"></a>
<FONT color="green">574</FONT>            for (int i = 0; i &lt; this.categoryKeys.length; i++) {<a name="line.574"></a>
<FONT color="green">575</FONT>                if (category.equals(this.categoryKeys[i])) {<a name="line.575"></a>
<FONT color="green">576</FONT>                    result = i;<a name="line.576"></a>
<FONT color="green">577</FONT>                    break;<a name="line.577"></a>
<FONT color="green">578</FONT>                }<a name="line.578"></a>
<FONT color="green">579</FONT>            }<a name="line.579"></a>
<FONT color="green">580</FONT>            return result;<a name="line.580"></a>
<FONT color="green">581</FONT>        }<a name="line.581"></a>
<FONT color="green">582</FONT>    <a name="line.582"></a>
<FONT color="green">583</FONT>        /**<a name="line.583"></a>
<FONT color="green">584</FONT>         * Generates an array of keys, by appending a space plus an integer<a name="line.584"></a>
<FONT color="green">585</FONT>         * (starting with 1) to the supplied prefix string.<a name="line.585"></a>
<FONT color="green">586</FONT>         *<a name="line.586"></a>
<FONT color="green">587</FONT>         * @param count  the number of keys required.<a name="line.587"></a>
<FONT color="green">588</FONT>         * @param prefix  the name prefix.<a name="line.588"></a>
<FONT color="green">589</FONT>         *<a name="line.589"></a>
<FONT color="green">590</FONT>         * @return An array of &lt;i&gt;prefixN&lt;/i&gt; with N = { 1 .. count}.<a name="line.590"></a>
<FONT color="green">591</FONT>         */<a name="line.591"></a>
<FONT color="green">592</FONT>        private Comparable[] generateKeys(int count, String prefix) {<a name="line.592"></a>
<FONT color="green">593</FONT>            Comparable[] result = new Comparable[count];<a name="line.593"></a>
<FONT color="green">594</FONT>            String name;<a name="line.594"></a>
<FONT color="green">595</FONT>            for (int i = 0; i &lt; count; i++) {<a name="line.595"></a>
<FONT color="green">596</FONT>                name = prefix + (i + 1);<a name="line.596"></a>
<FONT color="green">597</FONT>                result[i] = name;<a name="line.597"></a>
<FONT color="green">598</FONT>            }<a name="line.598"></a>
<FONT color="green">599</FONT>            return result;<a name="line.599"></a>
<FONT color="green">600</FONT>        }<a name="line.600"></a>
<FONT color="green">601</FONT>    <a name="line.601"></a>
<FONT color="green">602</FONT>        /**<a name="line.602"></a>
<FONT color="green">603</FONT>         * Returns a column key.<a name="line.603"></a>
<FONT color="green">604</FONT>         *<a name="line.604"></a>
<FONT color="green">605</FONT>         * @param column  the column index.<a name="line.605"></a>
<FONT color="green">606</FONT>         *<a name="line.606"></a>
<FONT color="green">607</FONT>         * @return The column key.<a name="line.607"></a>
<FONT color="green">608</FONT>         */<a name="line.608"></a>
<FONT color="green">609</FONT>        public Comparable getColumnKey(int column) {<a name="line.609"></a>
<FONT color="green">610</FONT>            return this.categoryKeys[column];<a name="line.610"></a>
<FONT color="green">611</FONT>        }<a name="line.611"></a>
<FONT color="green">612</FONT>    <a name="line.612"></a>
<FONT color="green">613</FONT>        /**<a name="line.613"></a>