javax.swing
인터페이스 Action

모든 슈퍼 인터페이스:

ActionListener , EventListener

기존의 구현 클래스의 일람:

AbstractAction

public interface Action

extends ActionListener

Action 인터페이스는 같은 기능이 복수의 컨트롤에 의해 액세스 되는 경우에,ActionListener 인터페이스에 대한 편리한 확장 기능을 제공합니다.

ActionListener 인터페이스로 정의되는 actionPerformed 메소드에 가세해 이 인터페이스를 사용하면(자), 어플리케이션에서는 다음 일을 1 개소에서 정의할 수 있습니다.

• 기능을 설명하는 1 kr 또는 복수의 텍스트 캐릭터 라인. 이 캐릭터 라인은 버튼 위에 마우스를 두었을 때의 텍스트 표시나, 메뉴 항목의 텍스트의 설정에 사용할 수 있다
• 기능을 나타내는 1 kr 또는 복수의 아이콘. 이 아이콘은 메뉴 컨트롤내의 이미지나, 보다 고도의 유저 인터페이스로 사용하는 복합 엔트리에 사용할 수 있다
• 기능의 유효/무효 상태. 메뉴 항목과 툴바 버튼을 개별적으로 무효로 하는 대신에, 어플리케이션은 이 인터페이스를 구현하는 기능을 무효로 할 수 있다. 상태 변화의 청취자로서 등록되어 모든 컴퍼넌트는 해당하는 항목에의 이벤트 생성을 무효로 하는 통지를 받아 표시를 거기에 맞추어 변경한다

Action 오브젝트의 추가 방법의 정보를 가져, 메뉴나 툴바를 포함한, 특정의 컨테이너. 이 컨테이너에 Action 오브젝트가 추가되면(자), 컨테이너는 다음 일을 실행합니다.

1. 그 컨테이너에 대한 적절한 컴퍼넌트의 생성. 예를 들어, 툴바가 버튼 컴퍼넌트를 생성하는 등
2. 컴퍼넌트를 커스터마이즈 하는데 적절한 프로퍼티의 Action 오브젝트로부터의 취득. 예를 들어, 아이콘의 이미지 및 버튼상에 커서가 있을 때 표시되는 텍스트
3. Action 오브젝트의 초기 상태의 확인, 유효한가 무효인가의 결정, 및 적절한 방법에서의 컴퍼넌트의 표현
4. Action 오브젝트와 함께 청취자를 등록해, 상태의 변화가 통지되도록(듯이) 한다. Action 오브젝트가 유효로부터 무효에 변화하거나 돌아오거나 했을 경우에, 컨테이너는 이벤트 생성 기구에 적절한 변경을 더해 거기에 맞추어 컴퍼넌트를 표현 한다

예를 들어, 메뉴 항목 및 툴바 버튼은 양쪽 모두 Cut 액션 오브젝트에 액세스 할 수 있습니다. 이 오브젝트에 관련한 텍스트는 「Cut」로서 지정되어 가위의 이미지가 오브젝트의 아이콘으로 지정됩니다. 이와 같이 해,Cut 라고 하는 액션 오브젝트는 메뉴 및 툴바에 추가됩니다. 각 컨테이너는 오브젝트를 적절히 취급해, 관련한 컴퍼넌트가 액티브하게 되면(자),actionPerformed 메소드를 호출합니다. 이것으로 어플리케이션은 어플리케이션 오브젝트를 유효 혹은 무효로 할 때에, 어느 유저 인터페이스 컴퍼넌트가 접속되고 있을까를 신경쓰지 않고 끝납니다.

이 인터페이스는 기존의 클래스에 추가하거나 어댑터의 생성 (통상은 AbstractAction 의 서브 클래스화)에 사용하거나 할 수가 있습니다. 그리고,Action 오브젝트가 복수의 액션 처리 컨테이너에 추가되어 Action 의 기능을 가진 컴퍼넌트에 접속됩니다. 이것에 의해,Action 오브젝트의 setEnabled 메소드를 호출해, GUI 컨트롤을 한 번에 기동 또는 종료할 수 있습니다.

Action 의 구현은 기억 area의 점으로써 통상의 ActionListener 보다 불가가 커지는 것이 많기 때문에, 기능의 중앙 제어나 프로퍼티 변경의 통지라고 하는 이점을 제공할 수 없습니다. 이 때문에, 이러한 기능을 이용할 필요가 있는 경우에게만 Action 를 사용하도록(듯이) 해, 그 이외에서는 단순한 ActionListener 를 사용하도록 해 주세요.

관련 항목:

AbstractAction

필드의 개요

static String	ACCELERATOR_KEY 액션의 가속기로서 사용하는 KeyStroke 의 저장에 사용하는 키입니다.
static String	ACTION_COMMAND_KEY JComponent 에 관련지을 수 있었던 Keymap 에 상주하고 있는 결과적으로,Action 가 통지될 때 생성되는 ActionEvent 의 커멘드 캐릭터 라인의 판정에 사용하는 키입니다.
static String	DEFAULT 오브젝트의 프로퍼티 (텍스트 또는 아이콘)를 설정 또는 취득할 경우에, 기억 취득 키로서 사용하면(자) 편리한 정수입니다.
static String	LONG_DESCRIPTION 액션에 대한 상세한 설명을 저장하기 위해서 사용되는 키입니다.
static String	MNEMONIC_KEY 액션의 무릎 관절 모닛크로서 사용하는 정수치 키코드의 저장에 사용하는 키입니다.
static String	NAME 액션의 이름을 저장하기 위해서 사용되는 키입니다.
static String	SHORT_DESCRIPTION 액션에 대한 짧은 설명을 저장하기 위해서 사용되는 키입니다.
static String	SMALL_ICON 액션에 대응하는 작은 아이콘을 저장하기 위해서 사용되는 키입니다.

