라우트된 이벤트를 처리된 것으로 표시 및 클래스 처리

아티클
05/04/2023

라우트된 이벤트의 처리기는 이벤트 데이터 내에서 이벤트를 처리된 것으로 표시할 수 있습니다. 이벤트를 처리하면 경로가 효과적으로 단축됩니다. 클래스 처리는 라우트된 이벤트를 통해 지원되는 프로그래밍 개념입니다. 클래스 처리기는 클래스의 모든 인스턴스에서 가장 먼저 호출되는 처리기를 사용하여 라우트된 특정 이벤트를 클래스 수준에서 처리할 수 있습니다.

필수 구성 요소

이 항목에서는 라우트된 이벤트 개요에 소개된 개념에 대해 설명합니다.

이벤트를 처리된 것으로 표시하는 시점

라우트된 이벤트의 이벤트 데이터에서 Handled 속성 값을 true로 설정한 경우 이를 “이벤트를 처리된 것으로 표시한다”라고 표현합니다. 기존 라우트된 이벤트를 사용하거나 새 라우트된 이벤트를 구현하는 애플리케이션 작성자나 컨트롤 작성자가 라우트된 이벤트를 처리된 것으로 표시해야 하는 시점에 대한 절대적인 규칙은 없습니다. 대부분의 경우 라우트된 이벤트의 이벤트 데이터에 포함되어 있는 “처리됨”의 개념은 WPF API에 노출되는 다양한 라우트된 이벤트뿐만 아니라 사용자 지정된 라우트된 이벤트에 대한 고유한 애플리케이션의 응답에 제한된 프로토콜로 사용해야 합니다. “처리됨” 문제로 간주하는 또 다른 방법은 일반적으로 코드에서 의미 있고 비교적 완전한 방법으로 라우트된 이벤트에 응답한 경우 라우트된 이벤트를 처리된 것으로 표시하는 것입니다. 일반적으로 라우트된 이벤트 하나가 발생할 때마다 별도의 처리기를 구현해야 하는 의미 있는 응답은 하나만 있어야 합니다. 전달을 위해 둘 이상의 응답이 필요한 경우에는 라우트된 이벤트 시스템을 사용하는 대신 단일 처리기 내에서 연결되는 애플리케이션 논리를 통해 필요한 코드를 구현해야 합니다. “의미 있는 상태”라는 개념 역시 주관적이며 애플리케이션이나 코드에 따라 달라집니다. “의미 있는 응답” 예로는 포커스 설정, 공용 상태 수정, 시각적 표현에 영향을 미치는 속성 설정, 다른 새 이벤트 생성 등이 있습니다. 의미 없는 응답의 예로는 시각적 영향이나 프로그래밍 표현이 없는 전용 상태 수정, 이벤트 로깅, 이벤트 인수를 검사한 응답하지 않도록 선택하는 것 등이 포함됩니다.

이벤트 데이터가 이미 처리된 것으로 표시된 경우 XAML에 추가된 처리기나 AddHandler의 공용 서명이 라우트된 이벤트에 대한 응답으로 호출되지 않으므로 라우트된 이벤트 시스템 동작은 라우트된 이벤트의 처리 상태를 사용하여 이 “의미 있는 응답” 모델을 강화합니다. 이벤트 경로에서 이전 참가자에 의해 처리된 것으로 표시된 라우트된 이벤트를 처리하기 위해서는 handledEventsToo 매개 변수 버전(AddHandler(RoutedEvent, Delegate, Boolean))을 사용하여 처리기를 직접 추가해야 합니다.

경우에 따라서는 컨트롤 자체에서 특정 라우트된 이벤트를 처리된 것으로 표시합니다. 라우트된 이벤트가 처리된 것으로 표시되면 라우트된 이벤트에 응답하는 컨트롤의 작업이 컨트롤 구현에서 의미가 있거나 그 일부로 완료되었으므로 이벤트를 추가로 처리할 필요가 없다고 WPF 컨트롤 작성자가 결정했다는 것입니다. 이 경우에는 대개 이벤트에 대한 클래스 처리기를 추가하거나 기본 클래스에 존재하는 클래스 처리기 가상 메서드 중 하나를 재정의하게 됩니다. 필요한 경우 이 이벤트 처리 문제를 해결할 수 있습니다. 자세한 내용은 이 항목 뒷부분에 있는 컨트롤에서 억제하는 이벤트 문제 해결을 참조하세요.

