JavaTM Platform
Standard Ed. 6

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 객체에게 건네집니다.  

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

ActionListener 인터페이스를 구현하고 있는 객체는, 이벤트 발생시에 이 ActionEvent 를 가져옵니다. 따라서, 청취자는 개개의 마우스의 동작이나 마우스 클릭과 같이 세세한 처리를 하는 일 없이, 그 대신에 「버튼을 누른다」라고 한 「의미가 있다」이벤트를 처리할 수가 있습니다.

도입된 버젼:
1.1
관련 항목:
ActionListener , 「Tutorial: Java 1.1 Event Model」, 직렬화 된 형식

필드의 개요
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 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 sourcenull 의 경우에 IllegalArgumentException 를 throw 합니다. null command 캐릭터 라인은 잘못이 아닙니다만, 추천 되지 않습니다.

파라미터:
source - 이벤트의 발생원의 객체
id - 이벤트를 식별하는 정수형
command - 이벤트에 관련지을 수 있었던 1 개의 커멘드 (일반적으로은 복수의 커멘드의 어느쪽이든)(을)를 지정하는 캐릭터 라인
예외:
IllegalArgumentException - source 가 null 의 경우

ActionEvent

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

무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 sourcenull 의 경우에 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 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 sourcenull 의 경우에 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
반환값:
이벤트를 식별하는 캐릭터 라인과 거기에 관련한 커멘드

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.