xyseries.html

jfreechart1。0。2的api。

<FONT color="green">448</FONT>         * Returns the x-value at the specified index.<a name="line.448"></a>
<FONT color="green">449</FONT>         *<a name="line.449"></a>
<FONT color="green">450</FONT>         * @param index  the index (zero-based).<a name="line.450"></a>
<FONT color="green">451</FONT>         *<a name="line.451"></a>
<FONT color="green">452</FONT>         * @return The x-value (never &lt;code&gt;null&lt;/code&gt;).<a name="line.452"></a>
<FONT color="green">453</FONT>         */<a name="line.453"></a>
<FONT color="green">454</FONT>        public Number getX(int index) {<a name="line.454"></a>
<FONT color="green">455</FONT>            return getDataItem(index).getX();<a name="line.455"></a>
<FONT color="green">456</FONT>        }<a name="line.456"></a>
<FONT color="green">457</FONT>    <a name="line.457"></a>
<FONT color="green">458</FONT>        /**<a name="line.458"></a>
<FONT color="green">459</FONT>         * Returns the y-value at the specified index.<a name="line.459"></a>
<FONT color="green">460</FONT>         *<a name="line.460"></a>
<FONT color="green">461</FONT>         * @param index  the index (zero-based).<a name="line.461"></a>
<FONT color="green">462</FONT>         *<a name="line.462"></a>
<FONT color="green">463</FONT>         * @return The y-value (possibly &lt;code&gt;null&lt;/code&gt;).<a name="line.463"></a>
<FONT color="green">464</FONT>         */<a name="line.464"></a>
<FONT color="green">465</FONT>        public Number getY(int index) {<a name="line.465"></a>
<FONT color="green">466</FONT>            return getDataItem(index).getY();<a name="line.466"></a>
<FONT color="green">467</FONT>        }<a name="line.467"></a>
<FONT color="green">468</FONT>        <a name="line.468"></a>
<FONT color="green">469</FONT>        /**<a name="line.469"></a>
<FONT color="green">470</FONT>         * Updates the value of an item in the series and sends a <a name="line.470"></a>
<FONT color="green">471</FONT>         * {@link SeriesChangeEvent} to all registered listeners.<a name="line.471"></a>
<FONT color="green">472</FONT>         *<a name="line.472"></a>
<FONT color="green">473</FONT>         * @param index  the item (zero based index).<a name="line.473"></a>
<FONT color="green">474</FONT>         * @param y  the new value (&lt;code&gt;null&lt;/code&gt; permitted).<a name="line.474"></a>
<FONT color="green">475</FONT>         * <a name="line.475"></a>
<FONT color="green">476</FONT>         * @deprecated Renamed updateByIndex(int, Number) to avoid confusion with<a name="line.476"></a>
<FONT color="green">477</FONT>         *             the update(Number, Number) method.<a name="line.477"></a>
<FONT color="green">478</FONT>         */<a name="line.478"></a>
<FONT color="green">479</FONT>        public void update(int index, Number y) {<a name="line.479"></a>
<FONT color="green">480</FONT>            XYDataItem item = getDataItem(index);<a name="line.480"></a>
<FONT color="green">481</FONT>            item.setY(y);<a name="line.481"></a>
<FONT color="green">482</FONT>            fireSeriesChanged();<a name="line.482"></a>
<FONT color="green">483</FONT>        }<a name="line.483"></a>
<FONT color="green">484</FONT>        <a name="line.484"></a>
<FONT color="green">485</FONT>        /**<a name="line.485"></a>
<FONT color="green">486</FONT>         * Updates the value of an item in the series and sends a <a name="line.486"></a>
<FONT color="green">487</FONT>         * {@link SeriesChangeEvent} to all registered listeners.<a name="line.487"></a>
<FONT color="green">488</FONT>         * <a name="line.488"></a>
<FONT color="green">489</FONT>         * @param index  the item (zero based index).<a name="line.489"></a>
<FONT color="green">490</FONT>         * @param y  the new value (&lt;code&gt;null&lt;/code&gt; permitted).<a name="line.490"></a>
<FONT color="green">491</FONT>         * <a name="line.491"></a>
<FONT color="green">492</FONT>         * @since 1.0.1<a name="line.492"></a>
<FONT color="green">493</FONT>         */<a name="line.493"></a>
<FONT color="green">494</FONT>        public void updateByIndex(int index, Number y) {<a name="line.494"></a>
<FONT color="green">495</FONT>            update(index, y);<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>        /**<a name="line.498"></a>
<FONT color="green">499</FONT>         * Updates an item in the series.<a name="line.499"></a>
<FONT color="green">500</FONT>         * <a name="line.500"></a>
<FONT color="green">501</FONT>         * @param x  the x-value (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.501"></a>
<FONT color="green">502</FONT>         * @param y  the y-value (&lt;code&gt;null&lt;/code&gt; permitted).<a name="line.502"></a>
<FONT color="green">503</FONT>         * <a name="line.503"></a>
<FONT color="green">504</FONT>         * @throws SeriesException if there is no existing item with the specified<a name="line.504"></a>
<FONT color="green">505</FONT>         *         x-value.<a name="line.505"></a>
<FONT color="green">506</FONT>         */<a name="line.506"></a>
<FONT color="green">507</FONT>        public void update(Number x, Number y) {<a name="line.507"></a>
<FONT color="green">508</FONT>            int index = indexOf(x);<a name="line.508"></a>
<FONT color="green">509</FONT>            if (index &lt; 0) {<a name="line.509"></a>
<FONT color="green">510</FONT>                throw new SeriesException("No observation for x = " + x);<a name="line.510"></a>
<FONT color="green">511</FONT>            }<a name="line.511"></a>
<FONT color="green">512</FONT>            else {<a name="line.512"></a>
<FONT color="green">513</FONT>                XYDataItem item = getDataItem(index);<a name="line.513"></a>
<FONT color="green">514</FONT>                item.setY(y);<a name="line.514"></a>
<FONT color="green">515</FONT>                fireSeriesChanged();<a name="line.515"></a>
<FONT color="green">516</FONT>            }<a name="line.516"></a>
<FONT color="green">517</FONT>        }<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>         * Adds or updates an item in the series and sends a <a name="line.520"></a>
<FONT color="green">521</FONT>         * {@link org.jfree.data.general.SeriesChangeEvent} to all registered <a name="line.521"></a>
<FONT color="green">522</FONT>         * listeners.<a name="line.522"></a>
<FONT color="green">523</FONT>         *<a name="line.523"></a>
<FONT color="green">524</FONT>         * @param x  the x-value (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.524"></a>
<FONT color="green">525</FONT>         * @param y  the y-value (&lt;code&gt;null&lt;/code&gt; permitted).<a name="line.525"></a>
<FONT color="green">526</FONT>         *<a name="line.526"></a>
<FONT color="green">527</FONT>         * @return A copy of the overwritten data item, or &lt;code&gt;null&lt;/code&gt; if no <a name="line.527"></a>
<FONT color="green">528</FONT>         *         item was overwritten.<a name="line.528"></a>
<FONT color="green">529</FONT>         */<a name="line.529"></a>
<FONT color="green">530</FONT>        public XYDataItem addOrUpdate(Number x, Number y) {<a name="line.530"></a>
<FONT color="green">531</FONT>            if (x == null) {<a name="line.531"></a>
<FONT color="green">532</FONT>                throw new IllegalArgumentException("Null 'x' argument.");   <a name="line.532"></a>
<FONT color="green">533</FONT>            }<a name="line.533"></a>
<FONT color="green">534</FONT>            XYDataItem overwritten = null;<a name="line.534"></a>
<FONT color="green">535</FONT>            int index = indexOf(x);<a name="line.535"></a>
<FONT color="green">536</FONT>            if (index &gt;= 0) {<a name="line.536"></a>
<FONT color="green">537</FONT>                XYDataItem existing = (XYDataItem) this.data.get(index);<a name="line.537"></a>
<FONT color="green">538</FONT>                try {<a name="line.538"></a>
<FONT color="green">539</FONT>                    overwritten = (XYDataItem) existing.clone();<a name="line.539"></a>
<FONT color="green">540</FONT>                }<a name="line.540"></a>
<FONT color="green">541</FONT>                catch (CloneNotSupportedException e) {<a name="line.541"></a>
<FONT color="green">542</FONT>                    throw new SeriesException("Couldn't clone XYDataItem!");   <a name="line.542"></a>
<FONT color="green">543</FONT>                }<a name="line.543"></a>
<FONT color="green">544</FONT>                existing.setY(y);<a name="line.544"></a>
<FONT color="green">545</FONT>            }<a name="line.545"></a>
<FONT color="green">546</FONT>            else {<a name="line.546"></a>
<FONT color="green">547</FONT>                // if the series is sorted, the negative index is a result from<a name="line.547"></a>
<FONT color="green">548</FONT>                // Collections.binarySearch() and tells us where to insert the<a name="line.548"></a>
<FONT color="green">549</FONT>                // new item...otherwise it will be just -1 and we should just<a name="line.549"></a>
<FONT color="green">550</FONT>                // append the value to the list...<a name="line.550"></a>
<FONT color="green">551</FONT>                if (this.autoSort) {<a name="line.551"></a>
<FONT color="green">552</FONT>                    this.data.add(-index - 1, new XYDataItem(x, y));<a name="line.552"></a>
<FONT color="green">553</FONT>                }<a name="line.553"></a>
<FONT color="green">554</FONT>                else {<a name="line.554"></a>
<FONT color="green">555</FONT>                    this.data.add(new XYDataItem(x, y));<a name="line.555"></a>
<FONT color="green">556</FONT>                }<a name="line.556"></a>
<FONT color="green">557</FONT>                // check if this addition will exceed the maximum item count...<a name="line.557"></a>
<FONT color="green">558</FONT>                if (getItemCount() &gt; this.maximumItemCount) {<a name="line.558"></a>
<FONT color="green">559</FONT>                    this.data.remove(0);<a name="line.559"></a>
<FONT color="green">560</FONT>                }<a name="line.560"></a>
<FONT color="green">561</FONT>            }            <a name="line.561"></a>
<FONT color="green">562</FONT>            fireSeriesChanged();<a name="line.562"></a>
<FONT color="green">563</FONT>            return overwritten;<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>        /**<a name="line.566"></a>
<FONT color="green">567</FONT>         * Returns the index of the item with the specified x-value, or a negative <a name="line.567"></a>
<FONT color="green">568</FONT>         * index if the series does not contain an item with that x-value.  Be <a name="line.568"></a>
<FONT color="green">569</FONT>         * aware that for an unsorted series, the index is found by iterating <a name="line.569"></a>
<FONT color="green">570</FONT>         * through all items in the series.<a name="line.570"></a>
<FONT color="green">571</FONT>         * <a name="line.571"></a>
<FONT color="green">572</FONT>         * @param x  the x-value (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.572"></a>
<FONT color="green">573</FONT>         * <a name="line.573"></a>
<FONT color="green">574</FONT>         * @return The index.<a name="line.574"></a>
<FONT color="green">575</FONT>         */<a name="line.575"></a>
<FONT color="green">576</FONT>        public int indexOf(Number x) {<a name="line.576"></a>
<FONT color="green">577</FONT>            if (this.autoSort) {<a name="line.577"></a>
<FONT color="green">578</FONT>                return Collections.binarySearch(this.data, new XYDataItem(x, null));   <a name="line.578"></a>
<FONT color="green">579</FONT>            }<a name="line.579"></a>
<FONT color="green">580</FONT>            else {<a name="line.580"></a>
<FONT color="green">581</FONT>                for (int i = 0; i &lt; this.data.size(); i++) {<a name="line.581"></a>
<FONT color="green">582</FONT>                    XYDataItem item = (XYDataItem) this.data.get(i);<a name="line.582"></a>
<FONT color="green">583</FONT>                    if (item.getX().equals(x)) {<a name="line.583"></a>
<FONT color="green">584</FONT>                        return i;   <a name="line.584"></a>
<FONT color="green">585</FONT>                    }<a name="line.585"></a>
<FONT color="green">586</FONT>                }<a name="line.586"></a>
<FONT color="green">587</FONT>                return -1;<a name="line.587"></a>
<FONT color="green">588</FONT>            }<a name="line.588"></a>
<FONT color="green">589</FONT>        } <a name="line.589"></a>
<FONT color="green">590</FONT>        <a name="line.590"></a>
<FONT color="green">591</FONT>        /**<a name="line.591"></a>
<FONT color="green">592</FONT>         * Returns a clone of the series.<a name="line.592"></a>
<FONT color="green">593</FONT>         *<a name="line.593"></a>
<FONT color="green">594</FONT>         * @return A clone of the time series.<a name="line.594"></a>
<FONT color="green">595</FONT>         * <a name="line.595"></a>
<FONT color="green">596</FONT>         * @throws CloneNotSupportedException if there is a cloning problem.<a name="line.596"></a>
<FONT color="green">597</FONT>         */<a name="line.597"></a>