"미리 보기"(터널링) 이벤트와 버블링 이벤트 비교 및 이벤트 처리

라우트된 미리 보기 이벤트는 요소 트리에서 터널링 경로를 따르는 이벤트입니다. 명명 규칙에서 표현된 “미리 보기”는 라우트된 미리 보기(터널링) 이벤트가 그에 해당되는 라우트된 버블링 이벤트보다 먼저 발생한다는 입력 이벤트의 일반적인 원칙을 나타냅니다. 또한 터널링 및 버블링 쌍이 있는 라우트된 입력 이벤트는 고유한 처리 논리를 가집니다. 라우트된 터널링/미리 보기 이벤트가 이벤트 수신기에 의해 처리된 것으로 표시되면 라우트된 버블링 이벤트의 수신기가 이벤트를 받기 전에 라우트된 버블링 이벤트가 처리된 것으로 표시됩니다. 라우트된 터널링 및 버블링 이벤트는 기술적으로 서로 다른 이벤트이지만 동일한 이벤트 데이터 인스턴스를 공유하여 이 동작을 활성화합니다.

라우트된 터널링 및 버블링 이벤트 간의 연결은 특정 WPF 클래스가 고유하게 선언된 라우트된 이벤트를 발생시키는 방식으로 내부적으로 구현되며 이는 쌍을 이루는 라우트된 입력 이벤트의 경우에도 해당됩니다. 하지만 이 클래스 수준 구현이 존재하지 않으면 라우트된 터널링 이벤트와 라우트된 버블링 이벤트 간에 이름 지정 체계를 공유하는 연결이 없습니다. 이와 같은 구현이 없으면 이 두 이벤트는 완전히 분리된 두 개의 라우트된 이벤트이며 차례로 발생하거나 이벤트 데이터를 공유하지 않습니다.

사용자 지정 클래스에서 라우트된 터널링/버블링 입력 이벤트를 구현하는 방법에 대한 자세한 내용은 사용자 지정 라우트된 이벤트 만들기를 참조하세요.

클래스 처리기 및 인스턴스 처리기

라우트된 이벤트에서는 클래스 수신기와 인스턴스 수신기라는 두 가지 종류의 이벤트 수신기를 사용합니다. 클래스 수신기가 존재하는 이유는 형식이 RegisterClassHandler라는 특정 EventManager API를 정적 생성자에서 호출했거나 요소 기본 클래스에서 클래스 처리기 가상 메서드를 재정의했기 때문입니다. 인스턴스 수신기는 AddHandler를 호출하여 라우트된 이벤트에 처리기가 하나 이상 연결된 특정 클래스 인스턴스/요소입니다. 기존의 WPF 라우트된 이벤트는 CLR(공통 언어 런타임) 이벤트 래퍼 add{} 및 remove{} 구현의 일부로 AddHandler를 호출합니다. 이는 특성 구문을 통해 이벤트 처리기를 연결하는 간단한 XAML 메커니즘을 사용하는 방법이기도 합니다. 따라서 결국 간단한 XAML 사용량은 AddHandler 호출과 같습니다.

시각적 트리 내에 있는 요소는 등록된 처리기 구현이 있는지 확인됩니다. 이 처리기는 해당 라우트된 이벤트의 라우팅 전략 형식에 내재된 순서에 따라 경로에서 호출될 수 있습니다. 예를 들어 라우트된 버블링 이벤트는 라우트된 이벤트를 발생시킨 동일한 요소에 연결된 처리기를 먼저 호출합니다. 그런 다음 라우트된 이벤트는 다음 부모 요소로 “버블링”되며 애플리케이션 루트 요소에 도달할 때까지 이 동작이 계속 수행됩니다.

