RoutedEventArgs 클래스

  • 참조

정의

네임스페이스:
Microsoft.UI.Xaml
편집

라우트된 이벤트와 연결된 상태 정보 및 이벤트 데이터를 포함합니다.

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RoutedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class RoutedEventArgs
Public Class RoutedEventArgs
상속
Object IInspectable RoutedEventArgs
파생
특성
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

설명

RoutedEventArgs는 C++ 또는 C#을 사용하는 Windows App SDK 앱의 기본 요소 이벤트에 사용되는 일반적인 이벤트 데이터 형식입니다. 일반적으로 RoutedEventArgs 이벤트 데이터 형식은 이 이벤트 데이터가 있는 이벤트가 라우트된 이벤트임을 나타내지만 몇 가지 예외가 있습니다. 라우트된 이벤트 및 처리 방법에 대한 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

일반화된 이벤트 데이터 집합에 추가하는 API RoutedEventArgs 는 OriginalSource입니다. OriginalSource 적중 테스트 및 이벤트 라우팅 시나리오를 위해 이벤트를 처음 발생시킨 요소를 결정하는 데 유용할 수 있지만 대리자 서명의 발신자 가 처리기에 더 유용한 원본 개체 참조인 경우도 있습니다. 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

RoutedEventArgs 및 Handled 속성

WPF(Windows Presentation Foundation)에 익숙한 경우 WPF가 클래스에 RoutedEventArgs 명명된 Handled 속성을 선언한다는 것을 알 수 있습니다. Windows 런타임 라우트된 특정 이벤트 데이터 클래스도 속성을 정의 Handled 하며 WPF에서와 동일한 방식으로 사용합니다(처리기 내에서 이벤트 경로에 영향을 줍니다.) 그러나 Windows App SDK 경우 이 동작은 모든 라우트된 이벤트가 아닌 특정 라우트된 이벤트(WPF의 경우와 같이)에만 적용됩니다. 예를 들어 포인터 이벤트를 처리하고 이벤트 데이터 클래스가 PointerRoutedEventArgs인 경우 Handled를 설정할 수 있지만 이벤트 데이터가 RoutedEventArgs instance Loaded 이벤트에 대해 설정할 Handled 수는 없습니다.

RoutedEventArgs 파생 클래스

RoutedEventArgs는 UI 요소와 관련된 Windows 런타임 이벤트에 대한 이벤트 데이터를 정의하는 몇 가지 즉시 파생된 클래스의 부모 클래스입니다. 클래스가 데이터를 제공하는 모든 이벤트가 이벤트 및 라우트된 이벤트 개요에 정의된 대로 반드시 라우 트된 이벤트는 아닙니다. 그러나 많은 사람들이 있습니다. 호환성을 위해 에서 파생된 RoutedEventArgs 이벤트 데이터가 없는 경우가 있습니다.

생성자

RoutedEventArgs()

RoutedEventArgs 클래스의 새 instance 초기화합니다.

속성

OriginalSource

이벤트를 발생시킨 개체에 대한 참조를 가져옵니다. 앱 UI에서 선언된 요소가 아닌 컨트롤의 템플릿 부분입니다.

적용 대상

추가 정보