커스텀 이벤트를 합성하고 전송하기 전에 UI 툴킷 이벤트 시스템이 운영체제 이벤트를 할당하고 전송하는 방법을 이해해야 합니다.
UI 툴킷은 패널을 통해 이벤트를 시각적 요소에 전송합니다. 이벤트에 타겟이 없는 경우 패널의 루트 요소에 전송합니다. 전파 경로를 사용하려면 요소에 타겟이 있어야 하며, 전송자가 사전에 타겟을 설정해야 합니다. 일부 이벤트 타입에는 타겟이 필요하지 않습니다. 예를 들어 키보드 이벤트는 포커스 요소에 전송되며, 포인터 이벤트는 포인터 아래의 요소에 전송됩니다.
이벤트 시스템은 이벤트 풀을 사용하여 이벤트 오브젝트를 반복적으로 할당하지 않게 합니다.
이벤트를 합성 및 전송하려면 다음을 수행합니다.
using
블록으로 둘러싸서 이벤트 풀에 반환되도록 만듭니다.panel.visualTree.SendEvent()
로 전달합니다.키보드 및 포인터 이벤트와 같은 운영체제 이벤트를 전송할 수 있습니다. 그렇게 하려면 UnityEngine.Event
를 사용하여 UI 툴킷 이벤트를 초기화합니다.
다음 예제는 이벤트를 합성하고 전송하는 방식을 보여줍니다.
void SynthesizeAndSendKeyDownEvent(IPanel panel, KeyCode code,
char character = '\0', EventModifiers modifiers = EventModifiers.None)
{
// Create a UnityEngine.Event to hold initialization data.
var evt = new Event() {
type = EventType.KeyDownEvent,
keyCode = code,
character = character,
modifiers = modifiers
};
using (KeyDownEvent keyDownEvent = KeyDownEvent.GetPooled(evt))
{
panel.visualTree.SendEvent(keyDownEvent);
}
}
중요: 운영체제 외부에서 발생하거나 UnityEngine.Event
타입에 없는 이벤트는 전송하지 마십시오. UI 툴킷은 내부 상태 변경에 대한 반응으로 일부 이벤트를 전송합니다. 외부 프로세스는 이러한 이벤트를 전송해서는 안 됩니다. 예를 들어, PointerCaptureEvent
를 전송하면 시각적 요소는 해당 이벤트의 기본 조건이 충족된 것으로 가정하고 포인터 캡처를 설정하지 않습니다. 이로 인해 시각적 요소의 내부 설정이 손상되고 정의되지 않은 동작이 발생할 수 있습니다.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.