버블링 경로의 루트 요소 관점에서 볼 때 클래스 처리 또는 라우트된 이벤트의 소스에 보다 가까운 요소가 이벤트 인수를 처리된 것으로 표시하는 처리기를 호출하면 루트 요소의 처리기가 호출되지 않으며 루트 요소에 도달할 때까지의 이벤트 경로가 효과적으로 단축됩니다. 하지만 클래스 처리기나 인스턴스 처리기가 라우트된 이벤트를 처리된 것으로 표시하는 경우에도 계속 호출되어야 함을 나타내는 특수한 조건을 사용하여 처리기를 추가할 수 있으므로 경로가 완전하게 중단되지는 않습니다. 이에 대한 자세한 내용은 이 항목 뒷부분에서 이벤트가 처리된 것으로 표시된 경우에도 발생되는 인스턴스 처리기 추가를 참조하세요.

이벤트 경로보다 더 하위 수준에서는 클래스의 지정된 인스턴스에 대해 동작하는 클래스 처리기가 여러 개 있을 수 있습니다. 이는 라우트된 이벤트의 클래스 처리 모델을 사용하면 클래스 계층 구조의 모든 가능한 클래스가 각 라우트된 이벤트에 대해 고유한 클래스 처리기를 등록할 수 있기 때문입니다. 각 클래스 처리기는 내부 저장소에 추가되고 애플리케이션에 대한 이벤트 경로가 구성될 때 모두 이벤트 경로에 추가됩니다. 클래스 처리기는 가장 많이 파생된 클래스 처리기가 먼저 호출된 다음 후속 기본 클래스의 클래스 처리기가 다음으로 호출되는 방식으로 경로에 추가됩니다. 일반적으로 클래스 처리기는 이미 처리된 것으로 표시된 라우트된 이벤트에도 응답하도록 등록되지는 않습니다. 따라서 이 클래스 처리 메커니즘을 사용할 경우 다음 두 가지 중 하나를 선택할 수 있습니다.

파생 클래스는 라우트된 이벤트를 처리된 것으로 표시하지 않는 처리기를 추가함으로써 기본 클래스에서 상속된 클래스 처리를 보완할 수 있습니다. 이는 기본 클래스 처리기가 파생 클래스 처리기보다 나중에 호출되기 때문에 가능합니다.
파생 클래스는 라우트된 이벤트를 처리된 것으로 표시하는 클래스 처리기를 추가함으로써 기본 클래스의 클래스 처리를 대체할 수 있습니다. 이 접근 방식을 사용할 경우에는 시각적 모양, 상태 논리, 입력 처리 및 명령 처리 같은 측면에서 원래 기본 컨트롤 디자인이 변경될 수 있으므로 주의해야 합니다.

컨트롤 기본 클래스를 사용한 라우트된 이벤트의 클래스 처리

이벤트 경로의 지정된 각 요소 노드에서 클래스 수신기는 요소에 있는 다른 모든 인스턴스 수신기보다 먼저 라우트된 이벤트에 응답할 수 있습니다. 따라서 특정 컨트롤 클래스 구현에서 더 이상 전파되지 않도록 라우트된 이벤트를 억제하거나 클래스의 기능인 라우트된 이벤트에 대한 특수 처리 기능을 제공하기 위해 클래스 처리기를 사용하는 경우가 있습니다. 예를 들어 특정 클래스의 컨텍스트에서 사용자 입력 조건이 의미하는 내용에 대한 보다 구체적인 사항이 들어 있는 고유한 클래스별 이벤트를 클래스에서 발생시킬 수 있습니다. 이 경우 클래스 구현에서는 보다 일반화된 라우트된 이벤트를 처리된 것으로 표시할 수 있습니다. 일반적으로 클래스 처리기는 공유된 이벤트 데이터가 이미 처리된 것으로 표시된 라우트된 이벤트에 대해서는 호출되지 않도록 추가되지만 라우트된 이벤트가 처리된 것으로 표시된 경우에도 호출될 수 있도록 클래스 처리기를 등록하는 RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean) 서명도 있습니다.

클래스 처리기 가상 메서드

