java.awt.event
클래스 ActionEvent

java.lang.Object 
  java.util.EventObject 
      java.awt.AWTEvent 
          java.awt.event.ActionEvent

모든 구현된 인터페이스:

Serializable

public class ActionEvent
extends AWTEvent 

컴퍼넌트가 정의하는 액션이 발생한 것을 나타내는 미상의 이벤트입니다. 이 고레벨의 이벤트는 컴퍼넌트 특유의 액션이 생겼을 때에 (버튼이 눌렸을 때 등), 그 컴퍼넌트 (Button)에 의해 생성됩니다. 이벤트는 그 컴퍼넌트의 addActionListener 메서드를 사용해, 그러한 이벤트를 받도록 등록되어 모든 ActionListener 객체에게 건네집니다.

주: 키보드를 사용해, Button ActionEvent를 호출하려면, 스페이스 키를 사용합니다.

ActionListener인터페이스를 구현하고 있는 객체는 이벤트가 발생했을 때에 이 ActionEvent를 취득합니다. 따라서, 리스너는 마우스의 움직임이나 마우스의 클릭을 개개에 처리하는 일 없이, 버튼이 눌렸을 때 등에 발생하는 「의미가 있다」이벤트를 처리합니다.

도입된 버전 :

1.1

관련 항목:

ActionListener, Tutorial: Java 1.1 Event Model, Reference: The Java Class Libraries (update file), 직렬화 된 형식

필드 개요

static int	ACTION_FIRST 액션 이벤트 식별자에 사용하는 정수의 범위에 있는 최초의 번호입니다.
static int	ACTION_LAST 액션 이벤트 식별자에 사용하는 정수의 범위에 있는 마지막 번호입니다.
static int	ACTION_PERFORMED 이 이벤트 식별자는 미가 있는 액션이 발생한 것을 나타냅니다.
static int	ALT_MASK Alt 수식자입니다.
static int	CTRL_MASK Control 수식자입니다.
static int	META_MASK Meta 수식자입니다.
static int	SHIFT_MASK Shift 수식자입니다.

클래스 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

클래스 java.util. EventObject 로부터 상속된 필드

source

생성자 개요

ActionEvent (Object source, int id, String command)
ActionEvent 객체를 구축합니다.

ActionEvent (Object source, int id, String command, int modifiers)
수식 키를 가지는 ActionEvent 객체를 구축합니다.

ActionEvent (Object source, int id, String command, long when, int modifiers)
특정의 수식 키와 타임 스탬프를 가지는 ActionEvent 객체를 구축합니다.

메서드 개요

String	getActionCommand () 액션에 관련한 커멘드 캐릭터 라인을 리턴합니다.
int	getModifiers () 액션 이벤트의 발생중에 눌려진수식 키를 리턴합니다.
long	getWhen () 이 이벤트가 발생한 시점의 타임 스탬프를 리턴합니다.
String	paramString () 액션 이벤트를 판별하는 파라미터 캐릭터 라인을 리턴합니다.

클래스 java.awt. AWTEvent 로부터 상속된 메서드

consume, getID, isConsumed, setSource, toString

클래스 java.util. EventObject 로부터 상속된 메서드

getSource

클래스 java.lang. Object 로부터 상속된 메서드

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

필드의 상세

SHIFT_MASK

public static final int SHIFT_MASK

Shift 수식자입니다. 이벤트중에 Shift 키가 눌려진것을 나타냅니다.

관련 항목:

정수 필드값

CTRL_MASK

public static final int CTRL_MASK

Control 수식자입니다. 이벤트중에 Ctrl 키가 눌려진것을 나타냅니다.

관련 항목:

정수 필드값

META_MASK

public static final int META_MASK

Meta 수식자입니다. 이벤트중에 메타키가 눌려진것을 나타냅니다.

관련 항목:

정수 필드값

ALT_MASK

public static final int ALT_MASK

Alt 수식자입니다. 이벤트중에 Alt 키가 눌려진것을 나타냅니다.

관련 항목:

정수 필드값

ACTION_FIRST

public static final int ACTION_FIRST

액션 이벤트 식별자에 사용하는 정수의 범위에 있는 최초의 번호입니다.

관련 항목:

정수 필드값

ACTION_LAST

public static final int ACTION_LAST

