slider.html

jsf、swing的官方指南

<h3>
<a name="api">The Slider API</a>
</h3>
<blockquote>
The following tables list the commonly used
<code>JSlider</code> constructors and methods.
See
<a href="jcomponent.html">The JComponent Class</a>
for tables of commonly used inherited methods.

<p>

The API for using sliders falls into these categories:
<ul>
<li>
<a href="#creating">Creating the Slider</a>
<li>
<a href="#looks">Fine Tuning the Slider's Appearance</a>
<li>
<a href="#operation">Watching the Slider Operate</a>
<li>
<a href="#modelapi">Working Directly with the Data Model</a>
</ul>

<p>

<table border=1>
<caption><a name="creating">Creating the Slider</a></caption>
<tr>
<th>Constructor
</th>
<th>Purpose

</th>
</tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#JSlider()">JSlider()</a>    </td>
    <td>Create a horizontal slider with
        the range 0 to 100 and an initial value of 50.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#JSlider(int, int)">JSlider(int min, int max)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#JSlider(int, int, int)">JSlider(int min, int max, int value)</a>    </td>
    <td>Create a horizontal slider with
        the specified minimum and maximum values.
        The third <code>int</code> argument, when present,
        specifies the slider's initial value.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#JSlider(int)">JSlider(int orientation)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#JSlider(int, int, int, int)">JSlider(int orientation, int min, int max, int value)</a>    </td>
    <td>Create a slider with the specified orientation, which
        must be either <code>JSlider.HORIZONTAL</code> or
        <code>JSlider.VERTICAL</code>.
        The last three <code>int</code> arguments, when present,
        specify the slider's minimum, maximum, and initial values, respectively.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#JSlider(javax.swing.BoundedRangeModel)">JSlider(BoundedRangeModel)</a>    </td>
    <td>Create a horizontal slider with the specified model, which
        manages the slider's minimum, maximum, and current values
        and their relationship.

    </td>
  </tr>
</table>

<p>

<table border=1>
<caption><a name="looks">Fine Tuning the Slider's Appearance</a></caption>
<tr>
<th>Method
</th>
<th>Purpose

</th>
</tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setValue(int)">void setValue(int)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getValue()">int getValue()</a>    </td>
    <td>Set or get the slider's current value.
        This method also positions the slider's knob.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setOrientation(int)">void setOrientation(int)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getOrientation()">int getOrientation()</a>    </td>
    <td>Set or get the orientation of the slider. Possible values
        are <code>JSlider.HORIZONTAL</code> or <code>JSlider.VERTICAL</code>.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setInverted(boolean)">void setInverted(boolean)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getInverted()">boolean getInverted()</a>    </td>
    <td>Set or get whether the maximum is shown at the left of a
        horizontal slider or at the bottom of a vertical one,
        thereby inverting the slider's range.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setMinimum(int)">void setMinimum(int)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getMinimum()">void getMinimum()</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setMaximum(int)">void setMaximum(int)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getMaximum()">void getMaximum()</a>    </td>
    <td>Set or get the minimum or maximum values of the slider.
        Together, these methods set or get the slider's range.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setMajorTickSpacing(int)">void setMajorTickSpacing(int)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getMajorTickSpacing()">int getMajorTickSpacing()</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setMinorTickSpacing(int)">void setMinorTickSpacing(int)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getMinorTickSpacing()">int getMinorTickSpacing()</a>    </td>
    <td>Set or get the range between major and minor ticks. You must
        call <code>setPaintTicks(true)</code> for the tick marks to appear.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setPaintTicks(boolean)">void setPaintTicks(boolean)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getPaintTicks()">boolean getPaintTicks()</a>    </td>
    <td>Set or get whether tick marks are painted on the slider.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setPaintLabels(boolean)">void setPaintLabels(boolean)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getPaintLabels()">boolean getPaintLabels()</a>    </td>
    <td>Set or get whether labels are painted on the slider.
        You can provide custom labels with <code>setLabelTable</code> or
        get automatic labels by setting the major tick spacing
        to a non-zero value.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setLabelTable(java.util.Dictionary)">void setLabelTable(Dictionary)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getLabelTable()">Dictionary getLabelTable()</a>    </td>
    <td>Set or get the labels for the slider.
        You must call <code>setPaintLabels(true)</code> for the labels to appear.
    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#createStandardLabels(int)">Hashtable createStandardLabels(int)</a>    <br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#createStandardLabels(int, int)">Hashtable createStandardLabels(int, int)</a>    </td>
    <td>Create a standard set of numeric labels.
        The first <code>int</code> argument specifies the increment,
        the second <code>int</code> argument specifies the starting point.
        When left unspecified,
        the slider's minimum is used as the starting point.

    </td>
  </tr>
