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
- Наследование
- Производный
- Атрибуты
Требования к 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, для обеспечения совместимости.
- DragEventArgs
- ExceptionRoutedEventArgs
- SizeChangedEventArgs
- CleanUpVirtualizedItemEventArgs
- ContextMenuEventArgs
- ItemClickEventArgs
- SelectionChangedEventArgs
- TextChangedEventArgs
- DragCompletedEventArgs
- DragDeltaEventArgs
- DragStartedEventArgs
- RangeBaseValueChangedEventArgs
- ScrollEventArgs
- HyperlinkClickEventArgs
- DoubleTappedRoutedEventArgs
- HoldingRoutedEventArgs
- KeyRoutedEventArgs
- ManipulationCompletedRoutedEventArgs
- ManipulationDeltaRoutedEventArgs
- ManipulationInertiaStartingRoutedEventArgs
- ManipulationStartedRoutedEventArgs
- ManipulationStartingRoutedEventArgs
- PointerRoutedEventArgs
- RightTappedRoutedEventArgs
- TappedRoutedEventArgs
- RateChangedRoutedEventArgs
- TimelineMarkerRoutedEventArgs
Конструкторы
RoutedEventArgs() |
Инициализирует новый экземпляр класса RoutedEventArgs . |
Свойства
OriginalSource |
Возвращает ссылку на объект, вызвав которому событие. Часто это шаблонная часть элемента управления, а не элемент, объявленный в пользовательском интерфейсе приложения. |