dateaxis.html

jfreechart1。0。2的api。

<FONT color="green">430</FONT>         *<a name="line.430"></a>
<FONT color="green">431</FONT>         * @return The formatter (possibly &lt;code&gt;null&lt;/code&gt;).<a name="line.431"></a>
<FONT color="green">432</FONT>         */<a name="line.432"></a>
<FONT color="green">433</FONT>        public DateFormat getDateFormatOverride() {<a name="line.433"></a>
<FONT color="green">434</FONT>            return this.dateFormatOverride;<a name="line.434"></a>
<FONT color="green">435</FONT>        }<a name="line.435"></a>
<FONT color="green">436</FONT>    <a name="line.436"></a>
<FONT color="green">437</FONT>        /**<a name="line.437"></a>
<FONT color="green">438</FONT>         * Sets the date format override.  If this is non-null, then it will be <a name="line.438"></a>
<FONT color="green">439</FONT>         * used to format the dates on the axis.<a name="line.439"></a>
<FONT color="green">440</FONT>         *<a name="line.440"></a>
<FONT color="green">441</FONT>         * @param formatter  the date formatter (&lt;code&gt;null&lt;/code&gt; permitted).<a name="line.441"></a>
<FONT color="green">442</FONT>         */<a name="line.442"></a>
<FONT color="green">443</FONT>        public void setDateFormatOverride(DateFormat formatter) {<a name="line.443"></a>
<FONT color="green">444</FONT>            this.dateFormatOverride = formatter;<a name="line.444"></a>
<FONT color="green">445</FONT>            notifyListeners(new AxisChangeEvent(this));<a name="line.445"></a>
<FONT color="green">446</FONT>        }<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>         * Sets the upper and lower bounds for the axis and sends an <a name="line.449"></a>
<FONT color="green">450</FONT>         * {@link AxisChangeEvent} to all registered listeners.  As a side-effect, <a name="line.450"></a>
<FONT color="green">451</FONT>         * the auto-range flag is set to false.<a name="line.451"></a>
<FONT color="green">452</FONT>         *<a name="line.452"></a>
<FONT color="green">453</FONT>         * @param range  the new range (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.453"></a>
<FONT color="green">454</FONT>         */<a name="line.454"></a>
<FONT color="green">455</FONT>        public void setRange(Range range) {<a name="line.455"></a>
<FONT color="green">456</FONT>            setRange(range, true, true);<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>        /**<a name="line.459"></a>
<FONT color="green">460</FONT>         * Sets the range for the axis, if requested, sends an <a name="line.460"></a>
<FONT color="green">461</FONT>         * {@link AxisChangeEvent} to all registered listeners.  As a side-effect, <a name="line.461"></a>
<FONT color="green">462</FONT>         * the auto-range flag is set to &lt;code&gt;false&lt;/code&gt; (optional).<a name="line.462"></a>
<FONT color="green">463</FONT>         *<a name="line.463"></a>
<FONT color="green">464</FONT>         * @param range  the range (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.464"></a>
<FONT color="green">465</FONT>         * @param turnOffAutoRange  a flag that controls whether or not the auto <a name="line.465"></a>
<FONT color="green">466</FONT>         *                          range is turned off.<a name="line.466"></a>
<FONT color="green">467</FONT>         * @param notify  a flag that controls whether or not listeners are <a name="line.467"></a>
<FONT color="green">468</FONT>         *                notified.<a name="line.468"></a>
<FONT color="green">469</FONT>         */<a name="line.469"></a>
<FONT color="green">470</FONT>        public void setRange(Range range, boolean turnOffAutoRange, <a name="line.470"></a>
<FONT color="green">471</FONT>                             boolean notify) {<a name="line.471"></a>
<FONT color="green">472</FONT>            if (range == null) {<a name="line.472"></a>
<FONT color="green">473</FONT>                throw new IllegalArgumentException("Null 'range' argument.");<a name="line.473"></a>
<FONT color="green">474</FONT>            }<a name="line.474"></a>
<FONT color="green">475</FONT>            // usually the range will be a DateRange, but if it isn't do a <a name="line.475"></a>
<FONT color="green">476</FONT>            // conversion...<a name="line.476"></a>
<FONT color="green">477</FONT>            if (!(range instanceof DateRange)) {<a name="line.477"></a>
<FONT color="green">478</FONT>                range = new DateRange(range);<a name="line.478"></a>
<FONT color="green">479</FONT>            }<a name="line.479"></a>
<FONT color="green">480</FONT>            super.setRange(range, turnOffAutoRange, notify);<a name="line.480"></a>
<FONT color="green">481</FONT>        }<a name="line.481"></a>
<FONT color="green">482</FONT>    <a name="line.482"></a>
<FONT color="green">483</FONT>        /**<a name="line.483"></a>
<FONT color="green">484</FONT>         * Sets the axis range and sends an {@link AxisChangeEvent} to all <a name="line.484"></a>
<FONT color="green">485</FONT>         * registered listeners.<a name="line.485"></a>
<FONT color="green">486</FONT>         *<a name="line.486"></a>
<FONT color="green">487</FONT>         * @param lower  the lower bound for the axis.<a name="line.487"></a>
<FONT color="green">488</FONT>         * @param upper  the upper bound for the axis.<a name="line.488"></a>
<FONT color="green">489</FONT>         */<a name="line.489"></a>
<FONT color="green">490</FONT>        public void setRange(Date lower, Date upper) {<a name="line.490"></a>
<FONT color="green">491</FONT>            if (lower.getTime() &gt;= upper.getTime()) {<a name="line.491"></a>
<FONT color="green">492</FONT>                throw new IllegalArgumentException("Requires 'lower' &lt; 'upper'.");<a name="line.492"></a>
<FONT color="green">493</FONT>            }<a name="line.493"></a>
<FONT color="green">494</FONT>            setRange(new DateRange(lower, upper));<a name="line.494"></a>
<FONT color="green">495</FONT>        }<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>         * Sets the axis range and sends an {@link AxisChangeEvent} to all <a name="line.498"></a>
<FONT color="green">499</FONT>         * registered listeners.<a name="line.499"></a>
<FONT color="green">500</FONT>         *<a name="line.500"></a>
<FONT color="green">501</FONT>         * @param lower  the lower bound for the axis.<a name="line.501"></a>
<FONT color="green">502</FONT>         * @param upper  the upper bound for the axis.<a name="line.502"></a>
<FONT color="green">503</FONT>         */<a name="line.503"></a>
<FONT color="green">504</FONT>        public void setRange(double lower, double upper) {<a name="line.504"></a>
<FONT color="green">505</FONT>            if (lower &gt;= upper) {<a name="line.505"></a>
<FONT color="green">506</FONT>                throw new IllegalArgumentException("Requires 'lower' &lt; 'upper'.");<a name="line.506"></a>
<FONT color="green">507</FONT>            }<a name="line.507"></a>
<FONT color="green">508</FONT>            setRange(new DateRange(lower, upper));<a name="line.508"></a>
<FONT color="green">509</FONT>        }<a name="line.509"></a>
<FONT color="green">510</FONT>    <a name="line.510"></a>
<FONT color="green">511</FONT>        /**<a name="line.511"></a>
<FONT color="green">512</FONT>         * Returns the earliest date visible on the axis.<a name="line.512"></a>
<FONT color="green">513</FONT>         *<a name="line.513"></a>
<FONT color="green">514</FONT>         * @return The date.<a name="line.514"></a>
<FONT color="green">515</FONT>         */<a name="line.515"></a>
<FONT color="green">516</FONT>        public Date getMinimumDate() {<a name="line.516"></a>
<FONT color="green">517</FONT>    <a name="line.517"></a>
<FONT color="green">518</FONT>            Date result = null;<a name="line.518"></a>
<FONT color="green">519</FONT>    <a name="line.519"></a>
<FONT color="green">520</FONT>            Range range = getRange();<a name="line.520"></a>
<FONT color="green">521</FONT>            if (range instanceof DateRange) {<a name="line.521"></a>
<FONT color="green">522</FONT>                DateRange r = (DateRange) range;<a name="line.522"></a>
<FONT color="green">523</FONT>                result = r.getLowerDate();<a name="line.523"></a>
<FONT color="green">524</FONT>            }<a name="line.524"></a>
<FONT color="green">525</FONT>            else {<a name="line.525"></a>
<FONT color="green">526</FONT>                result = new Date((long) range.getLowerBound());<a name="line.526"></a>
<FONT color="green">527</FONT>            }<a name="line.527"></a>
<FONT color="green">528</FONT>    <a name="line.528"></a>
<FONT color="green">529</FONT>            return result;<a name="line.529"></a>
<FONT color="green">530</FONT>    <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>         * Sets the minimum date visible on the axis and sends an <a name="line.534"></a>
<FONT color="green">535</FONT>         * {@link AxisChangeEvent} to all registered listeners.<a name="line.535"></a>
<FONT color="green">536</FONT>         *<a name="line.536"></a>
<FONT color="green">537</FONT>         * @param date  the date (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.537"></a>
<FONT color="green">538</FONT>         */<a name="line.538"></a>
<FONT color="green">539</FONT>        public void setMinimumDate(Date date) {<a name="line.539"></a>
<FONT color="green">540</FONT>            setRange(new DateRange(date, getMaximumDate()), true, false);<a name="line.540"></a>
<FONT color="green">541</FONT>            notifyListeners(new AxisChangeEvent(this));<a name="line.541"></a>
<FONT color="green">542</FONT>        }<a name="line.542"></a>
<FONT color="green">543</FONT>    <a name="line.543"></a>
<FONT color="green">544</FONT>        /**<a name="line.544"></a>
<FONT color="green">545</FONT>         * Returns the latest date visible on the axis.<a name="line.545"></a>
<FONT color="green">546</FONT>         *<a name="line.546"></a>
<FONT color="green">547</FONT>         * @return The date.<a name="line.547"></a>
<FONT color="green">548</FONT>         */<a name="line.548"></a>
<FONT color="green">549</FONT>        public Date getMaximumDate() {<a name="line.549"></a>
<FONT color="green">550</FONT>    <a name="line.550"></a>
<FONT color="green">551</FONT>            Date result = null;<a name="line.551"></a>
<FONT color="green">552</FONT>            Range range = getRange();<a name="line.552"></a>
<FONT color="green">553</FONT>            if (range instanceof DateRange) {<a name="line.553"></a>
<FONT color="green">554</FONT>                DateRange r = (DateRange) range;<a name="line.554"></a>
<FONT color="green">555</FONT>                result = r.getUpperDate();<a name="line.555"></a>
<FONT color="green">556</FONT>            }<a name="line.556"></a>
<FONT color="green">557</FONT>            else {<a name="line.557"></a>
<FONT color="green">558</FONT>                result = new Date((long) range.getUpperBound());<a name="line.558"></a>
<FONT color="green">559</FONT>            }<a name="line.559"></a>
<FONT color="green">560</FONT>            return result;<a name="line.560"></a>
<FONT color="green">561</FONT>    <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>         * Sets the maximum date visible on the axis.  An {@link AxisChangeEvent} <a name="line.565"></a>
<FONT color="green">566</FONT>         * is sent to all registered listeners.<a name="line.566"></a>
<FONT color="green">567</FONT>         *<a name="line.567"></a>
<FONT color="green">568</FONT>         * @param maximumDate  the date (&lt;code&gt;null&lt;/code&gt; not permitted).<a name="line.568"></a>
<FONT color="green">569</FONT>         */<a name="line.569"></a>
<FONT color="green">570</FONT>        public void setMaximumDate(Date maximumDate) {<a name="line.570"></a>
<FONT color="green">571</FONT>            setRange(new DateRange(getMinimumDate(), maximumDate), true, false);<a name="line.571"></a>
<FONT color="green">572</FONT>            notifyListeners(new AxisChangeEvent(this));<a name="line.572"></a>
<FONT color="green">573</FONT>        }<a name="line.573"></a>