timeseriescollection.html

jfreechart1。0。2的api。

<FONT color="green">352</FONT>        /**<a name="line.352"></a>
<FONT color="green">353</FONT>         * Removes all the series from the collection and sends a <a name="line.353"></a>
<FONT color="green">354</FONT>         * {@link DatasetChangeEvent} to all registered listeners.<a name="line.354"></a>
<FONT color="green">355</FONT>         */<a name="line.355"></a>
<FONT color="green">356</FONT>        public void removeAllSeries() {<a name="line.356"></a>
<FONT color="green">357</FONT>    <a name="line.357"></a>
<FONT color="green">358</FONT>            // deregister the collection as a change listener to each series in the<a name="line.358"></a>
<FONT color="green">359</FONT>            // collection<a name="line.359"></a>
<FONT color="green">360</FONT>            for (int i = 0; i &lt; this.data.size(); i++) {<a name="line.360"></a>
<FONT color="green">361</FONT>                TimeSeries series = (TimeSeries) this.data.get(i);<a name="line.361"></a>
<FONT color="green">362</FONT>                series.removeChangeListener(this);<a name="line.362"></a>
<FONT color="green">363</FONT>            }<a name="line.363"></a>
<FONT color="green">364</FONT>    <a name="line.364"></a>
<FONT color="green">365</FONT>            // remove all the series from the collection and notify listeners.<a name="line.365"></a>
<FONT color="green">366</FONT>            this.data.clear();<a name="line.366"></a>
<FONT color="green">367</FONT>            fireDatasetChanged();<a name="line.367"></a>
<FONT color="green">368</FONT>    <a name="line.368"></a>
<FONT color="green">369</FONT>        }<a name="line.369"></a>
<FONT color="green">370</FONT>    <a name="line.370"></a>
<FONT color="green">371</FONT>        /**<a name="line.371"></a>
<FONT color="green">372</FONT>         * Returns the number of items in the specified series.  This method is <a name="line.372"></a>
<FONT color="green">373</FONT>         * provided for convenience.<a name="line.373"></a>
<FONT color="green">374</FONT>         *<a name="line.374"></a>
<FONT color="green">375</FONT>         * @param series  the series index (zero-based).<a name="line.375"></a>
<FONT color="green">376</FONT>         *<a name="line.376"></a>
<FONT color="green">377</FONT>         * @return The item count.<a name="line.377"></a>
<FONT color="green">378</FONT>         */<a name="line.378"></a>
<FONT color="green">379</FONT>        public int getItemCount(int series) {<a name="line.379"></a>
<FONT color="green">380</FONT>            return getSeries(series).getItemCount();<a name="line.380"></a>
<FONT color="green">381</FONT>        }<a name="line.381"></a>
<FONT color="green">382</FONT>        <a name="line.382"></a>
<FONT color="green">383</FONT>        /**<a name="line.383"></a>
<FONT color="green">384</FONT>         * Returns the x-value (as a double primitive) for an item within a series.<a name="line.384"></a>
<FONT color="green">385</FONT>         * <a name="line.385"></a>
<FONT color="green">386</FONT>         * @param series  the series (zero-based index).<a name="line.386"></a>
<FONT color="green">387</FONT>         * @param item  the item (zero-based index).<a name="line.387"></a>
<FONT color="green">388</FONT>         * <a name="line.388"></a>
<FONT color="green">389</FONT>         * @return The x-value.<a name="line.389"></a>
<FONT color="green">390</FONT>         */<a name="line.390"></a>
<FONT color="green">391</FONT>        public double getXValue(int series, int item) {<a name="line.391"></a>
<FONT color="green">392</FONT>            TimeSeries s = (TimeSeries) this.data.get(series);<a name="line.392"></a>
<FONT color="green">393</FONT>            TimeSeriesDataItem i = s.getDataItem(item);<a name="line.393"></a>
<FONT color="green">394</FONT>            RegularTimePeriod period = i.getPeriod();<a name="line.394"></a>
<FONT color="green">395</FONT>            return getX(period);<a name="line.395"></a>
<FONT color="green">396</FONT>        }<a name="line.396"></a>
<FONT color="green">397</FONT>    <a name="line.397"></a>
<FONT color="green">398</FONT>        /**<a name="line.398"></a>
<FONT color="green">399</FONT>         * Returns the x-value for the specified series and item.<a name="line.399"></a>
<FONT color="green">400</FONT>         *<a name="line.400"></a>
<FONT color="green">401</FONT>         * @param series  the series (zero-based index).<a name="line.401"></a>
<FONT color="green">402</FONT>         * @param item  the item (zero-based index).<a name="line.402"></a>
<FONT color="green">403</FONT>         *<a name="line.403"></a>
<FONT color="green">404</FONT>         * @return The value.<a name="line.404"></a>
<FONT color="green">405</FONT>         */<a name="line.405"></a>
<FONT color="green">406</FONT>        public Number getX(int series, int item) {<a name="line.406"></a>
<FONT color="green">407</FONT>            TimeSeries ts = (TimeSeries) this.data.get(series);<a name="line.407"></a>
<FONT color="green">408</FONT>            TimeSeriesDataItem dp = ts.getDataItem(item);<a name="line.408"></a>
<FONT color="green">409</FONT>            RegularTimePeriod period = dp.getPeriod();<a name="line.409"></a>
<FONT color="green">410</FONT>            return new Long(getX(period));<a name="line.410"></a>
<FONT color="green">411</FONT>        }<a name="line.411"></a>
<FONT color="green">412</FONT>        <a name="line.412"></a>
<FONT color="green">413</FONT>        /**<a name="line.413"></a>
<FONT color="green">414</FONT>         * Returns the x-value for a time period.<a name="line.414"></a>
<FONT color="green">415</FONT>         *<a name="line.415"></a>
<FONT color="green">416</FONT>         * @param period  the time period.<a name="line.416"></a>
<FONT color="green">417</FONT>         *<a name="line.417"></a>
<FONT color="green">418</FONT>         * @return The x-value.<a name="line.418"></a>
<FONT color="green">419</FONT>         */<a name="line.419"></a>
<FONT color="green">420</FONT>        protected synchronized long getX(RegularTimePeriod period) {<a name="line.420"></a>
<FONT color="green">421</FONT>            long result = 0L;<a name="line.421"></a>
<FONT color="green">422</FONT>            if (this.xPosition == TimePeriodAnchor.START) {<a name="line.422"></a>
<FONT color="green">423</FONT>                result = period.getFirstMillisecond(this.workingCalendar);<a name="line.423"></a>
<FONT color="green">424</FONT>            }<a name="line.424"></a>
<FONT color="green">425</FONT>            else if (this.xPosition == TimePeriodAnchor.MIDDLE) {<a name="line.425"></a>
<FONT color="green">426</FONT>                result = period.getMiddleMillisecond(this.workingCalendar);<a name="line.426"></a>
<FONT color="green">427</FONT>            }<a name="line.427"></a>
<FONT color="green">428</FONT>            else if (this.xPosition == TimePeriodAnchor.END) {<a name="line.428"></a>
<FONT color="green">429</FONT>                result = period.getLastMillisecond(this.workingCalendar); <a name="line.429"></a>
<FONT color="green">430</FONT>            }<a name="line.430"></a>
<FONT color="green">431</FONT>            return result;<a name="line.431"></a>
<FONT color="green">432</FONT>        }<a name="line.432"></a>
<FONT color="green">433</FONT>    <a name="line.433"></a>
<FONT color="green">434</FONT>        /**<a name="line.434"></a>
<FONT color="green">435</FONT>         * Returns the starting X value for the specified series and item.<a name="line.435"></a>
<FONT color="green">436</FONT>         *<a name="line.436"></a>
<FONT color="green">437</FONT>         * @param series  the series (zero-based index).<a name="line.437"></a>
<FONT color="green">438</FONT>         * @param item  the item (zero-based index).<a name="line.438"></a>
<FONT color="green">439</FONT>         *<a name="line.439"></a>
<FONT color="green">440</FONT>         * @return The value.<a name="line.440"></a>
<FONT color="green">441</FONT>         */<a name="line.441"></a>
<FONT color="green">442</FONT>        public synchronized Number getStartX(int series, int item) {<a name="line.442"></a>
<FONT color="green">443</FONT>            TimeSeries ts = (TimeSeries) this.data.get(series);<a name="line.443"></a>
<FONT color="green">444</FONT>            TimeSeriesDataItem dp = ts.getDataItem(item);<a name="line.444"></a>
<FONT color="green">445</FONT>            return new Long(dp.getPeriod().getFirstMillisecond(<a name="line.445"></a>
<FONT color="green">446</FONT>                    this.workingCalendar));<a name="line.446"></a>
<FONT color="green">447</FONT>        }<a name="line.447"></a>
<FONT color="green">448</FONT>    <a name="line.448"></a>
<FONT color="green">449</FONT>        /**<a name="line.449"></a>
<FONT color="green">450</FONT>         * Returns the ending X value for the specified series and item.<a name="line.450"></a>
<FONT color="green">451</FONT>         *<a name="line.451"></a>
<FONT color="green">452</FONT>         * @param series The series (zero-based index).<a name="line.452"></a>
<FONT color="green">453</FONT>         * @param item  The item (zero-based index).<a name="line.453"></a>
<FONT color="green">454</FONT>         *<a name="line.454"></a>
<FONT color="green">455</FONT>         * @return The value.<a name="line.455"></a>
<FONT color="green">456</FONT>         */<a name="line.456"></a>
<FONT color="green">457</FONT>        public synchronized Number getEndX(int series, int item) {<a name="line.457"></a>
<FONT color="green">458</FONT>            TimeSeries ts = (TimeSeries) this.data.get(series);<a name="line.458"></a>
<FONT color="green">459</FONT>            TimeSeriesDataItem dp = ts.getDataItem(item);<a name="line.459"></a>
<FONT color="green">460</FONT>            return new Long(dp.getPeriod().getLastMillisecond(<a name="line.460"></a>
<FONT color="green">461</FONT>                    this.workingCalendar));<a name="line.461"></a>
<FONT color="green">462</FONT>        }<a name="line.462"></a>
<FONT color="green">463</FONT>    <a name="line.463"></a>
<FONT color="green">464</FONT>        /**<a name="line.464"></a>
<FONT color="green">465</FONT>         * Returns the y-value for the specified series and item.<a name="line.465"></a>
<FONT color="green">466</FONT>         *<a name="line.466"></a>
<FONT color="green">467</FONT>         * @param series  the series (zero-based index).<a name="line.467"></a>
<FONT color="green">468</FONT>         * @param item  the item (zero-based index).<a name="line.468"></a>
<FONT color="green">469</FONT>         *<a name="line.469"></a>
<FONT color="green">470</FONT>         * @return The value (possibly &lt;code&gt;null&lt;/code&gt;).<a name="line.470"></a>
<FONT color="green">471</FONT>         */<a name="line.471"></a>
<FONT color="green">472</FONT>        public Number getY(int series, int item) {<a name="line.472"></a>
<FONT color="green">473</FONT>            TimeSeries ts = (TimeSeries) this.data.get(series);<a name="line.473"></a>
<FONT color="green">474</FONT>            TimeSeriesDataItem dp = ts.getDataItem(item);<a name="line.474"></a>
<FONT color="green">475</FONT>            return dp.getValue();<a name="line.475"></a>
<FONT color="green">476</FONT>        }<a name="line.476"></a>
<FONT color="green">477</FONT>    <a name="line.477"></a>
<FONT color="green">478</FONT>        /**<a name="line.478"></a>
<FONT color="green">479</FONT>         * Returns the starting Y value for the specified series and item.<a name="line.479"></a>
<FONT color="green">480</FONT>         *<a name="line.480"></a>
<FONT color="green">481</FONT>         * @param series  the series (zero-based index).<a name="line.481"></a>
<FONT color="green">482</FONT>         * @param item  the item (zero-based index).<a name="line.482"></a>
<FONT color="green">483</FONT>         *<a name="line.483"></a>
<FONT color="green">484</FONT>         * @return The value (possibly &lt;code&gt;null&lt;/code&gt;).<a name="line.484"></a>
<FONT color="green">485</FONT>         */<a name="line.485"></a>
<FONT color="green">486</FONT>        public Number getStartY(int series, int item) {<a name="line.486"></a>
<FONT color="green">487</FONT>            return getY(series, item);<a name="line.487"></a>
<FONT color="green">488</FONT>        }<a name="line.488"></a>
<FONT color="green">489</FONT>    <a name="line.489"></a>
<FONT color="green">490</FONT>        /**<a name="line.490"></a>
<FONT color="green">491</FONT>         * Returns the ending Y value for the specified series and item.<a name="line.491"></a>
<FONT color="green">492</FONT>         *<a name="line.492"></a>
<FONT color="green">493</FONT>         * @param series  te series (zero-based index).<a name="line.493"></a>
<FONT color="green">494</FONT>         * @param item  the item (zero-based index).<a name="line.494"></a>
<FONT color="green">495</FONT>         *<a name="line.495"></a>
<FONT color="green">496</FONT>         * @return The value (possibly &lt;code&gt;null&lt;/code&gt;).<a name="line.496"></a>
<FONT color="green">497</FONT>         */<a name="line.497"></a>
<FONT color="green">498</FONT>        public Number getEndY(int series, int item) {<a name="line.498"></a>
<FONT color="green">499</FONT>            return getY(series, item);<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>         * Returns the indices of the two data items surrounding a particular <a name="line.504"></a>
<FONT color="green">505</FONT>         * millisecond value.  <a name="line.505"></a>
<FONT color="green">506</FONT>         * <a name="line.506"></a>
<FONT color="green">507</FONT>         * @param series  the series index.<a name="line.507"></a>
<FONT color="green">508</FONT>         * @param milliseconds  the time.<a name="line.508"></a>
<FONT color="green">509</FONT>         * <a name="line.509"></a>
<FONT color="green">510</FONT>         * @return An array containing the (two) indices of the items surrounding <a name="line.510"></a>
<FONT color="green">511</FONT>         *         the time.<a name="line.511"></a>
<FONT color="green">512</FONT>         */<a name="line.512"></a>
<FONT color="green">513</FONT>        public int[] getSurroundingItems(int series, long milliseconds) {<a name="line.513"></a>
<FONT color="green">514</FONT>            int[] result = new int[] {-1, -1};<a name="line.514"></a>
<FONT color="green">515</FONT>            TimeSeries timeSeries = getSeries(series);<a name="line.515"></a>
<FONT color="green">516</FONT>            for (int i = 0; i &lt; timeSeries.getItemCount(); i++) {<a name="line.516"></a>
<FONT color="green">517</FONT>                Number x = getX(series, i);<a name="line.517"></a>
<FONT color="green">518</FONT>                long m = x.longValue();<a name="line.518"></a>
<FONT color="green">519</FONT>                if (m &lt;= milliseconds) {<a name="line.519"></a>
<FONT color="green">520</FONT>                    result[0] = i;<a name="line.520"></a>
<FONT color="green">521</FONT>                }<a name="line.521"></a>
<FONT color="green">522</FONT>                if (m &gt;= milliseconds) {<a name="line.522"></a>
<FONT color="green">523</FONT>                    result[1] = i;<a name="line.523"></a>
<FONT color="green">524</FONT>                    break;<a name="line.524"></a>
<FONT color="green">525</FONT>                }<a name="line.525"></a>
<FONT color="green">526</FONT>            }<a name="line.526"></a>
<FONT color="green">527</FONT>            return result;<a name="line.527"></a>
<FONT color="green">528</FONT>        }<a name="line.528"></a>