001: /*
002: * @(#)ActionEvent.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.AWTEvent;
031:
032: /**
033: * The action semantic event.
034: * @see ActionListener
035: *
036: * @version 1.18 08/19/02
037: * @author Carl Quinn
038: */
039: public class ActionEvent extends AWTEvent {
040: /**
041: * The shift modifier constant.
042: * Note: these values are nolonger initialized from Event.class
043: * as this class is only present in PP, and not PBP.
044: */
045: public static final int SHIFT_MASK = 1 << 0; // Event.SHIFT_MASK;
046: /**
047: * The control modifier constant.
048: */
049: public static final int CTRL_MASK = 1 << 1; // Event.CTRL_MASK;
050: /**
051: * The meta modifier constant.
052: */
053: public static final int META_MASK = 1 << 2; // Event.META_MASK;
054: /**
055: * The alt modifier constant.
056: */
057: public static final int ALT_MASK = 1 << 3; // Event.ALT_MASK;
058: /**
059: * Marks the first integer id for the range of action event ids.
060: */
061: public static final int ACTION_FIRST = 1001;
062: /**
063: * Marks the last integer id for the range of action event ids.
064: */
065: public static final int ACTION_LAST = 1001;
066: /**
067: * An action performed event type.
068: */
069: public static final int ACTION_PERFORMED = ACTION_FIRST; //Event.ACTION_EVENT
070: String actionCommand;
071: int modifiers;
072: /*
073: * JDK 1.1 serialVersionUID
074: */
075: private static final long serialVersionUID = -7671078796273832149L;
076:
077: long when;
078:
079: /**
080: * Constructs an ActionEvent object with the specified source object.
081: * @param source the object where the event originated
082: * @param id the type of event
083: * @param command the command string for this action event
084: */
085: public ActionEvent(Object source, int id, String command) {
086: this (source, id, command, 0);
087: }
088:
089: /**
090: * Constructs an ActionEvent object with the specified source object.
091: * @param source the object where the event originated
092: * @param id the type of event
093: * @param command the command string for this action event
094: * @param modifiers the modifiers held down during this action
095: */
096: public ActionEvent(Object source, int id, String command,
097: int modifiers) {
098: super (source, id);
099: this .actionCommand = command;
100: this .modifiers = modifiers;
101: }
102:
103: public ActionEvent(Object source, int id, String command,
104: long when, int modifiers) {
105: super (source, id);
106: this .actionCommand = command;
107: this .when = when;
108: this .modifiers = modifiers;
109: }
110:
111: /**
112: * Returns the command name associated with this action.
113: */
114: public String getActionCommand() {
115: return actionCommand;
116: }
117:
118: /**
119: * Returns the modifiers held down during this action event.
120: */
121: public int getModifiers() {
122: return modifiers;
123: }
124:
125: public long getWhen() {
126: return when;
127: }
128:
129: public String paramString() {
130: String typeStr;
131: switch (id) {
132: case ACTION_PERFORMED:
133: typeStr = "ACTION_PERFORMED";
134: break;
135:
136: default:
137: typeStr = "unknown type";
138: }
139: return typeStr + ",cmd=" + actionCommand + ",when=" + when
140: + ",modifiers="
141: + KeyEvent.getKeyModifiersText(modifiers);
142: }
143: }
|