Class 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

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

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.

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

Fields

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

@Native
public static final int UNIT_INCREMENT

The unit increment adjustment type.

See Also:
Constant Field Values

UNIT_DECREMENT

@Native
public static final int UNIT_DECREMENT

The unit decrement adjustment type.

See Also:
Constant Field Values

BLOCK_DECREMENT

@Native
public static final int BLOCK_DECREMENT

The block decrement adjustment type.

See Also:
Constant Field Values

BLOCK_INCREMENT

@Native
public static final int BLOCK_INCREMENT

The block increment adjustment type.

See Also:
Constant Field Values

TRACK

@Native
public static final int TRACK

The absolute tracking adjustment type.

See Also:
Constant Field Values

Constructors

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()

Methods

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:

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

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/javase/8/docs/api/java/awt/event/AdjustmentEvent.html