|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
public interface EventTarget
EventTarget
인터페이스는, DOM 이벤트 모델을 지원하는 구현에서는, 모든 Node
에 의해 구현됩니다. 그 때문에,Node
인터페이스의 인스턴스로 바인딩에 특유의 캐스트 메소드를 사용해, 이 인터페이스를 취득할 수 있습니다. 이 인터페이스에서는,EventTarget
로 EventListeners
를 등록, 삭제하거나EventTarget
에 이벤트를 발송 하거나 할 수 있습니다.
「Document Object Model (DOM) Level 2 Events Specification」도 참조해 주세요.
메소드의 개요 | |
---|---|
void |
addEventListener (String type,
EventListener listener,
boolean useCapture)
이 메소드에서는, 이벤트 타겟으로 이벤트 청취자를 등록할 수 있습니다. |
boolean |
dispatchEvent (Event evt)
이 메소드에서는, 구현 이벤트 모델에 이벤트를 발송 할 수 있습니다. |
void |
removeEventListener (String type,
EventListener listener,
boolean useCapture)
이 메소드에서는, 이벤트 타겟으로부터 이벤트 청취자를 삭제할 수 있습니다. |
메소드의 상세 |
---|
void addEventListener(String type, EventListener listener, boolean useCapture)
EventTarget
에 EventListener
를 추가했을 경우, 현재의 액션에서는 트리거됩니다만, 버블 국면 등, 이벤트 플로우의 뒤의 단계에서는 트리거되는 경우가 있습니다. EventListener
가 같은 파라미터를 가져 같은 EventTarget
에 등록되어 있는 경우는, 중복 하는 인스턴스가 파기됩니다. 이것에 의해,EventListener
가 2번 불려 갈 것은 없습니다. 중복 하는 인스턴스는 파기되기 (위해)때문에,removeEventListener
메소드로 삭제할 필요는 없습니다.
type
- 사용자가 등록하고 있는 이벤트의 형태listener
- listener
파라미터는, 이벤트의 발생시에 불려 가는 메소드를 포함해,
사용자에 의해 구현되는 인터페이스를
지정하는useCapture
- true 의 경우, 사용자가 capther-를 개시하고 싶은 것을
useCapture
가 가리킨다. 지정된 형태의 모든 이벤트는,
capther-를 개시한 뒤, 트리의 하부에 있다
EventTargets
에 발송 되기 전에, 등록되었다
EventListener
에 발송 된다. 트리를 개입시켜
윗쪽으로 향해 버블 하고 있는 이벤트는,
capther-에 사용하기 위해서 지정한 EventListener
를 트리거하지 않는다void removeEventListener(String type, EventListener listener, boolean useCapture)
EventTarget
로부터 EventListener
를 삭제하는 경우, 현재의 액션에서는 트리거되지 않습니다. EventListener
는 삭제된 뒤에는 호출할 수 없습니다. EventTarget
에 등록되어 있는 EventListener
를 식별하지 않는 인수로 removeEventListener
를 호출해도, 효과는 전혀 없습니다.
type
- 삭제되는 EventListener
의 이벤트의 형태를
지정하는listener
- EventListener
파라미터는 삭제된다
EventListener
를 나타내는useCapture
- 삭제되는 EventListener
가 capther-하는 청취자로서
등록되었는지의 여부를 지정한다. 청취자가
capther-하는 경우로 하지 않는 경우의 2 회 등록되었을 경우는,
따로 따로 삭제할 필요가 있다. capther-하는 청취자를 삭제해도,
같은 청취자로 capther-하지 않는 버젼에는 전혀 영향을 주지 않는다.
역의 경우도 마찬가지boolean dispatchEvent(Event evt) throws EventException
dispatchEvent
가 불려 가는 EventTarget
입니다.
evt
- 이벤트 처리중에 사용되는 이벤트의 형태,
동작, 및 문맥 정보를 지정한다
dispatchEvent
의 반환값은,
이벤트를 처리한 청취자가 preventDefault
(을)를 호출했는지의 여부를 나타낸다. preventDefault
하지만 불려 갔을 경우의 값은 false. 그렇지 않은 경우의 값은 true
EventException
- UNSPECIFIED_EVENT_TYPE_ERR:dispatchEvent
가 불려 가기 전에
이벤트를 초기화해 Event
의 형태가
지정되지 않았던 경우. Event
의 형태를
null
또는 빈 상태(empty)의 캐릭터 라인으로 지정해도,
이 예외가 트리거된다
|
JavaTM Platform Standard Ed. 6 |
|||||||||
전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | |||||||||
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드 |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.