1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142
/* * @(#)Adjustable.java 1.19 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package java.awt; import java.awt.event.*; /** * The interface for objects which have an adjustable numeric value * contained within a bounded range of values. * * @version 1.19 11/17/05 * @author Amy Fowler * @author Tim Prinzing */ public interface Adjustable { /** * Indicates that the <code>Adjustable</code> has horizontal orientation. */ public static final int HORIZONTAL = 0; /** * Indicates that the <code>Adjustable</code> has vertical orientation. */ public static final int VERTICAL = 1; /** * Indicates that the <code>Adjustable</code> has no orientation. */ public static final int NO_ORIENTATION = 2; /** * 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. * @param min the minimum value */ void setMinimum(int min); /** * 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. * @param max the maximum value */ void setMaximum(int max); /** * 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. * @param u the unit increment */ void setUnitIncrement(int u); /** * 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. * @param b the block increment */ void setBlockIncrement(int b); /** * 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. * @param v the length of the indicator */ void setVisibleAmount(int v); /** * 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 <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. * @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. * @param l the listener to receive events * @see AdjustmentEvent */ void addAdjustmentListener(AdjustmentListener l); /** * Removes an adjustment listener. * @param l the listener being removed * @see AdjustmentEvent */ void removeAdjustmentListener(AdjustmentListener l); }