Поделиться через


RoutedEventArgs Класс

Определение

Содержит информацию о состоянии и данные события, связанные с перенаправленным событием.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 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
Производный
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

RoutedEventArgs — это распространенный тип данных события, используемый для событий базового элемента в приложении UWP на C++, C# или Visual Basic. Как правило, RoutedEventArgs в качестве типа данных события указывает, что событие с данными этого события является перенаправленным событием, хотя существуют некоторые исключения. Дополнительные сведения о перенаправленных событиях и их обработке см. в статье Общие сведения о событиях и перенаправленных событиях.

Api, добавляемый RoutedEventArgs в обобщенный набор данных событий, — OriginalSource. OriginalSource может быть полезен для определения элемента, который впервые вызвал событие для сценариев проверки попадания и маршрутизации событий, но иногда отправитель из сигнатуры делегата является более полезной ссылкой на исходный объект для обработчика. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.

RoutedEventArgs и свойство Handled

Если вы знакомы с Windows Presentation Foundation (WPF), вы можете знать, что Windows Presentation Foundation (WPF) объявляет свойство Handled в классе RoutedEventArgs. Некоторые классы данных перенаправленных событий в среда выполнения Windows также определяют свойство Handled, и вы используете его так же, как в Windows Presentation Foundation (WPF) (это влияет на маршрут событий из обработчика). Однако для среда выполнения Windows, а также для Microsoft Silverlight это поведение характерно только для определенных перенаправленных событий, а не для всех перенаправленных событий (как в Windows Presentation Foundation (WPF)). Например, можно задать значение Handled , если вы обрабатываете событие указателя, а класс данных события — PointerRoutedEventArgs, но нельзя задать Handled для события Loaded , где данные события являются экземпляром RoutedEventArgs.

Производные классы RoutedEventArgs

RoutedEventArgs — это родительский класс для нескольких сразу производных классов, которые определяют данные событий для среда выполнения Windows событий, включающих элементы пользовательского интерфейса. Не все события, в которых классы предоставляют данные, — это обязательно перенаправленные события, как определено в разделе Обзор событий и перенаправленных событий. Но многие из них. Для тех, которые иногда не имеют данных о событиях, производных от RoutedEventArgs, для обеспечения совместимости.

Конструкторы

RoutedEventArgs()

Инициализирует новый экземпляр класса RoutedEventArgs .

Свойства

OriginalSource

Возвращает ссылку на объект, вызвав которому событие. Часто это шаблонная часть элемента управления, а не элемент, объявленный в пользовательском интерфейсе приложения.

Применяется к

См. также раздел