이벤트 디스패치
이벤트 시스템은 운영체제 또는 스크립트에서 발생하는 이벤트를 수신한 다음 EventDispatcher를 사용하여 해당 이벤트를 시각적 요소로 디스패치합니다. 이벤트 디스패처는 전송하는 각 이벤트에 대한 적절한 디스패치 전략을 결정합니다. 결정되면 디스패처가 전략을 실행합니다.
시각적 요소는 여러 이벤트에 대한 기본 동작을 구현합니다. 여기에는 추가 이벤트 생성 및 실행이 포함됩니다. 예를 들어, PointerMoveEvent는 PointerEnterEvent와 PointerLeaveEvent를 추가로 생성할 수 있습니다. 이러한 이벤트는 대기열에 들어가고 현재 이벤트 이후에 처리됩니다. 예를 들어, PointerMoveEvent는 PointerEnterEvent와 PointerLeaveEvent 이벤트 전에 처리 작업을 완료합니다.
이벤트 유형의 디스패치 동작
각 이벤트 유형에는 고유한 디스패치 동작이 있습니다. 각 이벤트 유형의 동작은 다음 두 단계로 구성됩니다.
- 트리클다운: 트리클다운 단계 중에 요소로 전송된 이벤트입니다.
- 버블업: 버블업 단계 중에 요소로 전송된 이벤트입니다.
각 이벤트 유형의 디스패치 동작 목록은 이벤트 레퍼런스 페이지를 참조하십시오.
이벤트 전파
이벤트 디스패처가 이벤트 타겟을 선택하면 이벤트의 전파 경로를 계산합니다. 전파 경로는 이벤트를 수신하는 시각적 요소의 순서대로 나열된 목록입니다. 전파 경로는 다음 순서로 발생합니다.
- 경로는 시각적 요소 트리의 루트에서 시작하여 타겟을 향해 내려갑니다. 이를 트리클다운 단계라고 합니다.
- 이벤트 타겟이 이벤트를 수신합니다.
- 그런 다음 이벤트가 루트를 향해 트리를 올라갑니다. 이를 버블업 단계라고 합니다.
대부분의 이벤트 유형은 전파 경로를 따라 모든 요소로 전송됩니다. 일부 이벤트 유형은 버블업 단계를 건너뛰고 일부 이벤트 유형은 이벤트 타겟으로만 전송됩니다.
요소를 숨기거나 비활성화하면 이벤트를 수신하지 않습니다. 이벤트는 여전히 숨겨지거나 비활성화된 요소의 조상과 자손으로 전파됩니다.
이벤트 타겟
이벤트가 전파 경로를 따라 이동하면 Event.currentTarget이 이벤트를 처리하는 요소에 업데이트됩니다. 이벤트 콜백 함수 내에는 디스패치 동작을 기록하는 두 가지 프로퍼티가 있습니다.
-
EventBase.currentTarget은 콜백이 등록된 시각적 요소입니다. -
EventBase.target은 이벤트가 발생한 요소(예: 포인터 바로 아래의 요소)입니다.
이벤트의 타겟은 이벤트 유형에 따라 다릅니다. 포인터 이벤트의 경우 타겟은 일반적으로 포인터 바로 아래에 있는 선택 가능한 최상위 요소입니다. 키보드 이벤트의 경우 타겟은 포커스가 있는 요소입니다.
UI 툴킷 이벤트에는 이벤트가 발생한 요소에 대한 레퍼런스가 포함된 target 프로퍼티가 있습니다. 운영체제에서 발생하는 대부분의 이벤트의 경우 디스패치 프로세스는 이벤트 타겟을 자동으로 찾습니다.
타겟 요소는 EventBase.target에 저장되며 디스패치 프로세스 중에 변경되지 않습니다. Event.currentTarget 프로퍼티가 현재 이벤트를 처리하는 시각적 요소에 업데이트됩니다.
선택 모드 및 커스텀 모양
대부분의 포인터 이벤트는 선택 모드를 사용하여 타겟을 결정합니다. VisualElement 클래스에는 다음 값을 지원하는 pickingMode 프로퍼티가 있습니다.
-
PickingMode.Position(기본값): 위치 직사각형에 따라 선택을 수행합니다. -
PickingMode.Ignore: 포인터 이벤트의 결과로 선택을 방지합니다.
VisualElement.ContainsPoint() 메서드를 오버라이드하여 커스텀 교차 로직을 수행할 수 있습니다.