001: /*
002: * @(#)ItemEvent.java 1.23 06/10/10
003: *
004: * Copyright 1990-2006 Sun Microsystems, Inc. All Rights Reserved.
005: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
006: *
007: * This program is free software; you can redistribute it and/or
008: * modify it under the terms of the GNU General Public License version
009: * 2 only, as published by the Free Software Foundation.
010: *
011: * This program is distributed in the hope that it will be useful, but
012: * WITHOUT ANY WARRANTY; without even the implied warranty of
013: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
014: * General Public License version 2 for more details (a copy is
015: * included at /legal/license.txt).
016: *
017: * You should have received a copy of the GNU General Public License
018: * version 2 along with this work; if not, write to the Free Software
019: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA
021: *
022: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
023: * Clara, CA 95054 or visit www.sun.com if you need additional
024: * information or have any questions.
025: *
026: */
027:
028: package java.awt.event;
029:
030: import java.awt.Component;
031: import java.awt.AWTEvent;
032: import java.awt.ItemSelectable;
033:
034: /**
035: * The item event emitted by ItemSelectable objects.
036: * This event is generated when an item is selected or de-selected.
037: * @see java.awt.ItemSelectable
038: * @see ItemListener
039: *
040: * @version 1.19 08/19/02
041: * @author Carl Quinn
042: */
043: public class ItemEvent extends AWTEvent {
044: /**
045: * Marks the first integer id for the range of item event ids.
046: */
047: public static final int ITEM_FIRST = 701;
048: /**
049: * Marks the last integer id for the range of item event ids.
050: */
051: public static final int ITEM_LAST = 701;
052: /**
053: * The item state changed event type.
054: */
055: public static final int ITEM_STATE_CHANGED = ITEM_FIRST; //Event.LIST_SELECT
056: /**
057: * The item selected state change type.
058: */
059: public static final int SELECTED = 1;
060: /**
061: * The item de-selected state change type.
062: */
063: public static final int DESELECTED = 2;
064: Object item;
065: int stateChange;
066: /*
067: * JDK 1.1 serialVersionUID
068: */
069: private static final long serialVersionUID = -608708132447206933L;
070:
071: /**
072: * Constructs a ItemSelectEvent object with the specified ItemSelectable source,
073: * type, item, and item select state.
074: * @param source the ItemSelectable object where the event originated
075: * @id the event type
076: * @item the item where the event occurred
077: * @stateChange the state change type which caused the event
078: */
079: public ItemEvent(ItemSelectable source, int id, Object item,
080: int stateChange) {
081: super (source, id);
082: this .item = item;
083: this .stateChange = stateChange;
084: }
085:
086: /**
087: * Returns the ItemSelectable object where this event originated.
088: */
089: public ItemSelectable getItemSelectable() {
090: return (ItemSelectable) source;
091: }
092:
093: /**
094: * Returns the item where the event occurred.
095: */
096: public Object getItem() {
097: return item;
098: }
099:
100: /**
101: * Returns the state change type which generated the event.
102: * @see #SELECTED
103: * @see #DESELECTED
104: */
105: public int getStateChange() {
106: return stateChange;
107: }
108:
109: public String paramString() {
110: String typeStr;
111: switch (id) {
112: case ITEM_STATE_CHANGED:
113: typeStr = "ITEM_STATE_CHANGED";
114: break;
115:
116: default:
117: typeStr = "unknown type";
118: }
119: String stateStr;
120: switch (stateChange) {
121: case SELECTED:
122: stateStr = "SELECTED";
123: break;
124:
125: case DESELECTED:
126: stateStr = "DESELECTED";
127: break;
128:
129: default:
130: stateStr = "unknown type";
131: }
132: return typeStr + ",item=" + item + ",stateChange=" + stateStr;
133: }
134: }
|