</table>

<p>

<table border=1>
<caption><a name="operation">Watching the Slider Operate</a></caption>
<tr>
<th>Method
</th>
<th>Purpose

</th>
</tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#addChangeListener(javax.swing.event.ChangeListener)">void addChangeListener(ChangeListener)</a>    </td>
    <td>Register a change listener with the slider.

    </td>
  </tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getValueIsAdjusting()">boolean getValueIsAdjusting()</a>    </td>
    <td>Determine whether the user gesture to move the slider's knob is
        complete.

    </td>
  </tr>
</table>

<p>

<table border=1>
<caption><a name="modelapi">Working Directly with the Data Model</a></caption>
<tr>
<th>Class, Interface, or Method
</th>
<th>Purpose

</th>
</tr>
  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/BoundedRangeModel.html">BoundedRangeModel</a>    </td>
    <td>The interface required for the slider's data model.
    </td>
  </tr>

  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/DefaultBoundedRangeModel.html">DefaultBoundedRangeModel</a>    </td>
    <td>An implementation of the <code>BoundedRangeModel</code>
        interface.
    </td>
  </tr>

  <tr>
    <td>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#setModel(javax.swing.BoundedRangeModel)">boolean setModel()</a><br>
<a class="APILink" target="_blank" href="http://java.sun.com/javase/6/docs/api/javax/swing/JSlider.html#getModel()">boolean getModel()</a><br>
<em>(in <code>JSlider</code>)
    </td>
    <td>Set or get the data model used by the slider.
        You can also set the model using the
        constructor that takes a single argument
        of type <code>BoundedRangeModel</code>.
    </td>
  </tr>
</table>
</blockquote>

<h3>
<a name="eg">Examples that Use Sliders</a>
</h3>
<blockquote>
This table shows the examples that use <code>JSlider</code>
and where those examples are described.
<p>
<table>
<tr>
<th align=left> Example
</th>
<th align=left> Where Described
</th>
<th align=left> Notes

</th>
</tr>
<tr valign=top>
<td> <a href="examples/index.html#SliderDemo"><code>SliderDemo</code></a>
</td>
<td> This section
</td>
<td> Shows a slider with labels at major tick marks.
</td>
</tr>

<tr valign=top>
<td> <a href="examples/index.html#SliderDemo2"><code>SliderDemo2</code></a>
</td>
<td> <a href="#labels">Customizing Labels on a Slider</a>
</td>
<td> Shows a vertical slider with custom labels.
</td>
</tr>

<tr valign=top>
<td> <a href="examples/index.html#SliderDemo3"><code>SliderDemo3</code></a>
</td>
<td> <a href="#ftf">Using a Formatted Text Field with a Slider
</td>
<td> Demonstrates using a formatted text field
     with a slider to set and display a single value.
</td>
</tr>

<tr valign=top>
<td> <a href="examples/index.html#Converter"><code>Converter</code></a>
</td>
<td> <a href="model.html">Using Models</a>,
<a href="panel.html">How to Use Panels</a>
</td>
<td> A measurement conversion application
     featuring two sliders that share data and
     have custom <code>BoundedRangeModel</code>s.
</td>
</tr>
</table>



        </blockquote>
        <div class=NavBit>
            <a target=_top href=separator.html>&laquo; Previous</a>
            &bull;
            <a target=_top href=../TOC.html>Trail</a>
            &bull;
            <a target=_top href=spinner.html>Next &raquo;</a>
        </div>
    </div>
    <div id=Footer>
<div id=TagNotes>
    Problems with the examples? Try <a target="_blank"
        href=../../information/run-examples.html>Compiling and Running
        the Examples: FAQs</a>.
    <br>
    Complaints? Compliments? Suggestions? <a target="_blank"
        href="http://developer.sun.com/contact/tutorial_feedback.jsp">Give
    us your feedback</a>.
<br><br>
    <a target="_blank" href="../../information/copyright.html">Copyright</a>
    1995-2006 Sun Microsystems, Inc.  All rights reserved.
    <span id=Download>
</span></div> 

    </div>
    <div class=PrintHeaders>
        <b>Previous page:</b> How to Use Separators
        <br><b>Next page:</b> How to Use Spinners
    </div>
    </body>
</html>