java.awt.event

Class AdjustmentEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.AdjustmentEvent

All Implemented Interfaces:

Serializable

public class AdjustmentEvent
extends AWTEvent

The adjustment event emitted by Adjustable objects like Scrollbar and ScrollPane. When the user changes the value of the scrolling component, it receives an instance of AdjustmentEvent.

An unspecified behavior will be caused if the id parameter of any particular AdjustmentEvent instance is not in the range from ADJUSTMENT_FIRST to ADJUSTMENT_LAST.

The type of any AdjustmentEvent instance takes one of the following values:

• UNIT_INCREMENT
• UNIT_DECREMENT
• BLOCK_INCREMENT
• BLOCK_DECREMENT
• TRACK

Assigning the value different from listed above will cause an unspecified behavior.

Since:

1.1

See Also:

Adjustable, AdjustmentListener, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	ADJUSTMENT_FIRST Marks the first integer id for the range of adjustment event ids.
static int	ADJUSTMENT_LAST Marks the last integer id for the range of adjustment event ids.
static int	ADJUSTMENT_VALUE_CHANGED The adjustment value changed event.
static int	BLOCK_DECREMENT The block decrement adjustment type.
static int	BLOCK_INCREMENT The block increment adjustment type.
static int	TRACK The absolute tracking adjustment type.
static int	UNIT_DECREMENT The unit decrement adjustment type.
static int	UNIT_INCREMENT The unit increment adjustment type.

Fields inherited from class java.awt.AWTEvent

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
AdjustmentEvent(Adjustable source, int id, int type, int value) Constructs an AdjustmentEvent object with the specified Adjustable source, event type, adjustment type, and value.
AdjustmentEvent(Adjustable source, int id, int type, int value, boolean isAdjusting) Constructs an AdjustmentEvent object with the specified Adjustable source, event type, adjustment type, and value.

Method Summary

Methods

Modifier and Type	Method and Description
Adjustable	getAdjustable() Returns the Adjustable object where this event originated.
int	getAdjustmentType() Returns the type of adjustment which caused the value changed event.
int	getValue() Returns the current value in the adjustment event.
boolean	getValueIsAdjusting() Returns true if this is one of multiple adjustment events.
String	paramString() Returns a string representing the state of this Event.

Methods inherited from class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ADJUSTMENT_FIRST

public static final int ADJUSTMENT_FIRST

Marks the first integer id for the range of adjustment event ids.

See Also:

Constant Field Values

ADJUSTMENT_LAST

public static final int ADJUSTMENT_LAST

Marks the last integer id for the range of adjustment event ids.

See Also:

Constant Field Values

ADJUSTMENT_VALUE_CHANGED

public static final int ADJUSTMENT_VALUE_CHANGED

The adjustment value changed event.

See Also:

Constant Field Values

UNIT_INCREMENT

public static final int UNIT_INCREMENT

The unit increment adjustment type.

See Also:

Constant Field Values

UNIT_DECREMENT

public static final int UNIT_DECREMENT

The unit decrement adjustment type.

See Also:

Constant Field Values

BLOCK_DECREMENT

public static final int BLOCK_DECREMENT

The block decrement adjustment type.

See Also:

Constant Field Values

BLOCK_INCREMENT

public static final int BLOCK_INCREMENT

The block increment adjustment type.

See Also:

Constant Field Values

TRACK

public static final int TRACK

The absolute tracking adjustment type.

See Also:

Constant Field Values

Constructor Detail

AdjustmentEvent

public AdjustmentEvent(Adjustable source,
               int id,
               int type,
               int value)

Constructs an AdjustmentEvent object with the specified Adjustable source, event type, adjustment type, and value.

This method throws an IllegalArgumentException if source is null.

Parameters:

source - The Adjustable object where the event originated

id - An integer indicating the type of event. For information on allowable values, see the class description for AdjustmentEvent

type - An integer indicating the adjustment type. For information on allowable values, see the class description for AdjustmentEvent

value - The current value of the adjustment

Throws:

IllegalArgumentException - if source is null

See Also:

EventObject.getSource(), AWTEvent.getID(), getAdjustmentType(), getValue()

AdjustmentEvent

public AdjustmentEvent(Adjustable source,
               int id,
               int type,
               int value,
               boolean isAdjusting)

Constructs an AdjustmentEvent object with the specified Adjustable source, event type, adjustment type, and value.

This method throws an IllegalArgumentException if source is null.

Parameters:

source - The Adjustable object where the event originated

id - An integer indicating the type of event. For information on allowable values, see the class description for AdjustmentEvent

type - An integer indicating the adjustment type. For information on allowable values, see the class description for AdjustmentEvent

value - The current value of the adjustment

isAdjusting - A boolean that equals true if the event is one of a series of multiple adjusting events, otherwise false

Throws:

IllegalArgumentException - if source is null

Since:

1.4

See Also:

EventObject.getSource(), AWTEvent.getID(), getAdjustmentType(), getValue(), getValueIsAdjusting()

Method Detail

getAdjustable

public Adjustable getAdjustable()

Returns the Adjustable object where this event originated.

Returns:

the Adjustable object where this event originated

getValue

public int getValue()

Returns the current value in the adjustment event.

Returns:

the current value in the adjustment event

getAdjustmentType

public int getAdjustmentType()

Returns the type of adjustment which caused the value changed event. It will have one of the following values:

• UNIT_INCREMENT
• UNIT_DECREMENT
• BLOCK_INCREMENT
• BLOCK_DECREMENT
• TRACK

Returns:

one of the adjustment values listed above

getValueIsAdjusting

public boolean getValueIsAdjusting()

Returns true if this is one of multiple adjustment events.

Returns:

true if this is one of multiple adjustment events, otherwise returns false

Since:

1.4

paramString

public String paramString()

Description copied from class: AWTEvent

Returns a string representing the state of this Event. 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.

Overrides:

paramString in class AWTEvent

Returns:

a string representation of this event