메소드의 개요

void	addPropertyChangeListener (PropertyChangeListener listener) PropertyChange 청취자를 추가합니다.
Object	getValue (String key) 관련지을 수 있고 있는 키를 사용해 오브젝트의 프로퍼티의 1 개를 돌려줍니다.
boolean	isEnabled () Action 의 유효 상태를 조사합니다.
void	putValue (String key, Object value) 관련지을 수 있고 있는 키를 사용해, 오브젝트의 프로퍼티의 1 개를 설정합니다.
void	removePropertyChangeListener (PropertyChangeListener listener) PropertyChange 청취자를 삭제합니다.
void	setEnabled (boolean b) Action 의 유효 상태를 설정합니다.

인터페이스 java.awt.event. ActionListener 에서 상속받은 메소드

actionPerformed

필드의 상세

DEFAULT

public static final String  DEFAULT

오브젝트의 프로퍼티 (텍스트 또는 아이콘)를 설정 또는 취득할 경우에, 기억 취득 키로서 사용하면(자) 편리한 정수입니다.

관련 항목:

정수 필드치

NAME

public static final String  NAME

액션의 이름을 저장하기 위해서 사용되는 키입니다. 메뉴 또는 버튼으로 사용됩니다.

관련 항목:

정수 필드치

SHORT_DESCRIPTION

public static final String  SHORT_DESCRIPTION

액션에 대한 짧은 설명을 저장하기 위해서 사용되는 키입니다. 툴 힌트의 텍스트에 사용됩니다.

관련 항목:

정수 필드치

LONG_DESCRIPTION

public static final String  LONG_DESCRIPTION

액션에 대한 상세한 설명을 저장하기 위해서 사용되는 키입니다. 문맥 의존 헬프로 사용할 수 있습니다.

관련 항목:

정수 필드치

SMALL_ICON

public static final String  SMALL_ICON

액션에 대응하는 작은 아이콘을 저장하기 위해서 사용되는 키입니다. 툴바의 버튼에 사용됩니다.

관련 항목:

정수 필드치

ACTION_COMMAND_KEY

public static final String  ACTION_COMMAND_KEY

JComponent 에 관련지을 수 있었던 Keymap 에 상주하고 있는 결과적으로,Action 가 통지될 때 생성되는 ActionEvent 의 커멘드 캐릭터 라인의 판정에 사용하는 키입니다.

관련 항목:

정수 필드치

ACCELERATOR_KEY

public static final String  ACCELERATOR_KEY

액션의 가속기로서 사용하는 KeyStroke 의 저장에 사용하는 키입니다.

도입된 버젼:

1.3

관련 항목:

정수 필드치

MNEMONIC_KEY

public static final String  MNEMONIC_KEY

액션의 무릎 관절 모닛크로서 사용하는 정수치 키코드의 저장에 사용하는 키입니다.

도입된 버젼:

1.3

관련 항목:

정수 필드치

메소드의 상세

getValue

public Object  getValue(String  key)

관련지을 수 있고 있는 키를 사용해 오브젝트의 프로퍼티의 1 개를 돌려줍니다.

관련 항목:

putValue(java.lang.String, java.lang.Object)

putValue

public void putValue(String  key,
                     Object  value)

관련지을 수 있고 있는 키를 사용해, 오브젝트의 프로퍼티의 1 개를 설정합니다. 값이 변경되면(자),PropertyChangeEvent 가 청취자에게 송신됩니다.

파라미터:

key - 키가 저장되고 있는 String

value - Object 치

setEnabled

public void setEnabled(boolean b)

Action 의 유효 상태를 설정합니다. 유효한 경우, 이 오브젝트에 관련한 임의의 컴퍼넌트는 액티브하고, 오브젝트의 actionPerformed 메소드를 방아쇠 할 수 있습니다. 값이 변경되면(자),PropertyChangeEvent 가 청취자에게 송신됩니다.

파라미터:

b - 이 Action 를 유효하게 하는 경우는 true, 무효로 하는 경우는 false

isEnabled

public boolean isEnabled()

Action 의 유효 상태를 조사합니다. 유효한 경우는 이 오브젝트에 관련한 임의의 컴퍼넌트는 액티브하고, 오브젝트의 actionPerformed 메소드를 방아쇠 할 수 있습니다.

반환값:

이 Action 가 유효한 경우는 true

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener  listener)

PropertyChange 청취자를 추가합니다. 컨테이너, 및 접속된 컴퍼넌트는 이러한 메소드를 사용해 Action 오브젝트의 통지 대상으로 해 등록합니다. Action 오브젝트가 유효하게 되었을 경우, 또는 그 외의 프로퍼티가 변화했을 경우, 등록된 청취자로 변경이 통지됩니다.

파라미터:

listener - PropertyChangeListener 오브젝트

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener  listener)

PropertyChange 청취자를 삭제합니다.

파라미터:

listener - PropertyChangeListener 오브젝트

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener)