RoutedEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Содержит информацию о состоянии и данные события, связанные с перенаправленным событием.
/// [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
- Наследование
- Производный
- Атрибуты
Комментарии
RoutedEventArgs
— это распространенный тип данных события, используемый для событий базового элемента в Windows App SDK приложениях на C++ или C#. Как правило, RoutedEventArgs
как тип данных события указывает, что событие с данными события является перенаправленным событием, хотя существуют некоторые исключения. Дополнительные сведения о перенаправленных событиях и их обработке см. в статье Общие сведения о событиях и перенаправленных событиях.
API, который RoutedEventArgs
добавляет в обобщенный набор данных событий, — OriginalSource.
OriginalSource
может быть полезно для определения элемента, который впервые вызвал событие для сценариев проверки попадания и маршрутизации событий, но иногда отправитель из сигнатуры делегата является более полезной ссылкой на исходный объект для обработчика. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
RoutedEventArgs и свойство Handled
Если вы знакомы с Windows Presentation Foundation (WPF), вы можете знать, что WPF объявляет свойство с именем Handled
в RoutedEventArgs
классе . Некоторые классы данных перенаправленных событий в среда выполнения Windows также определяют Handled
свойство, и вы используете его так же, как и в WPF (это влияет на маршрут событий из обработчика). Однако для Windows App SDK это поведение относится только к определенным перенаправленным событиям, а не ко всем перенаправленным событиям (как в 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
Конструкторы
RoutedEventArgs() |
Инициализирует новый экземпляр класса RoutedEventArgs . |
Свойства
OriginalSource |
Возвращает ссылку на объект, вызвав которому событие. Часто это шаблонная часть элемента управления, а не элемент, объявленный в пользовательском интерфейсе приложения. |