public class ItemEvent extends AWTEvent
ItemListener object which
registered to receive such events using the component's
addItemListener method.
The object that implements the ItemListener interface gets
this ItemEvent when the event occurs. The listener is
spared the details of processing individual mouse movements and mouse
clicks, and can instead process a "meaningful" (semantic) event like
"item selected" or "item deselected".
An unspecified behavior will be caused if the id parameter
of any particular ItemEvent instance is not
in the range from ITEM_FIRST to ITEM_LAST.
The stateChange of any ItemEvent instance takes one of the following
values:
ItemEvent.SELECTED
ItemEvent.DESELECTED
ItemSelectable,
ItemListener,
Tutorial: Writing an Item Listener,
Serialized Form| Modifier and Type | Field and Description |
|---|---|
static int |
DESELECTED
This state-change-value indicates that a selected item was deselected.
|
static int |
ITEM_FIRST
The first number in the range of ids used for item events.
|
static int |
ITEM_LAST
The last number in the range of ids used for item events.
|
static int |
ITEM_STATE_CHANGED
This event id indicates that an item's state changed.
|
static int |
SELECTED
This state-change value indicates that an item was selected.
|
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_MASKsource| Constructor and Description |
|---|
ItemEvent(ItemSelectable source,
int id,
Object item,
int stateChange)
Constructs an
ItemEvent object. |
| Modifier and Type | Method and Description |
|---|---|
Object |
getItem()
Returns the item affected by the event.
|
ItemSelectable |
getItemSelectable()
Returns the originator of the event.
|
int |
getStateChange()
Returns the type of state change (selected or deselected).
|
String |
paramString()
Returns a parameter string identifying this item event.
|
getSourcepublic static final int ITEM_FIRST
public static final int ITEM_LAST
public static final int ITEM_STATE_CHANGED
public static final int SELECTED
public static final int DESELECTED
public ItemEvent(ItemSelectable source, int id, Object item, int stateChange)
ItemEvent object.
This method throws an
IllegalArgumentException if source
is null.
source - The ItemSelectable object
that originated the eventid - The integer that identifies the event type.
For information on allowable values, see
the class description for ItemEventitem - An object -- the item affected by the eventstateChange - An integer that indicates whether the item was
selected or deselected.
For information on allowable values, see
the class description for ItemEventIllegalArgumentException - if source is nullgetItemSelectable(),
AWTEvent.getID(),
getStateChange()public ItemSelectable getItemSelectable()
public Object getItem()
public int getStateChange()
SELECTED,
DESELECTEDpublic String paramString()
paramString in class AWTEvent Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.