File	Doc	Category	Size	Date	Package
JSlider.java	API Doc	Java SE 6 API	49871	Tue Jun 10 00:26:38 BST 2008	javax.swing

JSlider

• java.lang.Object
  • java.awt.Component
    • java.awt.Container
      • javax.swing.JComponent

Fields Summary
private static final String	uiClassID
private boolean	paintTicks
private boolean	paintTrack
private boolean	paintLabels
private boolean	isInverted
protected BoundedRangeModel	sliderModel The data model that handles the numeric maximum value, minimum value, and current-position value for the slider.
protected int	majorTickSpacing The number of values between the major tick marks -- the larger marks that break up the minor tick marks.
protected int	minorTickSpacing The number of values between the minor tick marks -- the smaller marks that occur between the major tick marks.
protected boolean	snapToTicks If true, the knob (and the data value it represents) resolve to the closest tick mark next to where the user positioned the knob. The default is false.
boolean	snapToValue If true, the knob (and the data value it represents) resolve to the closest slider value next to where the user positioned the knob.
protected int	orientation Whether the slider is horizontal or vertical The default is horizontal.
private Dictionary	labelTable {@code Dictionary} of what labels to draw at which values
protected ChangeListener	changeListener The changeListener (no suffix) is the listener we add to the slider's model. This listener is initialized to the {@code ChangeListener} returned from {@code createChangeListener}, which by default just forwards events to {@code ChangeListener}s (if any) added directly to the slider.
protected transient ChangeEvent	changeEvent Only one ChangeEvent is needed per slider instance since the event's only (read-only) state is the source property. The source of events generated here is always "this". The event is lazily created the first time that an event notification is fired.

Constructors Summary
public JSlider() Creates a horizontal slider with the range 0 to 100 and an initial value of 50. this(HORIZONTAL, 0, 100, 50);
public JSlider(int orientation) Creates a slider using the specified orientation with the range {@code 0} to {@code 100} and an initial value of {@code 50}. The orientation can be either SwingConstants.VERTICAL or SwingConstants.HORIZONTAL. param orientation the orientation of the slider throws IllegalArgumentException if orientation is not one of {@code VERTICAL}, {@code HORIZONTAL} see #setOrientation this(orientation, 0, 100, 50);
public JSlider(int min, int max) Creates a horizontal slider using the specified min and max with an initial value equal to the average of the min plus max. The BoundedRangeModel that holds the slider's data handles any issues that may arise from improperly setting the minimum and maximum values on the slider. See the {@code BoundedRangeModel} documentation for details. param min the minimum value of the slider param max the maximum value of the slider see BoundedRangeModel see #setMinimum see #setMaximum this(HORIZONTAL, min, max, (min + max) / 2);
public JSlider(int min, int max, int value) Creates a horizontal slider using the specified min, max and value. The BoundedRangeModel that holds the slider's data handles any issues that may arise from improperly setting the minimum, initial, and maximum values on the slider. See the {@code BoundedRangeModel} documentation for details. param min the minimum value of the slider param max the maximum value of the slider param value the initial value of the slider see BoundedRangeModel see #setMinimum see #setMaximum see #setValue this(HORIZONTAL, min, max, value);
public JSlider(int orientation, int min, int max, int value) Creates a slider with the specified orientation and the specified minimum, maximum, and initial values. The orientation can be either SwingConstants.VERTICAL or SwingConstants.HORIZONTAL. The BoundedRangeModel that holds the slider's data handles any issues that may arise from improperly setting the minimum, initial, and maximum values on the slider. See the {@code BoundedRangeModel} documentation for details. param orientation the orientation of the slider param min the minimum value of the slider param max the maximum value of the slider param value the initial value of the slider throws IllegalArgumentException if orientation is not one of {@code VERTICAL}, {@code HORIZONTAL} see BoundedRangeModel see #setOrientation see #setMinimum see #setMaximum see #setValue checkOrientation(orientation); this.orientation = orientation; sliderModel = new DefaultBoundedRangeModel(value, 0, min, max); sliderModel.addChangeListener(changeListener); updateUI();
public JSlider(BoundedRangeModel brm) Creates a horizontal slider using the specified BoundedRangeModel. this.orientation = JSlider.HORIZONTAL; setModel(brm); sliderModel.addChangeListener(changeListener); updateUI();

