/*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package java.awt;
import java.awt.event.*;
The interface for objects which have an adjustable numeric value
contained within a bounded range of values.
Author: Amy Fowler, Tim Prinzing
/**
* The interface for objects which have an adjustable numeric value
* contained within a bounded range of values.
*
* @author Amy Fowler
* @author Tim Prinzing
*/
public interface Adjustable {
Indicates that the Adjustable
has horizontal orientation.
/**
* Indicates that the <code>Adjustable</code> has horizontal orientation.
*/
public static final int HORIZONTAL = 0;
Indicates that the Adjustable
has vertical orientation.
/**
* Indicates that the <code>Adjustable</code> has vertical orientation.
*/
public static final int VERTICAL = 1;
Indicates that the Adjustable
has no orientation.
/**
* Indicates that the <code>Adjustable</code> has no orientation.
*/
public static final int NO_ORIENTATION = 2;
Gets the orientation of the adjustable object.
Returns: the orientation of the adjustable object;
either HORIZONTAL
, VERTICAL
,
or NO_ORIENTATION
/**
* Gets the orientation of the adjustable object.
* @return the orientation of the adjustable object;
* either <code>HORIZONTAL</code>, <code>VERTICAL</code>,
* or <code>NO_ORIENTATION</code>
*/
int getOrientation();
Sets the minimum value of the adjustable object.
Params: - min – the minimum value
/**
* Sets the minimum value of the adjustable object.
* @param min the minimum value
*/
void setMinimum(int min);
Gets the minimum value of the adjustable object.
Returns: the minimum value of the adjustable object
/**
* Gets the minimum value of the adjustable object.
* @return the minimum value of the adjustable object
*/
int getMinimum();
Sets the maximum value of the adjustable object.
Params: - max – the maximum value
/**
* Sets the maximum value of the adjustable object.
* @param max the maximum value
*/
void setMaximum(int max);
Gets the maximum value of the adjustable object.
Returns: the maximum value of the adjustable object
/**
* Gets the maximum value of the adjustable object.
* @return the maximum value of the adjustable object
*/
int getMaximum();
Sets the unit value increment for the adjustable object.
Params: - u – the unit increment
/**
* Sets the unit value increment for the adjustable object.
* @param u the unit increment
*/
void setUnitIncrement(int u);
Gets the unit value increment for the adjustable object.
Returns: the unit value increment for the adjustable object
/**
* Gets the unit value increment for the adjustable object.
* @return the unit value increment for the adjustable object
*/
int getUnitIncrement();
Sets the block value increment for the adjustable object.
Params: - b – the block increment
/**
* Sets the block value increment for the adjustable object.
* @param b the block increment
*/
void setBlockIncrement(int b);
Gets the block value increment for the adjustable object.
Returns: the block value increment for the adjustable object
/**
* Gets the block value increment for the adjustable object.
* @return the block value increment for the adjustable object
*/
int getBlockIncrement();
Sets the length of the proportional indicator of the
adjustable object.
Params: - v – the length of the indicator
/**
* Sets the length of the proportional indicator of the
* adjustable object.
* @param v the length of the indicator
*/
void setVisibleAmount(int v);
Gets the length of the proportional indicator.
Returns: the length of the proportional indicator
/**
* Gets the length of the proportional indicator.
* @return the length of the proportional indicator
*/
int getVisibleAmount();
Sets the current value of the adjustable object. If
the value supplied is less than minimum
or greater than maximum
- visibleAmount
,
then one of those values is substituted, as appropriate.
Calling this method does not fire an
AdjustmentEvent
.
Params: - v – the current value, between
minimum
and maximum
- visibleAmount
/**
* Sets the current value of the adjustable object. If
* the value supplied is less than <code>minimum</code>
* or greater than <code>maximum</code> - <code>visibleAmount</code>,
* then one of those values is substituted, as appropriate.
* <p>
* Calling this method does not fire an
* <code>AdjustmentEvent</code>.
*
* @param v the current value, between <code>minimum</code>
* and <code>maximum</code> - <code>visibleAmount</code>
*/
void setValue(int v);
Gets the current value of the adjustable object.
Returns: the current value of the adjustable object
/**
* Gets the current value of the adjustable object.
* @return the current value of the adjustable object
*/
int getValue();
Adds a listener to receive adjustment events when the value of
the adjustable object changes.
Params: - l – the listener to receive events
See Also:
/**
* Adds a listener to receive adjustment events when the value of
* the adjustable object changes.
* @param l the listener to receive events
* @see AdjustmentEvent
*/
void addAdjustmentListener(AdjustmentListener l);
Removes an adjustment listener.
Params: - l – the listener being removed
See Also:
/**
* Removes an adjustment listener.
* @param l the listener being removed
* @see AdjustmentEvent
*/
void removeAdjustmentListener(AdjustmentListener l);
}