특히 UIElement와 같은 일부 요소는 공용 라우트된 이벤트 목록에 해당하는 비어 있는 “On*Event” 및 “OnPreview*Event” 가상 메서드를 노출합니다. 이러한 가상 메서드를 재정의하여 해당 라우트된 이벤트에 대한 클래스 처리기를 구현할 수 있습니다. 기본 요소는 앞에서 설명한 대로 RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean)를 사용하여 이러한 가상 메서드를 각 라우트된 이벤트의 클래스 처리가로 등록합니다. On*Event 가상 메서드를 사용하면 각 형식에 대한 정적 생성자에서 특수한 초기화를 수행할 필요 없이 관련 라우트된 이벤트에 대한 클래스 처리를 훨씬 쉽게 구현할 수 있습니다. 예를 들어 OnDragEnter 가상 메서드를 재정의하여 UIElement 파생 클래스에서 DragEnter 이벤트의 클래스 처리를 추가할 수 있습니다. 재정의할 때 라우트된 이벤트를 처리하거나, 다른 이벤트를 발생시키거나, 인스턴스의 요소 속성을 변경할 수 있는 클래스별 논리를 초기화하거나, 이러한 작업을 원하는 대로 조합하여 사용할 수 있습니다. 일반적으로 이벤트를 처리된 것으로 표시한 경우에도 이와 같은 재정의에서 기본 구현을 호출해야 합니다. 가상 메서드는 기본 클래스에 있으므로 기본 구현을 호출하는 것이 좋습니다. 각 가상 메서드에서 기본 구현을 호출하는 표준적인 보호된 가상 패턴은 라우트된 이벤트 클래스 처리의 기본 메커니즘을 대체하거나 해당 메커니즘과 유사하게 실행됩니다. 라우트된 이벤트 클래스 처리의 기본 메커니즘을 사용할 경우 가장 많이 파생된 클래스의 처리기부터 시작하여 기본 클래스 처리기에 이르기까지 클래스 계층 구조의 모든 클래스에 대한 클래스 처리기가 지정된 인스턴스에서 호출됩니다. 클래스에서 기본 클래스 처리 논리를 의도적으로 변경해야 하는 경우에만 기본 구현 호출을 생략해야 합니다. 기본 구현을 재정의한 코드 이전에 호출할지 이후에 호출할지는 구현 특성에 따라 달라집니다.

입력 이벤트 클래스 처리

모든 클래스 처리기 가상 메서드는 공유된 이벤트 데이터가 이미 처리된 것으로 표시되지 않은 경우에만 호출되도록 등록됩니다. 또한 입력 이벤트의 경우에는 고유하게 터널링 버전과 버블링 버전이 대개 차례로 발생하고 이벤트 데이터를 공유합니다. 따라서 입력 이벤트의 클래스 처리기가 하나는 터널링 버전이고 다른 하나는 버블링 버전인 지정된 쌍에 대해서는 이벤트를 즉시 처리된 것으로 표시하지 않는 것이 좋습니다. 이벤트를 처리된 것으로 표시하도록 터널링 클래스 처리 가상 메서드를 구현하면 버블링 클래스 처리기가 호출되지 않을 뿐만 아니라 터널링 이벤트나 버블링 이벤트에 대해 정상적으로 등록된 인스턴스 처리기도 호출되지 않습니다.

노드에서 클래스 처리를 완료했으면 인스턴스 수신기를 처리할 차례입니다.

이벤트가 처리된 것으로 표시된 경우에도 발생되는 인스턴스 처리기 추가

AddHandler 메서드는 다른 처리기에서 이벤트 데이터를 조정하여 해당 이벤트가 처리된 것으로 표시된 경우에도 이벤트가 경로에서 처리가 필요한 요소에 도달할 때마다 이벤트 시스템에서 호출하는 처리기를 추가할 수 있는 특별한 오버로드를 제공합니다. 대개는 이 오버로드를 사용하지 않습니다. 일반적으로 여러 개의 최종 결과가 필요한 경우에도 요소 트리에서 이벤트가 처리된 위치와 관계없이 이벤트의 영향을 받을 수 있는 애플리케이션 코드의 모든 영역을 조정하도록 처리기를 작성할 수 있습니다. 또한 특정 이벤트에 응답해야 하는 요소가 실제로 하나인 경우가 많으며 적절한 애플리케이션 논리가 이미 있는 경우가 많습니다. 하지만 요소 트리의 다른 요소나 복합 컨트롤에서 이벤트를 처리된 것으로 표시했더라도 요소 트리의 경로에서 더 높은 수준이나 낮은 수준에 있는 다른 요소에서 고유한 처리기를 호출해야 하는 예외적인 경우에는 handledEventsToo 오버로드를 사용할 수 있습니다.

이벤트를 처리되지 않은 것으로 표시하는 시점

일반적으로 handledEventsToo에서 동작하는 처리기를 사용하는 경우에도 Handled를 다시 false로 설정하여 이미 처리된 것으로 표시된 라우트된 이벤트를 처리되지 않은 것으로 표시하면 안 됩니다. 하지만 일부 입력 이벤트에는 트리의 한 위치에 상위 수준의 이벤트가 나타나고 다른 위치에는 하위 수준의 이벤트가 나타나는 경우 겹칠 수 있는 상위 수준 이벤트 표현과 하위 수준 이벤트 표현이 있습니다. 예를 들어 자식 요소는 TextInput과 같은 상위 수준의 키 이벤트를 수신 대기하는 반면 부모 요소는 KeyDown과 같은 하위 수준의 이벤트를 수신 대기하는 경우를 가정해 보겠습니다. 부모 요소가 하위 수준 이벤트를 처리할 경우, 이벤트를 먼저 처리해야 하는 자식 요소에서 상위 수준의 이벤트가 억제될 수 있습니다.

이러한 경우 부모 요소와 자식 요소 모두에 하위 수준 이벤트에 대한 처리기를 추가해야 합니다. 자식 요소 처리기 구현에서는 하위 수준 이벤트를 처리된 것으로 표시하지만 부모 요소 처리기 구현에서는 트리에서 상위에 있는 이후 요소(상위 수준 이벤트 포함)가 응답할 수 있도록 해당 이벤트를 다시 처리되지 않은 것으로 설정합니다. 그러나 이와 같은 상황은 거의 발생하지 않습니다.

복합 컨트롤에 대한 입력 이벤트를 의도적으로 억제

라우트된 이벤트의 클래스 처리는 입력 이벤트 및 복합 컨트롤을 사용하는 시나리오에 주로 사용됩니다. 정의에 따라 복합 컨트롤은 여러 개의 실용적인 컨트롤이나 컨트롤 기본 클래스로 구성됩니다. 컨트롤 작성자가 전체 컨트롤을 단일 이벤트 소스로 보고하기 위해서 각 하위 구성 요소에서 발생할 수 있는 모든 가능한 입력 이벤트를 결합하려는 경우가 많습니다. 경우에 따라서는 컨트롤 작성자가 구성 요소 전체에서 이벤트를 억제하거나, 더 많은 정보를 제공하거나 더 구체적인 동작을 수행하는 구성 요소 정의 이벤트를 대체하는 경우가 있습니다. 모든 구성 요소 작성자가 쉽게 알 수 있는 정규 예는 WPF(Windows Presentation Foundation) Button에서 모든 마우스 이벤트를 처리하는 방법입니다. 이 경우 모든 마우스 이벤트는 결과적으로 모든 단추에 있는 직관적인 이벤트인 Click 이벤트로 해석됩니다.