Methods Summary
public void	addChangeListener(javax.swing.event.ChangeListener l) Adds a ChangeListener to the slider. param l the ChangeListener to add see #fireStateChanged see #removeChangeListener listenerList.add(ChangeListener.class, l);
private void	checkOrientation(int orientation) switch (orientation) { case VERTICAL: case HORIZONTAL: break; default: throw new IllegalArgumentException("orientation must be one of: VERTICAL, HORIZONTAL"); }
protected javax.swing.event.ChangeListener	createChangeListener() Subclasses that want to handle {@code ChangeEvent}s from the model differently can override this to return an instance of a custom ChangeListener implementation. The default {@code ChangeListener} simply calls the {@code fireStateChanged} method to forward {@code ChangeEvent}s to the {@code ChangeListener}s that have been added directly to the slider. see #changeListener see #fireStateChanged see javax.swing.event.ChangeListener see javax.swing.BoundedRangeModel return new ModelListener();
public java.util.Hashtable	createStandardLabels(int increment) Creates a {@code Hashtable} of numerical text labels, starting at the slider minimum, and using the increment specified. For example, if you call createStandardLabels( 10 ) and the slider minimum is zero, then labels will be created for the values 0, 10, 20, 30, and so on. For the labels to be drawn on the slider, the returned {@code Hashtable} must be passed into {@code setLabelTable}, and {@code setPaintLabels} must be set to {@code true}. For further details on the makeup of the returned {@code Hashtable}, see the {@code setLabelTable} documentation. param increment distance between labels in the generated hashtable return a new {@code Hashtable} of labels see #setLabelTable see #setPaintLabels throws IllegalArgumentException if {@code increment} is less than or equal to zero return createStandardLabels( increment, getMinimum() );
public java.util.Hashtable	createStandardLabels(int increment, int start) Creates a {@code Hashtable} of numerical text labels, starting at the starting point specified, and using the increment specified. For example, if you call createStandardLabels( 10, 2 ), then labels will be created for the values 2, 12, 22, 32, and so on. For the labels to be drawn on the slider, the returned {@code Hashtable} must be passed into {@code setLabelTable}, and {@code setPaintLabels} must be set to {@code true}. For further details on the makeup of the returned {@code Hashtable}, see the {@code setLabelTable} documentation. param increment distance between labels in the generated hashtable param start value at which the labels will begin return a new {@code Hashtable} of labels see #setLabelTable see #setPaintLabels exception IllegalArgumentException if {@code start} is out of range, or if {@code increment} is less than or equal to zero if ( start > getMaximum() || start < getMinimum() ) { throw new IllegalArgumentException( "Slider label start point out of range." ); } if ( increment <= 0 ) { throw new IllegalArgumentException( "Label incremement must be > 0" ); } class SmartHashtable extends Hashtable implements PropertyChangeListener { int increment = 0; int start = 0; boolean startAtMin = false; class LabelUIResource extends JLabel implements UIResource { public LabelUIResource( String text, int alignment ) { super( text, alignment ); setName("Slider.label"); } public Font getFont() { Font font = super.getFont(); if (font != null && !(font instanceof UIResource)) { return font; } return JSlider.this.getFont(); } public Color getForeground() { Color fg = super.getForeground(); if (fg != null && !(fg instanceof UIResource)) { return fg; } if (!(JSlider.this.getForeground() instanceof UIResource)) { return JSlider.this.getForeground(); } return fg; } } public SmartHashtable( int increment, int start ) { super(); this.increment = increment; this.start = start; startAtMin = start == getMinimum(); createLabels(); } public void propertyChange( PropertyChangeEvent e ) { if ( e.getPropertyName().equals( "minimum" ) && startAtMin ) { start = getMinimum(); } if ( e.getPropertyName().equals( "minimum" ) || e.getPropertyName().equals( "maximum" ) ) { Enumeration keys = getLabelTable().keys(); Object key = null; Hashtable hashtable = new Hashtable(); // Save the labels that were added by the developer while ( keys.hasMoreElements() ) { key = keys.nextElement(); Object value = getLabelTable().get( key ); if ( !(value instanceof LabelUIResource) ) { hashtable.put( key, value ); } } clear(); createLabels(); // Add the saved labels keys = hashtable.keys(); while ( keys.hasMoreElements() ) { key = keys.nextElement(); put( key, hashtable.get( key ) ); } ((JSlider)e.getSource()).setLabelTable( this ); } } void createLabels() { for ( int labelIndex = start; labelIndex <= getMaximum(); labelIndex += increment ) { put( new Integer( labelIndex ), new LabelUIResource( ""+labelIndex, JLabel.CENTER ) ); } } } SmartHashtable table = new SmartHashtable( increment, start ); if ( getLabelTable() != null && (getLabelTable() instanceof PropertyChangeListener) ) { removePropertyChangeListener( (PropertyChangeListener)getLabelTable() ); } addPropertyChangeListener( table ); return table;
protected void	fireStateChanged() Send a {@code ChangeEvent}, whose source is this {@code JSlider}, to all {@code ChangeListener}s that have registered interest in {@code ChangeEvent}s. This method is called each time a {@code ChangeEvent} is received from the model. The event instance is created if necessary, and stored in {@code changeEvent}. see #addChangeListener see EventListenerList Object[] listeners = listenerList.getListenerList(); for (int i = listeners.length - 2; i >= 0; i -= 2) { if (listeners[i]==ChangeListener.class) { if (changeEvent == null) { changeEvent = new ChangeEvent(this); } ((ChangeListener)listeners[i+1]).stateChanged(changeEvent); } }
public javax.accessibility.AccessibleContext	getAccessibleContext() Gets the AccessibleContext associated with this JSlider. For sliders, the AccessibleContext takes the form of an AccessibleJSlider. A new AccessibleJSlider instance is created if necessary. return an AccessibleJSlider that serves as the AccessibleContext of this JSlider if (accessibleContext == null) { accessibleContext = new AccessibleJSlider(); } return accessibleContext;
public javax.swing.event.ChangeListener[]	getChangeListeners() Returns an array of all the ChangeListeners added to this JSlider with addChangeListener(). return all of the ChangeListeners added or an empty array if no listeners have been added since 1.4 return (ChangeListener[])listenerList.getListeners( ChangeListener.class);
public int	getExtent() Returns the "extent" from the BoundedRangeModel. This respresents the range of values "covered" by the knob. return an int representing the extent see #setExtent see BoundedRangeModel#getExtent return getModel().getExtent();
public boolean	getInverted() Returns true if the value-range shown for the slider is reversed, return true if the slider values are reversed from their normal order see #setInverted return isInverted;
public java.util.Dictionary	getLabelTable() Returns the dictionary of what labels to draw at which values. return the Dictionary containing labels and where to draw them /* if ( labelTable == null && getMajorTickSpacing() > 0 ) { setLabelTable( createStandardLabels( getMajorTickSpacing() ) ); } */ return labelTable;
public int	getMajorTickSpacing() This method returns the major tick spacing. The number that is returned represents the distance, measured in values, between each major tick mark. If you have a slider with a range from 0 to 50 and the major tick spacing is set to 10, you will get major ticks next to the following values: 0, 10, 20, 30, 40, 50. return the number of values between major ticks see #setMajorTickSpacing return majorTickSpacing;
public int	getMaximum() Returns the maximum value supported by the slider from the BoundedRangeModel. return the value of the model's maximum property see #setMaximum see BoundedRangeModel#getMaximum return getModel().getMaximum();
public int	getMinimum() Returns the minimum value supported by the slider from the BoundedRangeModel. return the value of the model's minimum property see #setMinimum see BoundedRangeModel#getMinimum return getModel().getMinimum();
public int	getMinorTickSpacing() This method returns the minor tick spacing. The number that is returned represents the distance, measured in values, between each minor tick mark. If you have a slider with a range from 0 to 50 and the minor tick spacing is set to 10, you will get minor ticks next to the following values: 0, 10, 20, 30, 40, 50. return the number of values between minor ticks see #getMinorTickSpacing return minorTickSpacing;
public javax.swing.BoundedRangeModel	getModel() Returns the {@code BoundedRangeModel} that handles the slider's three fundamental properties: minimum, maximum, value. return the data model for this component see #setModel see BoundedRangeModel return sliderModel;
public int	getOrientation() Return this slider's vertical or horizontal orientation. return {@code SwingConstants.VERTICAL} or {@code SwingConstants.HORIZONTAL} see #setOrientation return orientation;
public boolean	getPaintLabels() Tells if labels are to be painted. return true if labels are painted, else false see #setPaintLabels return paintLabels;
public boolean	getPaintTicks() Tells if tick marks are to be painted. return true if tick marks are painted, else false see #setPaintTicks return paintTicks;
public boolean	getPaintTrack() Tells if the track (area the slider slides in) is to be painted. return true if track is painted, else false see #setPaintTrack return paintTrack;
public boolean	getSnapToTicks() Returns true if the knob (and the data value it represents) resolve to the closest tick mark next to where the user positioned the knob. return true if the value snaps to the nearest tick mark, else false see #setSnapToTicks return snapToTicks;
boolean	getSnapToValue() Returns true if the knob (and the data value it represents) resolve to the closest slider value next to where the user positioned the knob. return true if the value snaps to the nearest slider value, else false see #setSnapToValue return snapToValue;
public javax.swing.plaf.SliderUI	getUI() Gets the UI object which implements the L&F for this component. return the SliderUI object that implements the Slider L&F return(SliderUI)ui;
public java.lang.String	getUIClassID() Returns the name of the L&F class that renders this component. return "SliderUI" see JComponent#getUIClassID see UIDefaults#getUI return uiClassID;
public int	getValue() Returns the slider's current value from the {@code BoundedRangeModel}. return the current value of the slider see #setValue see BoundedRangeModel#getValue return getModel().getValue();
public boolean	getValueIsAdjusting() Returns the {@code valueIsAdjusting} property from the model. For details on how this is used, see the {@code setValueIsAdjusting} documentation. return the value of the model's {@code valueIsAdjusting} property see #setValueIsAdjusting return getModel().getValueIsAdjusting();
protected java.lang.String	paramString() Returns a string representation of this JSlider. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null. return a string representation of this JSlider. String paintTicksString = (paintTicks ? "true" : "false"); String paintTrackString = (paintTrack ? "true" : "false"); String paintLabelsString = (paintLabels ? "true" : "false"); String isInvertedString = (isInverted ? "true" : "false"); String snapToTicksString = (snapToTicks ? "true" : "false"); String snapToValueString = (snapToValue ? "true" : "false"); String orientationString = (orientation == HORIZONTAL ? "HORIZONTAL" : "VERTICAL"); return super.paramString() + ",isInverted=" + isInvertedString + ",majorTickSpacing=" + majorTickSpacing + ",minorTickSpacing=" + minorTickSpacing + ",orientation=" + orientationString + ",paintLabels=" + paintLabelsString + ",paintTicks=" + paintTicksString + ",paintTrack=" + paintTrackString + ",snapToTicks=" + snapToTicksString + ",snapToValue=" + snapToValueString;
public void	removeChangeListener(javax.swing.event.ChangeListener l) Removes a ChangeListener from the slider. param l the ChangeListener to remove see #fireStateChanged see #addChangeListener listenerList.remove(ChangeListener.class, l);
public void	setExtent(int extent) Sets the size of the range "covered" by the knob. Most look and feel implementations will change the value by this amount if the user clicks on either side of the knob. This method just forwards the new extent value to the model. The data model (an instance of {@code BoundedRangeModel}) handles any mathematical issues arising from assigning faulty values. See the {@code BoundedRangeModel} documentation for details. If the new extent value is different from the previous extent value, all change listeners are notified. param extent the new extent see #getExtent see BoundedRangeModel#setExtent beaninfo expert: true description: Size of the range covered by the knob. getModel().setExtent(extent);
public void	setFont(java.awt.Font font) {@inheritDoc} since 1.6 super.setFont(font); updateLabelSizes();
public void	setInverted(boolean b) Specify true to reverse the value-range shown for the slider and false to put the value range in the normal order. The order depends on the slider's ComponentOrientation property. Normal (non-inverted) horizontal sliders with a ComponentOrientation value of LEFT_TO_RIGHT have their maximum on the right. Normal horizontal sliders with a ComponentOrientation value of RIGHT_TO_LEFT have their maximum on the left. Normal vertical sliders have their maximum on the top. These labels are reversed when the slider is inverted. By default, the value of this property is {@code false}. param b true to reverse the slider values from their normal order beaninfo bound: true attribute: visualUpdate true description: If true reverses the slider values from their normal order boolean oldValue = isInverted; isInverted = b; firePropertyChange("inverted", oldValue, isInverted); if (b != oldValue) { repaint(); }
public void	setLabelTable(java.util.Dictionary labels) Used to specify what label will be drawn at any given value. The key-value pairs are of this format: { Integer value, java.swing.JComponent label }. An easy way to generate a standard table of value labels is by using the {@code createStandardLabels} method. Once the labels have been set, this method calls {@link #updateLabelUIs}. Note that the labels are only painted if the {@code paintLabels} property is {@code true}. param labels new {@code Dictionary} of labels, or {@code null} to remove all labels see #createStandardLabels(int) see #getLabelTable see #setPaintLabels beaninfo hidden: true bound: true attribute: visualUpdate true description: Specifies what labels will be drawn for any given value. Dictionary oldTable = labelTable; labelTable = labels; updateLabelUIs(); firePropertyChange("labelTable", oldTable, labelTable ); if (labels != oldTable) { revalidate(); repaint(); }
public void	setMajorTickSpacing(int n) This method sets the major tick spacing. The number that is passed in represents the distance, measured in values, between each major tick mark. If you have a slider with a range from 0 to 50 and the major tick spacing is set to 10, you will get major ticks next to the following values: 0, 10, 20, 30, 40, 50. In order for major ticks to be painted, {@code setPaintTicks} must be set to {@code true}. This method will also set up a label table for you. If there is not already a label table, and the major tick spacing is {@code > 0}, and {@code getPaintLabels} returns {@code true}, a standard label table will be generated (by calling {@code createStandardLabels}) with labels at the major tick marks. For the example above, you would get text labels: "0", "10", "20", "30", "40", "50". The label table is then set on the slider by calling {@code setLabelTable}. param n new value for the {@code majorTickSpacing} property see #getMajorTickSpacing see #setPaintTicks see #setLabelTable see #createStandardLabels(int) beaninfo bound: true attribute: visualUpdate true description: Sets the number of values between major tick marks. int oldValue = majorTickSpacing; majorTickSpacing = n; if ( labelTable == null && getMajorTickSpacing() > 0 && getPaintLabels() ) { setLabelTable( createStandardLabels( getMajorTickSpacing() ) ); } firePropertyChange("majorTickSpacing", oldValue, majorTickSpacing); if (majorTickSpacing != oldValue && getPaintTicks()) { repaint(); }
public void	setMaximum(int maximum) Sets the slider's maximum value to {@code maximum}. This method forwards the new maximum value to the model. The data model (an instance of {@code BoundedRangeModel}) handles any mathematical issues arising from assigning faulty values. See the {@code BoundedRangeModel} documentation for details. If the new maximum value is different from the previous maximum value, all change listeners are notified. param n the new maximum see #getMaximum see #addChangeListener see BoundedRangeModel#setMaximum beaninfo bound: true preferred: true description: The sliders maximum value. int oldMax = getModel().getMaximum(); getModel().setMaximum(maximum); firePropertyChange( "maximum", new Integer( oldMax ), new Integer( maximum ) );
public void	setMinimum(int minimum) Sets the slider's minimum value to {@code minimum}. This method forwards the new minimum value to the model. The data model (an instance of {@code BoundedRangeModel}) handles any mathematical issues arising from assigning faulty values. See the {@code BoundedRangeModel} documentation for details. If the new minimum value is different from the previous minimum value, all change listeners are notified. param n the new minimum see #getMinimum see #addChangeListener see BoundedRangeModel#setMinimum beaninfo bound: true preferred: true description: The sliders minimum value. int oldMin = getModel().getMinimum(); getModel().setMinimum(minimum); firePropertyChange( "minimum", new Integer( oldMin ), new Integer( minimum ) );
public void	setMinorTickSpacing(int n) This method sets the minor tick spacing. The number that is passed in represents the distance, measured in values, between each minor tick mark. If you have a slider with a range from 0 to 50 and the minor tick spacing is set to 10, you will get minor ticks next to the following values: 0, 10, 20, 30, 40, 50. In order for minor ticks to be painted, {@code setPaintTicks} must be set to {@code true}. param n new value for the {@code minorTickSpacing} property see #getMinorTickSpacing see #setPaintTicks beaninfo bound: true attribute: visualUpdate true description: Sets the number of values between minor tick marks. int oldValue = minorTickSpacing; minorTickSpacing = n; firePropertyChange("minorTickSpacing", oldValue, minorTickSpacing); if (minorTickSpacing != oldValue && getPaintTicks()) { repaint(); }
public void	setModel(javax.swing.BoundedRangeModel newModel) Sets the {@code BoundedRangeModel} that handles the slider's three fundamental properties: minimum, maximum, value. Attempts to pass a {@code null} model to this method result in undefined behavior, and, most likely, exceptions. param newModel the new, {@code non-null} BoundedRangeModel to use see #getModel see BoundedRangeModel beaninfo bound: true description: The sliders BoundedRangeModel. BoundedRangeModel oldModel = getModel(); if (oldModel != null) { oldModel.removeChangeListener(changeListener); } sliderModel = newModel; if (newModel != null) { newModel.addChangeListener(changeListener); if (accessibleContext != null) { accessibleContext.firePropertyChange( AccessibleContext.ACCESSIBLE_VALUE_PROPERTY, (oldModel == null ? null : new Integer(oldModel.getValue())), (newModel == null ? null : new Integer(newModel.getValue()))); } } firePropertyChange("model", oldModel, sliderModel);
public void	setOrientation(int orientation) Set the slider's orientation to either {@code SwingConstants.VERTICAL} or {@code SwingConstants.HORIZONTAL}. param orientation {@code HORIZONTAL} or {@code VERTICAL} throws IllegalArgumentException if orientation is not one of {@code VERTICAL}, {@code HORIZONTAL} see #getOrientation beaninfo preferred: true bound: true attribute: visualUpdate true description: Set the scrollbars orientation to either VERTICAL or HORIZONTAL. enum: VERTICAL JSlider.VERTICAL HORIZONTAL JSlider.HORIZONTAL checkOrientation(orientation); int oldValue = this.orientation; this.orientation = orientation; firePropertyChange("orientation", oldValue, orientation); if ((oldValue != orientation) && (accessibleContext != null)) { accessibleContext.firePropertyChange( AccessibleContext.ACCESSIBLE_STATE_PROPERTY, ((oldValue == VERTICAL) ? AccessibleState.VERTICAL : AccessibleState.HORIZONTAL), ((orientation == VERTICAL) ? AccessibleState.VERTICAL : AccessibleState.HORIZONTAL)); } if (orientation != oldValue) { revalidate(); }
public void	setPaintLabels(boolean b) Determines whether labels are painted on the slider. This method will also set up a label table for you. If there is not already a label table, and the major tick spacing is {@code > 0}, a standard label table will be generated (by calling {@code createStandardLabels}) with labels at the major tick marks. The label table is then set on the slider by calling {@code setLabelTable}. By default, this property is {@code false}. param b whether or not to paint labels see #getPaintLabels see #getLabelTable see #createStandardLabels(int) beaninfo bound: true attribute: visualUpdate true description: If true labels are painted on the slider. boolean oldValue = paintLabels; paintLabels = b; if ( labelTable == null && getMajorTickSpacing() > 0 ) { setLabelTable( createStandardLabels( getMajorTickSpacing() ) ); } firePropertyChange("paintLabels", oldValue, paintLabels); if (paintLabels != oldValue) { revalidate(); repaint(); }
public void	setPaintTicks(boolean b) Determines whether tick marks are painted on the slider. By default, this property is {@code false}. param b whether or not tick marks should be painted see #getPaintTicks beaninfo bound: true attribute: visualUpdate true description: If true tick marks are painted on the slider. boolean oldValue = paintTicks; paintTicks = b; firePropertyChange("paintTicks", oldValue, paintTicks); if (paintTicks != oldValue) { revalidate(); repaint(); }
public void	setPaintTrack(boolean b) Determines whether the track is painted on the slider. By default, this property is {@code true}. param b whether or not to paint the slider track see #getPaintTrack beaninfo bound: true attribute: visualUpdate true description: If true, the track is painted on the slider. boolean oldValue = paintTrack; paintTrack = b; firePropertyChange("paintTrack", oldValue, paintTrack); if (paintTrack != oldValue) { repaint(); }
public void	setSnapToTicks(boolean b) Specifying true makes the knob (and the data value it represents) resolve to the closest tick mark next to where the user positioned the knob. By default, this property is {@code false}. param b true to snap the knob to the nearest tick mark see #getSnapToTicks beaninfo bound: true description: If true snap the knob to the nearest tick mark. boolean oldValue = snapToTicks; snapToTicks = b; firePropertyChange("snapToTicks", oldValue, snapToTicks);
void	setSnapToValue(boolean b) Specifying true makes the knob (and the data value it represents) resolve to the closest slider value next to where the user positioned the knob. If the {@code snapToTicks} property has also been set to {@code true}, the snap-to-ticks behavior will prevail. By default, the snapToValue property is {@code true}. param b true to snap the knob to the nearest slider value see #getSnapToValue see #setSnapToTicks beaninfo bound: true description: If true snap the knob to the nearest slider value. boolean oldValue = snapToValue; snapToValue = b; firePropertyChange("snapToValue", oldValue, snapToValue);
public void	setUI(javax.swing.plaf.SliderUI ui) Sets the UI object which implements the L&F for this component. param ui the SliderUI L&F object see UIDefaults#getUI beaninfo bound: true hidden: true attribute: visualUpdate true description: The UI object that implements the slider's LookAndFeel. super.setUI(ui);
public void	setValue(int n) Sets the slider's current value to {@code n}. This method forwards the new value to the model. The data model (an instance of {@code BoundedRangeModel}) handles any mathematical issues arising from assigning faulty values. See the {@code BoundedRangeModel} documentation for details. If the new value is different from the previous value, all change listeners are notified. param n the new value see #getValue see #addChangeListener see BoundedRangeModel#setValue beaninfo preferred: true description: The sliders current value. BoundedRangeModel m = getModel(); int oldValue = m.getValue(); if (oldValue == n) { return; } m.setValue(n); if (accessibleContext != null) { accessibleContext.firePropertyChange( AccessibleContext.ACCESSIBLE_VALUE_PROPERTY, new Integer(oldValue), new Integer(m.getValue())); }
public void	setValueIsAdjusting(boolean b) Sets the model's {@code valueIsAdjusting} property. Slider look and feel implementations should set this property to {@code true} when a knob drag begins, and to {@code false} when the drag ends. The slider model will not generate {@code ChangeEvent}s while {@code valueIsAdjusting} is {@code true}. param b the new value for the {@code valueIsAdjusting} property see #getValueIsAdjusting see BoundedRangeModel#setValueIsAdjusting beaninfo expert: true description: True if the slider knob is being dragged. BoundedRangeModel m = getModel(); boolean oldValue = m.getValueIsAdjusting(); m.setValueIsAdjusting(b); if ((oldValue != b) && (accessibleContext != null)) { accessibleContext.firePropertyChange( AccessibleContext.ACCESSIBLE_STATE_PROPERTY, ((oldValue) ? AccessibleState.BUSY : null), ((b) ? AccessibleState.BUSY : null)); }
private void	updateLabelSizes() Dictionary labelTable = getLabelTable(); if (labelTable != null) { Enumeration labels = labelTable.elements(); while (labels.hasMoreElements()) { Object value = labels.nextElement(); if (value instanceof JComponent) { JComponent component = (JComponent)value; component.setSize(component.getPreferredSize()); } } }
protected void	updateLabelUIs() Updates the UIs for the labels in the label table by calling {@code updateUI} on each label. The UIs are updated from the current look and feel. The labels are also set to their preferred size. see #setLabelTable see JComponent#updateUI if ( getLabelTable() == null ) { return; } Enumeration labels = getLabelTable().keys(); while ( labels.hasMoreElements() ) { Object value = getLabelTable().get( labels.nextElement() ); if ( value instanceof JComponent ) { JComponent component = (JComponent)value; component.updateUI(); component.setSize( component.getPreferredSize() ); } }
public void	updateUI() Resets the UI property to a value from the current look and feel. see JComponent#updateUI setUI((SliderUI)UIManager.getUI(this)); // The labels preferred size may be derived from the font // of the slider, so we must update the UI of the slider first, then // that of labels. This way when setSize is called the right // font is used. updateLabelUIs();
private void	writeObject(java.io.ObjectOutputStream s) See readObject() and writeObject() in JComponent for more information about serialization in Swing. s.defaultWriteObject(); if (getUIClassID().equals(uiClassID)) { byte count = JComponent.getWriteObjCounter(this); JComponent.setWriteObjCounter(this, --count); if (count == 0 && ui != null) { ui.installUI(this); } }