UIElement Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
UIElement — это базовый класс для большинства среда выполнения Windows объектов пользовательского интерфейса, которые имеют визуальный вид и могут обрабатывать базовые входные данные в пользовательском интерфейсе приложения.
public ref class UIElement : DependencyObject
public ref class UIElement : DependencyObject, IAnimationObject
public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement
/// [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 UIElement : DependencyObject
/// [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 UIElement : DependencyObject, IAnimationObject
/// [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 UIElement : DependencyObject, IAnimationObject, IVisualElement
[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 UIElement : DependencyObject
[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 UIElement : DependencyObject, IAnimationObject
[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 UIElement : DependencyObject, IAnimationObject, IVisualElement
Public Class UIElement
Inherits DependencyObject
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject
Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement
- Наследование
- Производный
- Атрибуты
- Реализации
Требования к Windows
Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Комментарии
UIElement является базовым элементом: это класс, от который наследуют многие другие классы среда выполнения Windows для поддержки модели элементов пользовательского интерфейса XAML. Свойства, методы и события, определяемые UIElement, наследуются сотнями других классов среда выполнения Windows.
Хотя UIElement определяет события для отчетов о фокусе (GotFocus, LostFocus), UIElement не определяет API для программной настройки фокуса. Эта возможность определяется классом Control .
UIElement не предоставляет открытый конструктор. Как правило, классы не являются производными от UIElement или FrameworkElement напрямую. Чаще всего используются базовые классы для производных пользовательских классов:
- Определенные элементы управления, которые не запечатаны (например, TextBox)
- Базовые классы элементов управления (Control, ContentControl, UserControl)
- Элементы навигации (Page, Frame)
- Классы панелей (базовый класс Panel или определенные непечатанные реализации, такие как Grid)
Класс UIElement используется в качестве параметра типа многих свойств и методов в API среда выполнения Windows. Например, свойство Childобъекта Border принимает один элемент UIElement, представляющий элемент, вокруг которого рисуется border . Для такого свойства можно указать любой элемент, производный от UIElement, включая определяемые вами пользовательские элементы управления.
Класс UIElementCollection предоставляет строго типизированную коллекцию элементов UIElement. UIElementCollection используется в качестве типа для свойств объектов, содержащих несколько дочерних элементов, например для свойства Children любого класса Panel .
Uielement API и функции
UIElement расширяет DependencyObject, который является еще одним базовым элементом, и добавляет поддержку различных среда выполнения Windows функциональных областей.
Входные данные и события для реагирования на взаимодействие с пользователем
Большая часть поведения ввода для видимых элементов в пользовательском интерфейсе определяется в классе UIElement. Сюда входят события для взаимодействия с клавиатурой, мышью, сенсорным вводом, перетаскиванием и фокусом. Дополнительные сведения см. в разделах Обработка ввода указателя, Взаимодействие с помощью клавиатуры и Пользовательские взаимодействия.
Известный API UIElement, поддерживающий входные данные и взаимодействие с пользователем:
- События указателя:PointerPressed, PointerReleased, PointerMoved, PointerEntered, PointerExited
- События обработки ключей:KeyDown, KeyUp
- Фокус:GotFocus, LostFocus
- Захват указателя:CapturePointer, PointerCanceled, PointerCaptureLost, ReleasePointerCapture, PointerCaptures
- Перетаскивание:DragOver, Drop, DragEnter, DragLeave, AllowDrop
- Свойства, влияющие на обработку базовых входных данных:IsHitTestVisible, AllowDrop
Жесты и манипуляции
Жесты и манипуляции также являются способом обработки ввода и взаимодействия с пользователем. API перечислены здесь отдельно, так как эти события представляют, как система взаимодействует с действиями ввода на уровне устройства и интерпретирует их как взаимодействие с пользователем. Манипуляции — это способ обработки динамических мультисенсорных взаимодействий, таких как ущемление и растяжение. Вместе жесты и манипуляции предоставляют сенсорные шаблоны для сенсорного взаимодействия с приложением UWP. Дополнительные сведения см. в разделах Пользовательские взаимодействия и Проектирование взаимодействия с сенсорным вводом.
Известный API UIElement, поддерживающий жесты и манипуляции:
- События жестов:DoubleTapped, Holding, RightTapped, Tappped
- События манипуляции:ManipulationCompleted, ManipulationDelta, ManipulationInertiaStarting, ManipulationStarted, ManipulationStarting
- Свойства, влияющие на обработку жестов и манипуляций:IsHoldingEnabled и другие is*Enabled, ManipulationMode
Базовый внешний вид
Свойства Visibility и Opacity часто используются для настройки внешнего вида элемента в пользовательском интерфейсе, особенно в стилях, шаблонах и визуальных состояниях. Свойства Clip, RenderTransform и Transitions полезны для создания взаимодействий и различных вариантов оформления элементов пользовательского интерфейса.
Базовый макет
Класс UIElement предоставляет отправную точку для характеристик макета с такими свойствами, как DesiredSize и методы Arrange и Measure . FrameworkElement добавляет дополнительные возможности макета. Дополнительные сведения см. в разделе Определение макетов с помощью XAML и FrameworkElement.
Перенаправленные события
Большинство входных событий UIElement — это перенаправленные события. Перенаправленное событие включает встроенную систему уведомлений обработки событий, чтобы родительский объект мог обрабатывать события ввода из дочерних объектов в дереве объектов, если событие остается необработанным. Это поведение события ввода полезно для группирования областей ввода и для создания элементов управления. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.
Известный API UIElement, поддерживающий перенаправленные события: AddHandler, RemoveHandler, *Свойства события .
Поддержка других платформ
- OnCreateAutomationPeer позволяет классу использовать пользовательский AutomationPeer для поддержки автоматизации пользовательского интерфейса Майкрософт.
- RenderTransform, TransformToVisual, Projection, CompositeMode, CacheMode и FindSubElementsForTouchTargeting полезны для расширенных сценариев макета пользовательского интерфейса.
Свойства зависимостей UIElement
Многие свойства чтения и записи класса базового элемента UIElement являются свойствами зависимостей. Свойства зависимостей поддерживают некоторые основные функции модели программирования для приложения UWP на C++, C# или Visual Basic, такие как стили и шаблоны, привязка данных, ссылки на ресурсы XAML и логика изменения свойств. Дополнительные сведения о свойствах зависимостей и поддерживаемых ими функциях см. в статье Общие сведения о свойствах зависимостей.
Производные классы UIElement
Единственным среда выполнения Windows классом, производным непосредственно от UIElement, является FrameworkElement. Список классов, производных от FrameworkElement, см. в разделе "Производные классы FrameworkElement " статьи справочника по FrameworkElement .
Журнал версий
Версия Windows | Версия пакета SDK | Добавленная стоимость |
---|---|---|
1607 | 14393 | AccessKey |
1607 | 14393 | AccessKeyDisplayDismissed |
1607 | 14393 | AccessKeyDisplayRequested |
1607 | 14393 | AccessKeyInvoked |
1607 | 14393 | AccessKeyScopeOwner |
1607 | 14393 | ContextCanceled |
1607 | 14393 | ContextFlyout |
1607 | 14393 | ContextRequested |
1607 | 14393 | ExitDisplayModeOnAccessKeyInvoked |
1607 | 14393 | IsAccessKeyScope |
1703 | 15063 | GettingFocus |
1703 | 15063 | GettingFocusEvent |
1703 | 15063 | HighContrastAdjustment |
1703 | 15063 | KeyTipHorizontalOffset |
1703 | 15063 | KeyTipPlacementMode |
1703 | 15063 | KeyTipVerticalOffset |
1703 | 15063 | Освещение |
1703 | 15063 | LosingFocus |
1703 | 15063 | LosingFocusEvent |
1703 | 15063 | NoFocusCandidateFound |
1703 | 15063 | NoFocusCandidateFoundEvent |
1703 | 15063 | StartBringIntoView |
1703 | 15063 | StartBringIntoView(BringIntoViewOptions) |
1703 | 15063 | TabFocusNavigation |
1703 | 15063 | XYFocusDownNavigationStrategy |
1703 | 15063 | XYFocusKeyboardNavigation |
1703 | 15063 | XYFocusLeftNavigationStrategy |
1703 | 15063 | XYFocusRightNavigationStrategy |
1703 | 15063 | XYFocusUpNavigationStrategy |
1709 | 16299 | CharacterReceived |
1709 | 16299 | CharacterReceivedEvent |
1709 | 16299 | GetChildrenInTabFocusOrder |
1709 | 16299 | KeyboardAccelerators |
1709 | 16299 | OnProcessKeyboardAccelerators |
1709 | 16299 | PreviewKeyDown |
1709 | 16299 | PreviewKeyDownEvent |
1709 | 16299 | PreviewKeyUp |
1709 | 16299 | PreviewKeyUpEvent |
1709 | 16299 | ProcessKeyboardAccelerators |
1709 | 16299 | TryInvokeKeyboardAccelerator |
1803 | 17134 | BringIntoViewRequested |
1803 | 17134 | BringIntoViewRequestedEvent |
1803 | 17134 | ContextRequestedEvent |
1803 | 17134 | KeyboardAcceleratorPlacementMode |
1803 | 17134 | KeyboardAcceleratorPlacementTarget |
1803 | 17134 | KeyTipTarget |
1803 | 17134 | OnBringIntoViewRequested |
1803 | 17134 | OnKeyboardAcceleratorInvoked |
1803 | 17134 | RegisterAsScrollPort |
1809 | 17763 | CanBeScrollAnchor |
1809 | 17763 | CenterPoint (Центральная точка) |
1809 | 17763 | OpacityTransition |
1809 | 17763 | ЗаполнениеPropertyInfo |
1809 | 17763 | ЗаполнениеPropertyInfoOverride |
1809 | 17763 | Поворот |
1809 | 17763 | RotationAxis (Ось поворота) |
1809 | 17763 | RotationTransition |
1809 | 17763 | Масштабирование |
1809 | 17763 | ScaleTransition |
1809 | 17763 | StartAnimation |
1809 | 17763 | StopAnimation |
1809 | 17763 | TransformMatrix |
1809 | 17763 | Перевод |
1809 | 17763 | TranslationTransition |
1903 | 18362 | ActualOffset |
1903 | 18362 | ActualSize |
1903 | 18362 | Shadow |
1903 | 18362 | UIContext |
1903 | 18362 | XamlRoot |
Свойства
AccessKey |
Возвращает или задает ключ доступа (мнемонический) для этого элемента. |
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 |
Возвращает или задает объект RectangleGeometry, используемый для определения контура содержимого элемента UIElement. |
ClipProperty |
Идентифицирует свойство зависимости Clip . |
CompositeMode |
Возвращает или задает свойство, объявляющее альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX. |
CompositeModeProperty |
Определяет свойство зависимости CompositeMode . |
ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. |
ContextFlyoutProperty |
Идентифицирует для свойства зависимостей ContextFlyout . |
ContextRequestedEvent |
Возвращает идентификатор перенаправленного события ContextRequested. |
DesiredSize |
Возвращает размер, вычисленный этим элементом UIElement во время прохождения меры процесса макета. |
Dispatcher |
Возвращает объект CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет собой средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject) |
DoubleTappedEvent |
Возвращает идентификатор перенаправленного события DoubleTapped . |
DragEnterEvent |
Возвращает идентификатор перенаправленного события DragEnter . |
DragLeaveEvent |
Возвращает идентификатор перенаправленного события DragLeave . |
DragOverEvent |
Возвращает идентификатор перенаправленного события DragOver . |
DropEvent |
Возвращает идентификатор перенаправленного события Drop . |
ExitDisplayModeOnAccessKeyInvoked |
Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. |
ExitDisplayModeOnAccessKeyInvokedProperty |
Определяет свойство зависимости ExitDisplayModeOnAccessKeyInvoked . |
GettingFocusEvent |
Возвращает идентификатор перенаправленного события GettingFocus . |
HighContrastAdjustment |
Возвращает или задает значение, указывающее, настраивает ли платформа автоматически визуальные свойства элемента при включении тем с высокой контрастностью. |
HighContrastAdjustmentProperty |
Определяет свойство зависимости HighContrastAdjustment . |
HoldingEvent |
Возвращает идентификатор перенаправленного события Holding . |
IsAccessKeyScope |
Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область. |
IsAccessKeyScopeProperty |
Идентифицирует для свойства зависимости IsAccessKeyScope . |
IsDoubleTapEnabled |
Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента. |
IsDoubleTapEnabledProperty |
Определяет свойство зависимости IsDoubleTapEnabled . |
IsHitTestVisible |
Возвращает или задает значение, указывающее, может ли автономная область этого элемента UIElement возвращать истинные значения для проверки попадания. |
IsHitTestVisibleProperty |
Определяет свойство зависимости IsHitTestVisible . |
IsHoldingEnabled |
Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента. |
IsHoldingEnabledProperty |
Определяет свойство зависимости IsHoldingEnabled . |
IsRightTapEnabled |
Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента. |
IsRightTapEnabledProperty |
Определяет свойство зависимости IsRightTapEnabled . |
IsTapEnabled |
Возвращает или задает значение, определяющее, может ли событие Tapped исходить из этого элемента. |
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 |
Возвращает или задает перспективную проекцию (трехмерный эффект), применяемую при отрисовке этого элемента. |
ProjectionProperty |
Идентифицирует свойство зависимостей Проекция . |
RenderSize |
Возвращает окончательный размер отрисовки элемента UIElement. Использовать не рекомендуется, см. примечания. |
RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки элемента UIElement. |
RenderTransformOrigin |
Возвращает или задает исходную точку любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ UIElement. |
RenderTransformOriginProperty |
Определяет свойство зависимости RenderTransformOrigin . |
RenderTransformProperty |
Определяет свойство зависимости RenderTransform . |
RightTappedEvent |
Возвращает идентификатор перенаправленного события RightTapped . |
Rotation |
Возвращает или задает угол поворота по часовой стрелке в градусах. Поворачивается относительно RotationAxis и CenterPoint. Влияет на позицию отрисовки элемента. |
RotationAxis |
Возвращает или задает ось для поворота элемента. |
RotationTransition |
Возвращает или задает scalarTransition, который анимирует изменения свойства Rotation. |
Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно Элемента CenterPoint. Влияет на позицию отрисовки элемента. |
ScaleTransition |
Возвращает или задает Vector3Transition, который анимирует изменения в свойстве Scale. |
Shadow |
Возвращает или задает эффект тени, приведение к элементу . |
ShadowProperty |
Идентифицирует свойство теневой зависимости. |
TabFocusNavigation |
Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления. |
TabFocusNavigationProperty |
Определяет свойство зависимости TabFocusNavigation . |
TappedEvent |
Возвращает идентификатор перенаправленного события Tapped . |
Transform3D |
Возвращает или задает эффект трехмерного преобразования, применяемый при отрисовке этого элемента. |
Transform3DProperty |
Определяет свойство зависимостей Transform3D . |
TransformMatrix |
Возвращает или задает матрицу преобразования, применяемую к элементу . |
Transitions |
Возвращает или задает коллекцию элементов стиля перехода , применяемых к UIElement. |
TransitionsProperty |
Идентифицирует свойство зависимостей Переходы . |
Translation |
Возвращает или задает положение отрисовки x, y и z элемента. |
TranslationTransition |
Возвращает или задает Vector3Transition, который анимирует изменения свойства Translation. |
UIContext |
Возвращает идентификатор контекста для элемента. |
UseLayoutRounding |
Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддеревь использовать поведение округления, которое выравнивает отрисовку по целым пикселям. |
UseLayoutRoundingProperty |
Определяет свойство зависимости UseLayoutRounding . |
Visibility |
Возвращает или задает видимость объекта UIElement. Невидимый элемент UIElement не отображается и не передает нужный размер макету. |
VisibilityProperty |
Определяет свойство зависимостей Visibility . |
XamlRoot |
Возвращает или задает объект , |
XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. |
XYFocusDownNavigationStrategyProperty |
Определяет свойство зависимости XYFocusDownNavigationStrategy . |
XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью стрелков с помощью клавиатуры. |
XYFocusKeyboardNavigationProperty |
Определяет свойство зависимости XYFocusKeyboardNavigation . |
XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента левой навигации. |
XYFocusLeftNavigationStrategyProperty |
Определяет свойство зависимости XYFocusLeftNavigationStrategy . |
XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правой навигации. |
XYFocusRightNavigationStrategyProperty |
Определяет свойство зависимости XYFocusRightNavigationStrategy . |
XYFocusUpNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх. |
XYFocusUpNavigationStrategyProperty |
Определяет свойство зависимости XYFocusUpNavigationStrategy . |
Методы
AddHandler(RoutedEvent, Object, Boolean) |
Добавляет обработчик перенаправленного события для указанного перенаправленного события, помещая этот обработчик в коллекцию обработчиков текущего элемента. Укажите handledEventsToo как true , чтобы вызвать предоставленный обработчик, даже если событие обрабатывается в другом месте. |
Arrange(Rect) |
Размещает дочерние объекты и определяет размер элемента UIElement. Родительские объекты, реализующие пользовательский макет для своих дочерних элементов, должны вызывать этот метод из реализаций переопределения макета, чтобы сформировать рекурсивное обновление макета. |
CancelDirectManipulations() |
Отменяет текущую обработку прямых манипуляций (определяемое системой сдвиг или масштабирование) в любом родительском элементе ScrollViewer , содержающем текущий элемент UIElement. |
CapturePointer(Pointer) |
Задает запись указателя на uiElement. После захвата события, связанные с указателем, будут запускаться только элемент, имеющий запись. |
ClearValue(DependencyProperty) |
Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject) |
FindSubElementsForTouchTargeting(Point, Rect) |
Позволяет подклассу UIElement предоставлять дочерние элементы, помогающие в разрешении сенсорного нацеливания. |
GetAnimationBaseValue(DependencyProperty) |
Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject) |
GetChildrenInTabFocusOrder() |
Позволяет подклассу UIElement предоставлять дочерние элементы, которые принимают участие в фокусе tab. |
GetValue(DependencyProperty) |
Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject) |
InvalidateArrange() |
Делает недействительным состояние упорядочения (макет) для UIElement. После аннулирования макет UIElement будет обновлен, что будет происходить асинхронно. |
InvalidateMeasure() |
Делает недействительным состояние измерения (макет) для элемента UIElement. |
Measure(Size) |
Обновления DesiredSizeэлемента UIElement. Как правило, объекты, реализующие пользовательский макет для своих дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride для формирования рекурсивного обновления макета. |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested . |
OnCreateAutomationPeer() |
При реализации в производном классе возвращает реализации AutomationPeer для конкретного класса для инфраструктуры автоматизации пользовательского интерфейса Майкрософт. |
OnDisconnectVisualChildren() |
Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из свойства содержимого или дочерних элементов класса. |
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Вызывается при обработке сочетания клавиш (или ускорителя) в приложении. Переопределите этот метод для обработки реакции приложения на вызов ускорителя клавиатуры. |
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Вызывается непосредственно перед обработкой сочетания клавиш (или ускорителя) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerators. Переопределите этот метод, чтобы повлиять на обработку ускорителя по умолчанию. |
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(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 |
Происходит, когда указатель инициирует действие Нажатие в этом элементе. |
PointerReleased |
Происходит при освобождении устройства указателя, которое ранее инициировало действие нажатия , в этом элементе. Обратите внимание, что окончание действия Нажатие не гарантирует срабатывание события PointerReleased. Вместо этого могут возникать другие события. Дополнительные сведения см. в разделе Примечания. |
PointerWheelChanged |
Происходит при изменении значения разностного колесика указателя. |
PreviewKeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе. |
PreviewKeyUp |
Происходит при освобождении клавиши клавиатуры, когда элемент UIElement находится в фокусе. |
ProcessKeyboardAccelerators |
Происходит при нажатии сочетания клавиш (или ускорителя ). |
RightTapped |
Возникает при возникновении стимула ввода правой кнопкой касания, когда указатель находится над элементом. |
Tapped |
Происходит, когда в противном случае происходит необработанное взаимодействие с касанием в области проверки попадания этого элемента. |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по