UIElement Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
UIElement — это базовый класс для большинства объектов пользовательского интерфейса Windows Runtime с внешним видом и может обрабатывать базовые входные данные в пользовательском интерфейсе приложения.
public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
/// [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 UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
[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 UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement, IVisualElement2
- Наследование
- Производный
- Атрибуты
- Реализации
Комментарии
UIElement является базовым элементом: это класс, от который многие другие классы Windows Runtime наследуются для поддержки модели элементов пользовательского интерфейса XAML. Свойства, методы и события, которые UIElement определяются сотнями других классов Windows Runtime.
UIElement не предоставляет открытый конструктор. Как правило, вы не наследуете классы от UIElement платформы или FrameworkElement напрямую. Более часто используются базовые классы для производных пользовательских классов:
- Определенные элементы управления, которые не запечатаны (например, TextBox)
- Управление базовыми классами (Control, ContentControl, UserControl)
- Элементы навигации (Page, Frame)
- Классы панели (панель базового класса или определенные непечатанные реализации, такие как Grid)
Класс UIElement используется в качестве параметра типа многих свойств и методов в API Windows Runtime. Например, свойство Childborder принимает один UIElementэлемент, представляющий элемент, вокруг которого рисуется border . Для такого свойства можно указать любой UIElementпроизводный элемент, включая пользовательские элементы управления, которые вы определяете.
Класс UIElementCollection предоставляет строго типизированную коллекцию UIElement элементов.
UIElementCollection используется в качестве типа для свойств объектов, содержащих несколько дочерних элементов, например для свойства Children любого класса Panel .
Uielement API и функции
UIElement расширяет DependencyObject, который является другим базовым элементом и добавляет поддержку различных областей функций Windows Runtime.
Входные данные и события для реагирования на взаимодействие с пользователем
Большая часть поведения ввода для видимых элементов в пользовательском интерфейсе определяется в UIElement классе. Это включает в себя события для взаимодействия клавиатуры, мыши, сенсорного ввода, перетаскивания и фокуса. Дополнительные сведения см. в разделе "Обработка ввода указателя", "Взаимодействие с клавиатурой" и "Пользовательские взаимодействия пользователей".
Известный UIElement API, поддерживающий входные данные и взаимодействие с пользователем:
- События указателя:PointerPressed, PointerReleased, PointerMoved, PointerMoved, PointerEntered, PointerExited
- События обработки ключей:KeyDown, KeyUp
- Фокус:GotFocus, LostFocus
- Запись указателя:CapturePointer, PointerCanceled, PointerCaptureLost, ReleasePointerCaptures, PointerCaptures
- Перетаскивание:Перетаскивание,Падение, Перетаскивание, Перетаскивание, Перетаскивание, Перетаскивание, Перетаскивание, AllowDrop
- Свойства, влияющие на обработку базовых входных данных:IsHitTestVisible, AllowDrop
Жесты и манипуляции
Жесты и манипуляции также являются способом обработки входных данных и взаимодействия с пользователем. API перечислены отдельно здесь, так как эти события представляют, как система взаимодействует с действиями ввода на уровне устройства и интерпретирует их как взаимодействие с пользователем. Манипуляции — это способ обработки динамических много сенсорных взаимодействий, таких как сцепление и растяжение. Вместе жесты и манипуляции предоставляют шаблоны касания для взаимодействия с приложением UWP. Дополнительные сведения см. в разделе "Пользовательские взаимодействия пользователей " и конструктор взаимодействия Touch.
Известный UIElement API, поддерживающий жесты и манипуляции:
- События жестов:DoubleTapped, Удержание, RightTapped, Касание
- События манипуляции:ManipulationCompleted, ManipulationDelta, ManipulationInertiaStarting, ManipulationStarted, ManipulationStarting
- Свойства, влияющие на обработку жестов и манипуляций:IsHoldingEnabled и другие функции Is*Enabled, ManipulationMode
Базовый внешний вид
Свойства видимости и непрозрачности часто используются для настройки внешнего вида элемента в пользовательском интерфейсе, особенно в стилях, шаблонах и визуальных состояниях. Свойства Clip, RenderTransform и Transitions полезны для создания взаимодействий и различных поисков элементов пользовательского интерфейса.
Базовый макет
Класс UIElement предоставляет отправную точку для характеристик макета с такими свойствами, как DesiredSize и методы упорядочивания и измерения .
FrameworkElement добавляет дополнительные возможности макета. Дополнительные сведения см. в разделе "Определение макетов" с помощью XAML и FrameworkElement.
Перенаправленные события
Большинство входных событий UIElement являются маршрутивируемыми событиями. Перенаправленное событие позволяет встроенной системе уведомлений об обработке событий, чтобы родительский объект мог обрабатывать входные события из дочерних объектов в дереве объектов, если событие остается необработанным. Это поведение входных событий полезно для группирования входных областей и для создания элементов управления. Дополнительные сведения см. в разделе "События" и обзор перенаправленных событий.
Известный UIElement API, поддерживающий перенаправленные события: AddHandler, RemoveHandler, *Event properties.
Поддержка другой платформы
- OnCreateAutomationPeer позволяет классу использовать пользовательский AutomationPeer для поддержки Microsoft UI Automation.
- RenderTransform, TransformToVisual, Projection, CompositeMode, CacheMode и FindSubElementsForTouchTargeting полезны для расширенных сценариев макета пользовательского интерфейса.
Свойства зависимости UIElement
Многие свойства UIElement чтения и записи базового класса элементов являются свойствами зависимостей. Свойства зависимостей поддерживают некоторые основные функции модели программирования для приложения с помощью C++ или C#, таких как стили и шаблоны, привязка данных, ссылки на ресурсы XAML и логика изменения свойств. Дополнительные сведения о свойствах зависимостей и поддерживаемых функциях см. в обзоре свойств зависимостей.
Производные классы UIElement
Единственным классом Windows Runtime, производным непосредственно от UIElement, является FrameworkElement. Список классов, производных от FrameworkElement, см. в разделе "Производные классы FrameworkElement " справочной статьи FrameworkElement .
Свойства
| Имя | Описание |
|---|---|
| AccessKey |
Получает или задает ключ доступа (mnemonic) для этого элемента. |
| AccessKeyProperty |
Определяет свойство зависимости AccessKey . |
| AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий область ключа доступа для этого элемента, даже если он не находится в визуальном дереве исходного элемента. |
| AccessKeyScopeOwnerProperty |
Определяет свойство зависимостей AccessKeyScopeOwner . |
| ActualOffset |
Получает позицию этого UIElement относительно родительского элемента, вычисляемого во время прохождения процесса макета. |
| ActualSize |
Возвращает размер, вычисляемый этим UIElement во время упорядочивания процесса макета. |
| AllowDrop |
Возвращает или задает значение, определяющее, может ли этот UIElement быть целевым объектом удаления для целей операций перетаскивания. |
| AllowDropProperty |
Определяет свойство зависимостей AllowDrop . |
| BringIntoViewRequestedEvent |
Возвращает идентификатор для перенаправленного события BringIntoViewRequested. |
| CacheMode |
Возвращает или задает значение, указывающее, что отображаемое содержимое должно кэшироваться как составное растровое изображение, когда это возможно. |
| CacheModeProperty |
Определяет свойство зависимостей CacheMode . |
| CanBeScrollAnchor |
Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом на привязку прокрутки. |
| CanBeScrollAnchorProperty |
Определяет свойство зависимостей CanBeScrollAnchor . |
| CanDrag |
Возвращает или задает значение, указывающее, можно ли перетаскивать элемент в виде данных в операции перетаскивания. |
| CanDragProperty |
Определяет свойство зависимости CanDrag . |
| CenterPoint |
Возвращает или задает центральную точку элемента, которая является точкой, в которой происходит поворот или масштабирование. Влияет на положение отрисовки элемента. |
| CharacterReceivedEvent |
Возвращает идентификатор для перенаправленного события CharacterReceived . |
| Clip |
Возвращает или задает прямоугольникGeometry , используемый для определения структуры содержимого UIElement. |
| ClipProperty |
Идентифицирует свойство зависимости клипа . |
| CompositeMode |
Возвращает или задает свойство, которое объявляет альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML или Microsoft DirectX. |
| CompositeModeProperty |
Определяет свойство зависимостей CompositeMode . |
| ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. |
| ContextFlyoutProperty |
Определяет свойство зависимостей ContextFlyout . |
| ContextRequestedEvent |
Возвращает идентификатор для перенаправленного события ContextRequested. |
| DesiredSize |
Возвращает размер, вычисляемый этим UIElement во время прохождения меры процесса макета. |
| Dispatcher |
Всегда возвращается |
| DispatcherQueue |
Возвращает, |
| DoubleTappedEvent |
Возвращает идентификатор для перенаправленного события DoubleTapped . |
| DragEnterEvent |
Возвращает идентификатор для перенаправленного события DragEnter . |
| DragLeaveEvent |
Возвращает идентификатор для перенаправленного события DragLeave . |
| DragOverEvent |
Возвращает идентификатор для перенаправленного события DragOver . |
| DropEvent |
Возвращает идентификатор для перенаправленного события Drop . |
| ExitDisplayModeOnAccessKeyInvoked |
Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. |
| ExitDisplayModeOnAccessKeyInvokedProperty |
Определяет свойство зависимостей ExitDisplayModeOnAccessKeyInvoked . |
| FocusState |
Возвращает значение, указывающее, имеет ли этот элемент управления фокус и режим получения фокуса. |
| FocusStateProperty |
Определяет свойство зависимостей FocusState . |
| GettingFocusEvent |
Возвращает идентификатор для перенаправленного события GettingFocus . |
| HighContrastAdjustment |
Возвращает или задает значение, указывающее, настраивает ли платформа визуальные свойства элемента автоматически при включении тем высокой контрастности. |
| HighContrastAdjustmentProperty |
Определяет свойство зависимостей HighContrastAdjustment . |
| HoldingEvent |
Возвращает идентификатор для перенаправленного события Холдинга . |
| IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственную область ключа доступа. |
| IsAccessKeyScopeProperty |
Определяет свойство зависимостей IsAccessKeyScope . |
| IsDoubleTapEnabled |
Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента. |
| IsDoubleTapEnabledProperty |
Определяет свойство зависимостей IsDoubleTapEnabled . |
| IsHitTestVisible |
Возвращает или задает, может ли содержащаяся область этого UIElement возвращать истинные значения для тестирования попаданий. |
| IsHitTestVisibleProperty |
Определяет свойство зависимостей IsHitTestVisible . |
| IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. |
| IsHoldingEnabledProperty |
Определяет свойство зависимостей IsHoldingEnabled . |
| IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. |
| IsRightTapEnabledProperty |
Определяет свойство зависимостей IsRightTapEnabled . |
| IsTabStop |
Возвращает или задает значение, указывающее, включен ли элемент управления в навигацию по вкладкам. |
| IsTabStopProperty |
Определяет свойство зависимостей UIElement.IsTabStop . |
| IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие "Касаться" из этого элемента. |
| IsTapEnabledProperty |
Определяет свойство зависимостей IsTapEnabled . |
| KeyboardAcceleratorPlacementMode |
Возвращает или задает значение, указывающее, отображается ли подсказка элемента управления сочетание клавиш для связанного акселератора клавиатуры. |
| KeyboardAcceleratorPlacementModeProperty |
Определяет свойство зависимостей KeyboardAcceleratorPlacementMode . |
| KeyboardAcceleratorPlacementTarget |
Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш акселератора. |
| KeyboardAcceleratorPlacementTargetProperty |
Определяет свойство зависимостей KeyboardAcceleratorPlacementTarget . |
| KeyboardAccelerators |
Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или элементам меню.
|
| KeyDownEvent |
Возвращает идентификатор перенаправленного события KeyDown . |
| KeyTipHorizontalOffset |
Возвращает или задает значение, указывающее, насколько слева или справа подсказка ключа помещается в отношение uiElement. |
| KeyTipHorizontalOffsetProperty |
Определяет свойство зависимостей KeyTipHorizontalOffset . |
| KeyTipPlacementMode |
Возвращает или задает значение, указывающее, где находится подсказка ключа доступа относительно границы UIElement. |
| KeyTipPlacementModeProperty |
Определяет свойство зависимостей KeyTipPlacementMode . |
| KeyTipTarget |
Возвращает или задает значение, указывающее элемент, предназначенный для подсказки ключа доступа. |
| KeyTipTargetProperty |
Определяет свойство зависимостей KeyTipTarget . |
| KeyTipVerticalOffset |
Возвращает или задает значение, указывающее, насколько далеко вверх или вниз подсказка помещается в отношение к элементу пользовательского интерфейса. |
| KeyTipVerticalOffsetProperty |
Определяет свойство зависимостей KeyTipVerticalOffset . |
| KeyUpEvent |
Возвращает идентификатор для перенаправленного события KeyUp . |
| Lights |
Возвращает коллекцию объектов XamlLight , присоединенных к этому элементу. |
| LightsProperty |
Определяет свойство зависимости Lights . |
| LosingFocusEvent |
Возвращает идентификатор перенаправленного события LosingFocus . |
| ManipulationCompletedEvent |
Возвращает идентификатор для перенаправленного события ManipulationCompleted . |
| ManipulationDeltaEvent |
Возвращает идентификатор для перенаправленного события ManipulationDelta . |
| ManipulationInertiaStartingEvent |
Возвращает идентификатор перенаправленного события ManipulationInertiaStarting . |
| ManipulationMode |
Возвращает или задает значение ManipulationModes , используемое для поведения uiElement и взаимодействия с жестами. Задание этого значения позволяет обрабатывать события манипуляции из этого элемента в коде приложения. |
| ManipulationModeProperty |
Определяет свойство зависимостей ManipulationMode . |
| ManipulationStartedEvent |
Возвращает идентификатор для перенаправленного события ManipulationStarted . |
| ManipulationStartingEvent |
Возвращает идентификатор перенаправленного события ManipulationStarting . |
| NoFocusCandidateFoundEvent |
Возвращает идентификатор для перенаправленного события NoFocusCandidateFound . |
| Opacity |
Возвращает или задает степень непрозрачности объекта. |
| OpacityProperty |
Определяет свойство зависимостей IsHitTestVisible . |
| OpacityTransition |
Возвращает или задает ScalarTransition, который анимирует изменения свойства Opacity. |
| PointerCanceledEvent |
Возвращает идентификатор для перенаправленного события PointerCanceled . |
| PointerCaptureLostEvent |
Возвращает идентификатор для перенаправленного события PointerCaptureLost . |
| PointerCaptures |
Возвращает набор всех захваченных указателей, представленных как значения указателя . |
| PointerCapturesProperty |
Определяет свойство зависимостей PointerCaptures . |
| PointerEnteredEvent |
Возвращает идентификатор для перенаправленного события PointerEntered . |
| PointerExitedEvent |
Возвращает идентификатор для перенаправленного события PointerExited . |
| PointerMovedEvent |
Возвращает идентификатор для перенаправленного события PointerMoved . |
| PointerPressedEvent |
Возвращает идентификатор для перенаправленного события PointerPressed . |
| PointerReleasedEvent |
Возвращает идентификатор для перенаправленного события PointerReleased . |
| PointerWheelChangedEvent |
Возвращает идентификатор для перенаправленного события PointerWheelChanged . |
| PreviewKeyDownEvent |
Возвращает идентификатор для перенаправленного события PreviewKeyDown. |
| PreviewKeyUpEvent |
Возвращает идентификатор перенаправленного события PreviewKeyUp. |
| Projection |
Получает или задает проекцию перспективы (эффект 3-D), применяемую при отрисовке этого элемента. |
| ProjectionProperty |
Определяет свойство зависимостей проекции . |
| ProtectedCursor |
Возвращает или задает курсор, отображающийся, когда указатель находится над этим элементом. По умолчанию имеет значение NULL, указывающее, что курсор не изменяется. |
| RasterizationScale |
Возвращает значение, представляющее дополнительный коэффициент масштабирования, используемый при отрисовке фигур, изображений, текста или мультимедиа, как правило, для отрисовки в более высоком разрешении, чем обычно. |
| RenderSize |
Возвращает окончательный размер отрисовки пользовательского элемента UIElement. Использование не рекомендуется, см. примечания. |
| RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки пользовательского элемента UIElement. |
| RenderTransformOrigin |
Возвращает или задает точку источника любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ uiElement. |
| RenderTransformOriginProperty |
Определяет свойство зависимостей RenderTransformOrigin . |
| RenderTransformProperty |
Определяет свойство зависимостей RenderTransform . |
| RightTappedEvent |
Возвращает идентификатор для перенаправленного события RightTapped . |
| Rotation |
Получает или задает угол поворота по часовой стрелке в градусах. Поворот по отношению к RotationAxis и CenterPoint. Влияет на положение отрисовки элемента. |
| RotationAxis |
Возвращает или задает ось для поворота элемента вокруг. |
| RotationTransition |
Возвращает или задает ScalarTransition, который анимирует изменения свойства "Поворот". |
| Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно ЦентраPoint элемента. Влияет на положение отрисовки элемента. |
| ScaleTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Scale. |
| Shadow |
Возвращает или задает эффект тени, приведение к элементу. |
| ShadowProperty |
Определяет свойство теневой зависимости. |
| TabFocusNavigation |
Возвращает или задает значение, которое изменяет работу табуляции и tabIndex для этого элемента управления. |
| TabFocusNavigationProperty |
Определяет свойство зависимостей TabFocusNavigation . |
| TabIndex |
Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя через элементы управления с помощью клавиши TAB . |
| TabIndexProperty |
Определяет свойство зависимостей TabIndex . |
| TappedEvent |
Возвращает идентификатор для перенаправленного события Tapped . |
| Transform3D |
Возвращает или задает эффект преобразования 3-D, применяемый при отрисовке этого элемента. |
| Transform3DProperty |
Определяет свойство зависимостей Transform3D . |
| TransformMatrix |
Возвращает или задает матрицу преобразования, применяемую к элементу. |
| Transitions |
Возвращает или задает коллекцию элементов стиля перехода , которые применяются к UIElement. |
| TransitionsProperty |
Определяет свойство зависимостей "Переходы ". |
| Translation |
Возвращает или задает положение отрисовки элемента x, y и z. |
| TranslationTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Translation. |
| UseLayoutRounding |
Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддерева использовать циклический режим, который выравнивает отрисовку по всему пикселям. |
| UseLayoutRoundingProperty |
Определяет свойство зависимостей UseLayoutRounding . |
| UseSystemFocusVisuals |
Возвращает или задает значение, указывающее, используется ли элемент управления визуальные элементы фокуса, рисуемые системой или визуальными элементами фокуса, определенными в шаблоне элемента управления. |
| UseSystemFocusVisualsProperty |
Определяет свойство зависимостей UseSystemFocusVisuals . |
| Visibility |
Возвращает или задает видимость uiElement. Объект |
| VisibilityProperty |
Определяет свойство зависимостей Видимости . |
| XamlRoot |
Возвращает или задает объект |
| XYFocusDown |
Получает или задает объект, который получает фокус, когда пользователь нажимает вниз на панели направления (D-pad) игрового контроллера. |
| XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. |
| XYFocusDownNavigationStrategyProperty |
Определяет свойство зависимостей XYFocusDownNavigationStrategy . |
| XYFocusDownProperty |
Определяет свойство зависимостей XYFocusDown . |
| XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью клавишных стрелков. |
| XYFocusKeyboardNavigationProperty |
Определяет свойство зависимости XYFocusKeyboardNavigation . |
| XYFocusLeft |
Получает или задает объект, который получает фокус, когда пользователь нажимает слева на панели направления (D-pad) игрового контроллера. |
| XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации слева. |
| XYFocusLeftNavigationStrategyProperty |
Определяет свойство зависимостей XYFocusLeftNavigationStrategy . |
| XYFocusLeftProperty |
Определяет свойство зависимостей XYFocusLeft . |
| XYFocusRight |
Получает или задает объект, который получает фокус, когда пользователь нажимает прямо на панели направления (D-pad) игрового контроллера. |
| XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правой навигации. |
| XYFocusRightNavigationStrategyProperty |
Определяет свойство зависимостей XYFocusRightNavigationStrategy . |
| XYFocusRightProperty |
Определяет свойство зависимостей XYFocusRight . |
| XYFocusUp |
Возвращает или задает объект, который получает фокус, когда пользователь нажимает клавишу Directional Pad (D-pad) игрового контроллера. |
| XYFocusUpNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх. |
| XYFocusUpNavigationStrategyProperty |
Определяет свойство зависимостей XYFocusUpNavigationStrategy . |
| XYFocusUpProperty |
Определяет свойство зависимостей XYFocusUp . |
Методы
| Имя | Описание |
|---|---|
| AddHandler(RoutedEvent, Object, Boolean) |
Добавляет перенаправленный обработчик событий для указанного перенаправленного события, добавив обработчик в коллекцию обработчика текущего элемента. Укажите |
| Arrange(Rect) |
Позиционирует дочерние объекты и определяет размер пользовательского элемента UIElement. Родительские объекты, реализующие пользовательский макет для дочерних элементов, должны вызывать этот метод из реализации переопределения макета, чтобы сформировать рекурсивное обновление макета. |
| CancelDirectManipulations() |
Отменяет текущую прямую обработку манипуляций (системное сдвига или масштабирование) на любом родительском элементе ScrollViewer , содержающем текущий UIElement. |
| CapturePointer(Pointer) |
Задает запись указателя в UIElement. После захвата только элемент, имеющий запись, будет запускать события, связанные с указателем. |
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
| FindSubElementsForTouchTargeting(Point, Rect) |
Позволяет подклассу UIElement предоставлять дочерние элементы, которые помогают разрешать целевые объекты касания. |
| Focus(FocusState) |
Пытается задать фокус для этого элемента. |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое будет применяться в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
| GetChildrenInTabFocusOrder() |
Позволяет подклассу UIElement предоставлять дочерние элементы, участвующие в фокусе TAB. |
| GetValue(DependencyProperty) |
Возвращает текущее эффективное значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
| GetVisualInternal() |
Извлекает разрешение |
| InvalidateArrange() |
Отменяет состояние упорядочивания (макет) для UIElement. После недопустимости uiElement будет обновлен его макет, который будет выполняться асинхронно. |
| InvalidateMeasure() |
Отменяет состояние измерения (макет) для UIElement. |
| Measure(Size) |
Обновляет элемент DesiredSizeпользовательского интерфейса. Как правило, объекты, реализующие настраиваемый макет для дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride для формирования рекурсивного обновления макета. |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested . |
| OnCreateAutomationPeer() |
При реализации в производном классе возвращает AutomationPeer реализации для инфраструктуры Microsoft UI Automation. |
| OnDisconnectVisualChildren() |
Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого определенного класса или дочернего свойства. |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Вызывается при обработке сочетания клавиш (или акселератора) в приложении. Переопределите этот метод для обработки реагирования приложения при вызове акселератора клавиатуры. |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Вызывается непосредственно перед обработкой сочетания клавиш (или акселератора) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerator. Переопределите этот метод, чтобы повлиять на обработку акселератора по умолчанию. |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Определяет свойство, которое может быть анимировано. |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
При переопределении в производном классе определяет свойство, которое может быть анимировано. |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject) |
| RegisterAsScrollPort(UIElement) |
Регистрирует элемент в виде прокручиваемого окна просмотра. |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Регистрирует функцию уведомлений для прослушивания изменений в определенном экземпляре DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject) |
| ReleasePointerCapture(Pointer) |
Освобождает записи указателя для записи одного конкретного указателя с помощью этого UIElement. |
| ReleasePointerCaptures() |
Освобождает все записи указателя, удерживаемые этим элементом. |
| RemoveHandler(RoutedEvent, Object) |
Удаляет указанный обработчик перенаправленных событий из этого UIElement. Как правило, обработчик в вопросе был добавлен AddHandler. |
| SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей в DependencyObject. (Унаследовано от DependencyObject) |
| StartAnimation(ICompositionAnimationBase) |
Начинает указанную анимацию элемента. |
| StartBringIntoView() |
Инициирует запрос к платформе XAML для представления элемента в любом прокручиваемом регионе, в котором он содержится. |
| StartBringIntoView(BringIntoViewOptions) |
Инициирует запрос к платформе XAML для представления элемента с помощью указанных параметров. |
| StartDragAsync(ExpPointerPoint) |
|
| StartDragAsync(PointerPoint) |
Инициирует операцию перетаскивания. Важный Не поддерживается, если пользователь запускает приложение в режиме с повышенными привилегиями, как администратор. |
| StopAnimation(ICompositionAnimationBase) |
Останавливает указанную анимацию элемента. |
| TransformToVisual(UIElement) |
Возвращает объект преобразования, который можно использовать для преобразования координат из UIElement в указанный объект. |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Пытается вызвать сочетание клавиш (или акселератор), выполнив поиск всего визуального дерева uiElement для сочетания клавиш. |
| TryStartDirectManipulation(Pointer) |
Возобновляет прямую обработку манипуляций (системное сдвига и масштабирование) на любом родительском элементе ScrollViewer , содержающем текущий UIElement. |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Отменяет уведомление об изменении, которое ранее было зарегистрировано путем вызова RegisterPropertyChangedCallback. (Унаследовано от DependencyObject) |
| UpdateLayout() |
Гарантирует правильность обновления всех позиций дочерних объектов uiElement для макета. |
События
| Имя | Описание |
|---|---|
| AccessKeyDisplayDismissed |
Происходит, когда ключи доступа больше не должны отображаться. |
| AccessKeyDisplayRequested |
Происходит, когда пользователь запрашивает отображение ключей доступа. |
| AccessKeyInvoked |
Происходит, когда пользователь завершает последовательность ключей доступа. |
| BringIntoViewRequested |
Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков. |
| CharacterReceived |
Возникает, когда один состоящий символ получается входной очередью. |
| ContextCanceled |
Происходит, когда жест ввода контекста продолжается в жесте манипуляции, чтобы уведомить элемент о том, что всплывающий элемент контекста не должен быть открыт. |
| ContextRequested |
Происходит, когда пользователь завершил жест ввода контекста, например правой кнопкой мыши. |
| DoubleTapped |
Возникает, когда в противном случае необработанное взаимодействие DoubleTap происходит через область теста попадания этого элемента. |
| DragEnter |
Происходит, когда входная система сообщает базовое событие перетаскивания с этим элементом в качестве целевого объекта. |
| DragLeave |
Происходит, когда входная система сообщает базовое событие перетаскивания с этим элементом в качестве источника. |
| DragOver |
Происходит, когда входная система сообщает базовое событие перетаскивания с этим элементом в качестве потенциального целевого объекта удаления. |
| DragStarting |
Происходит при инициировании операции перетаскивания. |
| Drop |
Происходит, когда входная система сообщает базовое событие удаления с этим элементом в качестве целевого объекта удаления. |
| DropCompleted |
Происходит при завершении операции перетаскивания с этим элементом. |
| GettingFocus |
Происходит перед получением фокуса UIElement . Это событие вызывается синхронно, чтобы убедиться, что фокус не перемещается, пока событие бурно. |
| GotFocus |
Возникает, когда UIElement получает фокус. Это событие возникает асинхронно, поэтому фокус может снова перемещаться до завершения пузырьков. |
| Holding |
Возникает, когда в противном случае необработанное взаимодействие удержания происходит через область теста попадания этого элемента. |
| KeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement имеет фокус. |
| KeyUp |
Происходит при выпуске клавиши клавиатуры, когда элемент UIElement имеет фокус. |
| LosingFocus |
Происходит до того, как UIElement теряет фокус. Это событие вызывается синхронно, чтобы убедиться, что фокус не перемещается, пока событие бурно. |
| LostFocus |
Происходит, когда UIElement теряет фокус. Это событие возникает асинхронно, поэтому фокус может снова перемещаться до завершения пузырьков. |
| ManipulationCompleted |
Происходит при завершении манипуляции в UIElement . |
| ManipulationDelta |
Происходит при изменении положения входного устройства во время манипуляции. |
| ManipulationInertiaStarting |
Происходит, когда входное устройство теряет контакт с объектом UIElement во время манипуляции и инерции начинается. |
| ManipulationStarted |
Происходит, когда устройство ввода начинает манипуляцию с UIElement. |
| ManipulationStarting |
Возникает при первом создании обработчика манипуляций. |
| NoFocusCandidateFound |
Происходит, когда пользователь пытается переместить фокус (с помощью табуляции или стрелки направления), но фокус не перемещается, так как в направлении перемещения не найден кандидат фокуса. |
| PointerCanceled |
Происходит, когда указатель, который сделал контакт ненормально теряет контакт. |
| PointerCaptureLost |
Происходит, когда запись указателя, ранее удерживаемая этим элементом, перемещается в другой элемент или в другом месте. |
| PointerEntered |
Происходит, когда указатель входит в область теста попадания этого элемента. |
| PointerExited |
Происходит, когда указатель покидает область теста попадания этого элемента. |
| PointerMoved |
Происходит при перемещении указателя, пока указатель остается в области теста попадания этого элемента. |
| PointerPressed |
Происходит, когда устройство указателя инициирует действие Press в этом элементе. |
| PointerReleased |
Происходит при выпуске указателя устройства, инициированного ранее действием Press , в то время как в этом элементе. Обратите внимание, что конец действия прессы не гарантируется для запуска |
| PointerWheelChanged |
Происходит при изменении разностного значения колесика указателя. |
| PreviewKeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement имеет фокус. |
| PreviewKeyUp |
Происходит при выпуске клавиши клавиатуры, когда элемент UIElement имеет фокус. |
| ProcessKeyboardAccelerators |
Происходит при нажатии сочетания клавиш (или акселератора ). |
| RightTapped |
Происходит, когда стимул ввода правого касания происходит, пока указатель находится над элементом. |
| Tapped |
Возникает, когда в противном случае необработанное взаимодействие касания происходит через область теста попадания этого элемента. |