액션 이벤트 식별자에 사용하는 정수의 범위에 있는 마지막 번호입니다.

관련 항목:

정수 필드값

ACTION_PERFORMED

public static final int ACTION_PERFORMED

이 이벤트 식별자는 미가 있는 액션이 발생한 것을 나타냅니다.

관련 항목:

정수 필드값

생성자 상세

ActionEvent

public ActionEvent(Object  source,
                   int id,
                   String  command)

ActionEvent 객체를 구축합니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. source가 null인 경우, 이 메서드는 IllegalArgumentException을 Throw 합니다. null command 캐릭터 라인은 잘못이 아닙니다만, 추천 되지 않습니다.

파라미터:

source - 이벤트의 발생원의 객체

id - 이벤트를 식별하는 정수형

command - 이벤트에 관련된 1개의 커멘드 (일반적으로 복수의 커멘드의 어느쪽이든)를 지정하는 캐릭터 라인

예외:

IllegalArgumentException - source가 null인 경우

ActionEvent

public ActionEvent(Object  source,
                   int id,
                   String  command,
                   int modifiers)

수식 키를 가지는 ActionEvent 객체를 구축합니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. source가 null인 경우, 이 메서드는 IllegalArgumentException을 Throw 합니다. null command 캐릭터 라인은 잘못이 아닙니다만, 추천 되지 않습니다.

파라미터:

source - 이벤트의 발생원의 객체

id - 이벤트를 식별하는 정수형

command - 이벤트에 관련된 1개의 커멘드 (일반적으로 복수의 커멘드의 어느쪽이든)를 지정하는 캐릭터 라인

modifiers - 이 액션중에 눌려진수식 키

예외:

IllegalArgumentException - source가 null인 경우

ActionEvent

public ActionEvent(Object  source,
                   int id,
                   String  command,
                   long when,
                   int modifiers)

특정의 수식 키와 타임 스탬프를 가지는 ActionEvent 객체를 구축합니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. source가 null인 경우, 이 메서드는 IllegalArgumentException을 Throw 합니다. null command 캐릭터 라인은 잘못이 아닙니다만, 추천 되지 않습니다.

파라미터:

source - 이벤트의 발생원의 객체

id - 이벤트를 식별하는 정수형

command - 이벤트에 관련된 1개의 커멘드 (일반적으로 복수의 커멘드의 어느쪽이든)를 지정하는 캐릭터 라인

when - 이벤트가 발생한 시간

modifiers - 이 액션중에 눌려진수식 키

예외:

IllegalArgumentException - source가 null인 경우

도입된 버전 :

1.4

메서드의 상세

getActionCommand

public String  getActionCommand()

액션에 관련한 커멘드 캐릭터 라인을 리턴합니다. 이 캐릭터 라인은 「모덜인」컴퍼넌트가 그 상태에 응해, 몇개의 커멘드 가운데로부터 1개를 지정할 수 있습니다 . 예를 들어 단일의 버튼으로 「상세 표시」와「상세비표시」를 교체됩니다. 발생원의 객체와 이벤트는 각각의 경우에 대해 동일합니다만, 커멘드 캐릭터 라인은 도한 액션을 나타냅니다.

null 커멘드 캐릭터 라인을 이 ActionEvent 생성자에 건네주었을 경우, 이 메서드는 null을 리턴합니다.

반환값:

이 이벤트에 대한 커멘드를 식별하는 캐릭터 라인

getWhen

public long getWhen()

이 이벤트가 발생한 시점의 타임 스탬프를 리턴합니다. ActionEvent가 고레벨의 세만틱이벤트이기 때문에 보통, 타임 스탬프는 기본이 되는 InputEvent와 같게 됩니다.

반환값:

이 이벤트의 타임 스탬프

도입된 버전 :

1.4

getModifiers

public int getModifiers()

액션 이벤트의 발생중에 눌려진수식 키를 리턴합니다.

반환값:

수식자의 정수의 비트 단위의 논리합

paramString

public String  paramString()

액션 이벤트를 판별하는 파라미터 캐릭터 라인을 리턴합니다. 이 메서드는 이벤트 로그의 작성 및 디버그에 도움이 됩니다.

오버라이드(override):

클래스 AWTEvent 내의 paramString

반환값:

이벤트를 식별하는 캐릭터 라인과 거기에 관련한 커멘드