Button 기본 클래스(ButtonBase)는 Control, FrameworkElement, UIElement에서 차례대로 파생되며, 제어 입력 처리에 필요한 대부분의 이벤트 인프라를 UIElement 수준에서 사용할 수 있습니다. 특히 UIElement는 경계 내에서 마우스 커서의 적중 테스트를 처리하는 일반적인 Mouse 이벤트를 처리하며 MouseLeftButtonDown와 같은 거의 대부분의 단추 작동의 고유 이벤트를 제공합니다. UIElement는 빈 가상 OnMouseLeftButtonDown을 MouseLeftButtonDown의 미리 등록된 클래스 처리기로 제공하고 ButtonBase는 이를 재정의합니다. 마찬가지로, ButtonBase는 MouseLeftButtonUp의 클래스 처리기를 사용합니다. 이벤트 데이터를 전달하는 재정의에서 해당 구현은 Handled를 true로 설정하여 RoutedEventArgs 인스턴스를 처리된 것으로 표시하고 동일한 이벤트 데이터가 나머지 경로를 따라 다른 클래스 처리기로 전달되며 인스턴스 처리기나 이벤트 setter로 전달됩니다. 또한 OnMouseLeftButtonUp 재정의는 다음에 Click 이벤트를 발생시킵니다. 그 결과 대부분의 수신기에서는 MouseLeftButtonDown 및 MouseLeftButtonUp 이벤트가 “사라지고” 대신 더 많은 의미를 포함하는 이벤트인 Click으로 대체됩니다. 이는 이 이벤트가 단추의 다른 부분이나 전혀 다른 요소에서 발생한 것이 아니라 실제 단추에서 발생한 것을 알 수 있기 때문입니다.

컨트롤에서 억제하는 이벤트 문제 해결

개별 컨트롤 내에서 이 이벤트 억제 동작이 애플리케이션의 보다 일반적인 이벤트 처리 논리와 충돌하는 경우가 있습니다. 예를 들어 어떤 이유로 인해 애플리케이션에 애플리케이션 루트 요소에 있는 MouseLeftButtonDown의 처리기가 있었다면 마우스로 단추를 클릭해도 루트 수준의 MouseLeftButtonDown 또는 MouseLeftButtonUp 처리기가 호출되지 않음을 알 수 있습니다. 이 경우 이벤트 자체는 실제로 버블링되었습니다. 즉, 이벤트 경로는 실제로 종료되지 않지만 라우트된 이벤트 시스템이 해당 이벤트를 처리된 것으로 표시한 후 처리기 호출 동작을 변경합니다. 라우트된 이벤트가 단추에 도달하면 ButtonBase 클래스 처리는 더 많은 의미가 있는 Click 이벤트로 대체되려고 하므로 MouseLeftButtonDown이 처리된 것으로 표시됩니다. 따라서 경로 위에 있는 표준 MouseLeftButtonDown 처리기는 호출되지 않습니다. 이런 경우 두 가지 기술을 사용하여 처리기가 호출되게 할 수 있습니다.

첫 번째 기술은 AddHandler(RoutedEvent, Delegate, Boolean)의 handledEventsToo 서명을 사용하여 처리기를 의도적으로 추가하는 기술입니다. 이 방법의 한계는 이벤트 처리기를 코드에서만 연결할 수 있고 태그에서는 연결할 수 없다는 것입니다. XAML(Extensible Application Markup Language)을 통해 이벤트 처리기 이름을 이벤트 특성 값으로 지정하는 단순한 구문으로는 이 동작을 사용할 수 없습니다.

두 번째 방법은 라우트된 이벤트의 터널링 버전과 버블링 버전의 쌍을 만드는 것으로, 입력 이벤트에 대해서만 사용할 수 있습니다. 이러한 라우트된 이벤트의 경우에는 미리 보기/터널링에 해당하는 라우트된 이벤트에 처리기를 대신 추가할 수 있습니다. 해당 라우트된 이벤트는 루트에서 시작하여 경로를 통해 터널링되므로 애플리케이션의 요소 트리에서 특정 상위 요소 수준에 미리 보기 처리기가 연결되었다고 가정할 경우, 단추 클래스 처리 코드가 이벤트를 대신 처리하지 않습니다. 이 접근 방식을 사용할 경우 미리 보기 이벤트를 처리된 것으로 표시할 때 주의해야 합니다. 다음 예제에서는 PreviewMouseLeftButtonDown이 루트 요소에서 처리되고 있으며 처리기 구현에서 이벤트가 Handled로 표시되면 실제로 Click 이벤트가 표시되지 않습니다. 일반적으로 이 동작은 사용하지 않는 것이 좋습니다.

다음을 통해 공유