javax.swing
인터페이스 Action

모든 슈퍼 인터페이스:

ActionListener, EventListener

알려진 구현 클래스 목록:

AbstractAction, BasicDesktopPaneUI.CloseAction, BasicDesktopPaneUI.MaximizeAction, BasicDesktopPaneUI.MinimizeAction, BasicDesktopPaneUI.NavigateAction, BasicDesktopPaneUI.OpenAction, BasicFileChooserUI.ApproveSelectionAction, BasicFileChooserUI.CancelSelectionAction, BasicFileChooserUI.ChangeToParentDirectoryAction, BasicFileChooserUI.GoHomeAction, BasicFileChooserUI.NewFolderAction, BasicFileChooserUI.UpdateAction, BasicInternalFrameTitlePane.CloseAction, BasicInternalFrameTitlePane.IconifyAction, BasicInternalFrameTitlePane.MaximizeAction, BasicInternalFrameTitlePane.MoveAction, BasicInternalFrameTitlePane.RestoreAction, BasicInternalFrameTitlePane.SizeAction, BasicSliderUI.ActionScroller, BasicTreeUI.TreeCancelEditingAction, BasicTreeUI.TreeHomeAction, BasicTreeUI.TreeIncrementAction, BasicTreeUI.TreePageAction, BasicTreeUI.TreeToggleAction, BasicTreeUI.TreeTraverseAction, DefaultEditorKit.BeepAction, DefaultEditorKit.CopyAction, DefaultEditorKit.CutAction, DefaultEditorKit.DefaultKeyTypedAction, DefaultEditorKit.InsertBreakAction, DefaultEditorKit.InsertContentAction, DefaultEditorKit.InsertTabAction, DefaultEditorKit.PasteAction, HTMLEditorKit.HTMLTextAction, HTMLEditorKit.InsertHTMLTextAction, MetalFileChooserUI.DirectoryComboBoxAction, StyledEditorKit.AlignmentAction, StyledEditorKit.BoldAction, StyledEditorKit.FontFamilyAction, StyledEditorKit.FontSizeAction, StyledEditorKit.ForegroundAction, StyledEditorKit.ItalicAction, StyledEditorKit.StyledTextAction, StyledEditorKit.UnderlineAction, TextAction

public interface Action
extends ActionListener 

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

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

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

일부의 컨테이너는 메뉴나 툴바를 보관 유지해, Action 객체의 추가 방법을 인식하고 있습니다. 이러한 컨테이너에 Action 객체가 추가되면, 컨테이너는 다음 일을 실행합니다.

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

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

이 인터페이스는 기존의 클래스에 추가하거나 어댑터의 생성 (일반적으로 AbstractAction 상속)에 사용하거나 할 수 있습니다 . 그리고, Action 객체가 복수의 Action 처리 컨테이너에 추가되어Action 기능을 가진 컴퍼넌트에 접속됩니다. 이것에 의해 Action 객체의 setEnabled 메서드를 호출해, GUI 컨트롤을 한 번에 시작 또는 종료할 수 있습니다.

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

관련 항목:

AbstractAction

필드 개요

static String	ACCELERATOR_KEY 액션의 가속기로서 사용하는 KeyStroke 포함에 사용하는 키입니다.
static String	ACTION_COMMAND_KEY JComponent에 관련된 Keymap에 상주하고 있는 결과적으로Action가 통지될 때 생성되는 ActionEvent 커멘드 String 판정에 사용하는 키입니다.
static String	DEFAULT 현재 사용되지 않습니다.
static String	LONG_DESCRIPTION 액션에 대한 상세한 설명을 나타내는 String 포함에 사용하는 키입니다.
static String	MNEMONIC_KEY 액션의 Mnemonics로서 사용하는 KeyEvent 포함에 사용하는 키입니다.
static String	NAME 액션의 이름을 나타내는 String 포함에 사용하는 키입니다.
static String	SHORT_DESCRIPTION 액션에 대한 짧은 설명을 나타내는 String 포함에 사용하는 키입니다.
static String	SMALL_ICON 액션에 대응하는 작은 Icon (ImageIcon 등)의 포함에 사용하는 키입니다.

메서드 개요

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

static final String  DEFAULT

현재 사용되지 않습니다.

관련 항목:

정수 필드값

NAME

static final String  NAME

액션의 이름을 나타내는 String 포함에 사용하는 키입니다. 메뉴 또는 버튼으로 사용됩니다.

관련 항목:

정수 필드값

SHORT_DESCRIPTION

static final String  SHORT_DESCRIPTION

액션에 대한 짧은 설명을 나타내는 String 포함에 사용하는 키입니다. 툴 힌트의 텍스트에 사용됩니다.

관련 항목:

정수 필드값

LONG_DESCRIPTION

static final String  LONG_DESCRIPTION

액션에 대한 상세한 설명을 나타내는 String 포함에 사용하는 키입니다. 컨텍스트 존 헬프로 사용할 수 있습니다.

관련 항목:

정수 필드값

SMALL_ICON

static final String  SMALL_ICON

액션에 대응하는 작은 Icon (ImageIcon 등)의 포함에 사용하는 키입니다. 툴바의 버튼에 사용됩니다.

관련 항목:

정수 필드값

ACTION_COMMAND_KEY

static final String  ACTION_COMMAND_KEY

JComponent에 관련된 Keymap에 상주하고 있는 결과적으로Action가 통지될 때 생성되는 ActionEvent 커멘드 String 판정에 사용하는 키입니다.

관련 항목:

정수 필드값

ACCELERATOR_KEY

static final String  ACCELERATOR_KEY

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

도입된 버전 :

1.3

관련 항목:

정수 필드값

MNEMONIC_KEY

static final String  MNEMONIC_KEY

액션의 Mnemonics로서 사용하는 KeyEvent 포함에 사용하는 키입니다.

도입된 버전 :

1.3

관련 항목:

정수 필드값

메서드의 상세

getValue

Object  getValue(String  key)

관련된 키를 사용해 객체의 프로퍼티의 1개를 리턴합니다.

관련 항목:

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

putValue

void putValue(String  key,
              Object  value)

관련된 키를 사용해, 객체의 프로퍼티의 1개를 설정합니다. 값이 변경되면, PropertyChangeEvent이 리스너에게 송신됩니다.

파라미터:

key - 키가 포함되고 있는 String

value - Object 치

setEnabled

void setEnabled(boolean b)

Action 유효 상태를 설정합니다. 유효한 경우, 이 객체에 관련한 임의의 컴퍼넌트는 액티브하고, 객체의 actionPerformed 메서드를 트리거 할 수 있습니다. 값이 변경되면, PropertyChangeEvent이 리스너에게 송신됩니다.

파라미터:

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

isEnabled

boolean isEnabled()

Action 유효 상태를 조사합니다. 유효한 경우는 이 객체에 관련한 임의의 컴퍼넌트는 액티브하고, 객체의 actionPerformed 메서드를 트리거 할 수 있습니다.

반환값:

이 Action가 유효한 경우는 true

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener  listener)

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

파라미터:

listener - PropertyChangeListener 객체

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener  listener)

PropertyChange 리스너를 삭제합니다.

파라미터:

listener - PropertyChangeListener 객체

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener)