FrameworkElement Класс

Определение

Предоставляет класс базовых элементов для объектов пользовательского интерфейса среда выполнения Windows. FrameworkElement определяет общий API, поддерживающий взаимодействие с пользовательским интерфейсом и систему автоматического макета. FrameworkElement также определяет API, связанные с привязкой данных, определением и изучением дерева объектов и отслеживанием времени существования объекта.

public ref class FrameworkElement : UIElement
/// [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 FrameworkElement : UIElement
[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 FrameworkElement : UIElement
Public Class FrameworkElement
Inherits UIElement
Наследование
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement
Производный
Атрибуты

Комментарии

FrameworkElementявляется базовым элементом: это класс, от который наследуют многие другие среда выполнения Windows классы для поддержки модели элементов пользовательского интерфейса XAML. Свойства, методы и события, которые FrameworkElement определяют, наследуются сотнями других классов среда выполнения Windows.

Многие распространенные классы пользовательского интерфейса XAML являются производными от FrameworkElement, напрямую или через промежуточные базовые классы, такие как Panel или Control. Как правило, классы не являются производными напрямую от FrameworkElement, так как некоторые ожидаемые службы для класса, предназначенного для представления пользовательского интерфейса (например, поддержка шаблонов), реализованы не полностью. Чаще всего используются базовые классы для производных пользовательских классов:

  • Определенные элементы управления, которые не запечатаны (например, TextBox).
  • Базовые классы элементов управления (Control, ContentControl, UserControl).
  • Элементы навигации (Page, Frame).
  • Классы Panel (базовый класс Panel или определенные непечатанные реализации, такие как Grid).

Frameworkelement API и функции

FrameworkElementрасширяет UIElement, который является еще одним базовым элементом, и добавляет поддержку различных среда выполнения Windows функциональных областей.

Layout

Система макета распознает все объекты, производные от FrameworkElement , которые являются элементами, которые потенциально участвуют в макете и должны иметь область отображения в пользовательском интерфейсе приложения. Система макета считывает различные свойства, определенные на FrameworkElement уровне, например MinWidth. Большинство элементов пользовательского интерфейса используют FrameworkElementопределенные значения Width и Height для основных сведений о размерах. FrameworkElement предоставляет расширяемые методы для специализированного поведения макета, которые панели и элементы управления с содержимым могут переопределять в своих реализациях класса. Дополнительные сведения см. в статье Определение макетов с помощью XAML.

Видные API FrameworkElement , поддерживающие макет: Height, Width, ActualHeight, ActualWidth, Margin, MeasureOverride, ArrangeOverride, HorizontalAlignment, VerticalAlignment, LayoutUpdated.

События времени жизни объекта

Часто требуется знать, когда объект впервые загружается (загрузка определяется как присоединение объекта к дереву объектов, которое подключается к корневому визуальному элементу). FrameworkElement определяет события, связанные со временем существования объекта, которые предоставляют полезные обработчики для операций кода программной части. Например, необходимо добавить дочерние объекты в коллекцию или задать свойства дочерних объектов непосредственно перед использованием с гарантией того, что необходимые объекты в дереве объектов уже созданы из разметки XAML. Дополнительные сведения см. в разделе Общие сведения о событиях и перенаправленных событиях.

Известный FrameworkElement API, поддерживающий события времени существования объекта: Loaded, SizeChanged, Unloaded, OnApplyTemplate.

привязка данных,

Возможность задать значение для потенциально наследуемого контекста данных для привязки данных реализуется с помощью FrameworkElement. FrameworkElement также имеет API для создания привязки данных в коде, а не в XAML. Дополнительные сведения см. в статье Подробно о привязке данных.

Известный API, поддерживающий привязку FrameworkElement данных: DataContext, DataContextChanged, SetBinding, GetBindingExpression.

Интеграция языка XAML и модели программирования

Обычно структура элементов приложения напоминает разметку XAML, определенную для создания пользовательского интерфейса, но иногда эта структура меняется после анализа XAML. FrameworkElement определяет свойство Name и связанный API, которые полезны для поиска элементов и связей элементов во время выполнения. Подробнее см. в разделе Области имен XAML.

Основные API FrameworkElement , поддерживающие XAML и модель программирования: Name, FindName, Parent, BaseUri, OnApplyTemplate.

Глобализация

Класс FrameworkElement определяет свойства Language и FlowDirection . Дополнительные сведения см. в статье Глобализация приложения.

Поддержка стилей и тем

Класс FrameworkElement определяет свойства Style и RequestedTheme . Кроме того, свойство Resources используется для определения словарей ресурсов XAML на уровне страницы, которые обычно определяют стили и шаблоны, а также другие общие ресурсы. Дополнительные сведения см. в разделах Стилизация элементов управления и Ссылки на ресурсы ResourceDictionary и XAML.

Свойства зависимостей FrameworkElement

Многие свойства FrameworkElement чтения и записи класса базового элемента являются свойствами зависимостей. Свойства зависимостей поддерживают некоторые базовые функции модели программирования для Windows App SDK приложения на C++ или C#, такие как стили и шаблоны, привязка данных, ссылки на ресурсы XAML и логика изменения свойств. Дополнительные сведения о свойствах зависимостей и поддерживаемых ими функциях см. в статье Общие сведения о свойствах зависимостей.

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

FrameworkElement является родительским классом для нескольких сразу производных классов, которые отличают несколько широких классификаций элементов пользовательского интерфейса. Ниже приведены некоторые важные производные классы:

  • Элемент управления. Элемент управления имеет гораздо больше производных классов элементов управления. В основном все элементы управления XAML, используемые для пользовательского интерфейса среда выполнения Windows, являются производными от control.
  • Выступающие. Выступающий — это класс, который привнося визуальный вид, как правило, путем участия в каком-то сценарии управления, но сам выступающий обычно не является интерактивным. Например: Border, ContentPresenter (родительский элемент ScrollContentPresenter и другие), ItemsPresenter, Viewbox.
  • Элементы мультимедиа и веб-страницы: Image, WebView, MediaPlayerElement. Они отображают содержимое и имеют определенный уровень интерактивности, который происходит в их содержимом, но на самом деле они не являются элементами управления.
  • Элементы отображения текста: TextBlock, RichTextBlock, RichTextBlockOverflow, Глифы. (Текстовые элементы, такие как Run и Hyperlink, которые часто объявляют содержимое элемента отображения текста, не являются производными от FrameworkElement.)
  • Базовый класс Panel : Panel является родительским классом для общих панелей, таких как Grid, StackPanel и т. д.
  • Базовый класс Shape : Shape является родительским классом для Path, Rectangle и т. д.
  • Базовый класс IconElement : родительский класс для FontIcon, SymbolIcon и т. д.
  • Прочие элементы пользовательского интерфейса: Popup, TickBar, Viewbox.

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

FrameworkElement()

Обеспечивает поведение инициализации базового класса для классов, производных от FrameworkElement.

Свойства

AccessKey

Возвращает или задает ключ доступа (мнемонический) для этого элемента.

(Унаследовано от UIElement)
AccessKeyScopeOwner

Возвращает или задает исходный элемент, предоставляющий ключ доступа область для этого элемента, даже если он не находится в визуальном дереве исходного элемента.

(Унаследовано от UIElement)
ActualHeight

Возвращает отрисованную высоту объекта FrameworkElement. См. заметки.

ActualHeightProperty

Идентифицирует свойство зависимостей ActualHeight . См. заметки.

ActualOffset

Возвращает позицию этого элемента UIElement относительно его родительского элемента, вычисленного во время этапа упорядочения процесса макета.

(Унаследовано от UIElement)
ActualSize

Возвращает размер, вычисленный этим элементом UIElement во время этапа упорядочения процесса макета.

(Унаследовано от UIElement)
ActualTheme

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

ActualThemeProperty

Определяет свойство зависимости ActualTheme.

ActualWidth

Возвращает отрисованную ширину элемента FrameworkElement. См. заметки.

ActualWidthProperty

Определяет свойство зависимости ActualWidth . См. заметки.

AllowDrop

Возвращает или задает значение, определяющее, может ли этот элемент UIElement быть целевым объектом перетаскивания для операций перетаскивания.

(Унаследовано от UIElement)
AllowFocusOnInteraction

Возвращает или задает значение, указывающее, получает ли элемент фокус автоматически, когда пользователь взаимодействует с ним.

AllowFocusOnInteractionProperty

Идентифицирует для свойства зависимости AllowFocusOnInteraction .

AllowFocusWhenDisabled

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

AllowFocusWhenDisabledProperty

Определяет свойство зависимости AllowFocusWhenDisabled .

BaseUri

Возвращает универсальный код ресурса (URI), представляющий базовый URI для объекта, созданного в XAML, во время загрузки XAML. Это свойство полезно для разрешения URI во время выполнения.

CacheMode

Возвращает или задает значение, указывающее, что отображаемое содержимое должно быть кэшировано в виде составного растрового изображения, если это возможно.

(Унаследовано от UIElement)
CanBeScrollAnchor

Возвращает или задает значение, указывающее, может ли UIElement быть кандидатом на привязку прокрутки.

(Унаследовано от UIElement)
CanDrag

Возвращает или задает значение, указывающее, можно ли перетаскивать элемент как данные в операции перетаскивания.

(Унаследовано от UIElement)
CenterPoint

Возвращает или задает центральную точку элемента, то есть точку, относительно которой происходит поворот или масштабирование. Влияет на позицию отрисовки элемента.

(Унаследовано от UIElement)
Clip

Возвращает или задает объект RectangleGeometry, используемый для определения контура содержимого элемента UIElement.

(Унаследовано от UIElement)
CompositeMode

Возвращает или задает свойство, объявляющее альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML/Microsoft DirectX.

(Унаследовано от UIElement)
ContextFlyout

Возвращает или задает всплывающий элемент, связанный с этим элементом.

(Унаследовано от UIElement)
DataContext

Возвращает или задает контекст данных для FrameworkElement. Контекст данных часто используется, когда FrameworkElement использует расширение разметки {Binding} и участвует в привязке данных.

DataContextProperty

Определяет свойство зависимости DataContext .

DesiredSize

Возвращает размер, вычисленный этим элементом UIElement во время прохождения меры процесса макета.

(Унаследовано от UIElement)
Dispatcher

Всегда возвращает в null приложении Windows App SDK. Вместо этого используйте DispatcherQueue .

(Унаследовано от DependencyObject)
DispatcherQueue

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

(Унаследовано от DependencyObject)
ExitDisplayModeOnAccessKeyInvoked

Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа.

(Унаследовано от UIElement)
FlowDirection

Возвращает или задает направление, в котором текст и другие элементы пользовательского интерфейса передаются в любом родительском элементе, который управляет их макетом. Этому свойству можно присвоить значение LeftToRight или RightToLeft. При установке FlowDirection значения для RightToLeft любого элемента устанавливается выравнивание справа, порядок чтения справа налево и макет элемента управления для перехода справа налево.

FlowDirectionProperty

Определяет свойство зависимости FlowDirection .

FocusState

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

(Унаследовано от UIElement)
FocusVisualMargin

Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement.

FocusVisualMarginProperty

Определяет свойство зависимости FocusVisualMargin .

FocusVisualPrimaryBrush

Возвращает или задает кисть, используемую для рисования внешней границы визуального HighVisibility элемента или Reveal фокуса для FrameworkElement.

FocusVisualPrimaryBrushProperty

Определяет свойство зависимости FocusVisualPrimaryBrush .

FocusVisualPrimaryThickness

Возвращает или задает толщину внешней границы визуального элемента или Reveal фокуса HighVisibility для FrameworkElement.

FocusVisualPrimaryThicknessProperty

Определяет свойство зависимости FocusVisualPrimaryThickness .

FocusVisualSecondaryBrush

Получает или задает кисть, используемую для рисования внутренней границы визуального HighVisibility элемента или Reveal фокуса для FrameworkElement.

FocusVisualSecondaryBrushProperty

Определяет свойство зависимости FocusVisualSecondaryBrush .

FocusVisualSecondaryThickness

Возвращает или задает толщину внутренней границы визуального HighVisibility элемента или Reveal фокуса для FrameworkElement.

FocusVisualSecondaryThicknessProperty

Определяет свойство зависимости FocusVisualSecondaryThickness .

Height

Возвращает или задает предполагаемую высоту объекта FrameworkElement.

HeightProperty

Определяет свойство зависимости Height .

HighContrastAdjustment

Возвращает или задает значение, указывающее, настраивает ли платформа автоматически визуальные свойства элемента при включении тем с высокой контрастностью.

(Унаследовано от UIElement)
HorizontalAlignment

Возвращает или задает характеристики горизонтального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском элементе макета, например в элементе управления "Панель" или "Элементы".

HorizontalAlignmentProperty

Определяет свойство зависимости HorizontalAlignment .

IsAccessKeyScope

Возвращает или задает значение, указывающее, определяет ли элемент собственный ключ доступа область.

(Унаследовано от UIElement)
IsDoubleTapEnabled

Возвращает или задает значение, определяющее, может ли событие DoubleTapped исходить из этого элемента.

(Унаследовано от UIElement)
IsHitTestVisible

Возвращает или задает значение, указывающее, может ли автономная область этого элемента UIElement возвращать истинные значения для проверки попадания.

(Унаследовано от UIElement)
IsHoldingEnabled

Возвращает или задает значение, определяющее, может ли событие Holding исходить из этого элемента.

(Унаследовано от UIElement)
IsLoaded

Возвращает значение, указывающее, был ли элемент добавлен в дерево элементов и готов ли он к взаимодействию.

IsRightTapEnabled

Возвращает или задает значение, определяющее, может ли событие RightTapped исходить из этого элемента.

(Унаследовано от UIElement)
IsTabStop

Возвращает или задает значение, показывающее, включается ли элемент управления в переходы по ТАВ.

(Унаследовано от UIElement)
IsTapEnabled

Возвращает или задает значение, определяющее, может ли событие Tapped исходить из этого элемента.

(Унаследовано от UIElement)
KeyboardAcceleratorPlacementMode

Возвращает или задает значение, указывающее, отображает ли подсказка элемента управления сочетание клавиш для связанного ускорителя клавиатуры.

(Унаследовано от UIElement)
KeyboardAcceleratorPlacementTarget

Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш ускорителя.

(Унаследовано от UIElement)
KeyboardAccelerators

Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры.

Ускорители обычно назначаются кнопкам или пунктам меню.

Пример меню, в котором показаны сочетания клавиш для различных пунктов меню
Пример меню, в котором показаны сочетания клавиш для различных пунктов меню

(Унаследовано от UIElement)
KeyTipHorizontalOffset

Возвращает или задает значение, указывающее, насколько далеко слева или справа находится подсказка клавиши относительно UIElement.

(Унаследовано от UIElement)
KeyTipPlacementMode

Возвращает или задает значение, указывающее, где находится подсказка клавиши доступа относительно границы UIElement.

(Унаследовано от UIElement)
KeyTipTarget

Возвращает или задает значение, указывающее элемент, на который нацелена подсказка клавиши доступа.

(Унаследовано от UIElement)
KeyTipVerticalOffset

Возвращает или задает значение, указывающее, насколько далеко находится подсказка клавиши относительно элемента пользовательского интерфейса.

(Унаследовано от UIElement)
Language

Возвращает или задает сведения о языке локализации и глобализации, которые применяются к Объекту FrameworkElement, а также ко всем дочерним элементам текущего элемента FrameworkElement в представлении объекта и в пользовательском интерфейсе.

LanguageProperty

Определяет свойство Языковой зависимости.

Lights

Возвращает коллекцию объектов XamlLight, присоединенных к этому элементу.

(Унаследовано от UIElement)
ManipulationMode

Возвращает или задает значение ManipulationModes , используемое для поведения UIElement и взаимодействия с жестами. Установка этого значения позволяет обрабатывать события манипуляции из этого элемента в коде приложения.

(Унаследовано от UIElement)
Margin

Возвращает или задает внешнее поле элемента FrameworkElement.

MarginProperty

Определяет свойство зависимостей Margin .

MaxHeight

Возвращает или задает ограничение максимальной высоты объекта FrameworkElement.

MaxHeightProperty

Определяет свойство зависимостей MaxHeight .

MaxWidth

Возвращает или задает ограничение максимальной ширины объекта FrameworkElement.

MaxWidthProperty

Определяет свойство зависимостей MaxWidth .

MinHeight

Возвращает или задает ограничение минимальной высоты объекта FrameworkElement.

MinHeightProperty

Определяет свойство зависимостей MinHeight .

MinWidth

Возвращает или задает ограничение минимальной ширины объекта FrameworkElement.

MinWidthProperty

Определяет свойство зависимостей MinWidth .

Name

Возвращает или задает идентифицирующие имя объекта. Когда обработчик XAML создает дерево объектов из разметки XAML, код времени выполнения может ссылаться на объект, объявленный XAML, с этим именем.

NameProperty

Идентифицирует свойство зависимости Name .

Opacity

Возвращает или задает степень непрозрачности объекта.

(Унаследовано от UIElement)
OpacityTransition

Возвращает или задает ScalarTransition, который анимирует изменения в свойстве Opacity.

(Унаследовано от UIElement)
Parent

Возвращает родительский объект этого элемента FrameworkElement в дереве объектов.

PointerCaptures

Возвращает набор всех захваченных указателей, представленных в виде значений указателя .

(Унаследовано от UIElement)
Projection

Возвращает или задает проекцию перспективы (трехмерный эффект), применяемую при отрисовке этого элемента.

(Унаследовано от UIElement)
ProtectedCursor

Возвращает или задает курсор, отображаемый, когда указатель находится над этим элементом. По умолчанию имеет значение NULL, указывающее на отсутствие изменения курсора.

(Унаследовано от UIElement)
RasterizationScale

Возвращает значение, представляющее количество необработанных (физических) пикселей для каждого пикселя представления.

(Унаследовано от UIElement)
RenderSize

Возвращает окончательный размер отрисовки элемента UIElement. Использовать не рекомендуется. См. примечания.

(Унаследовано от UIElement)
RenderTransform

Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки элемента UIElement.

(Унаследовано от UIElement)
RenderTransformOrigin

Возвращает или задает точку начала любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ UIElement.

(Унаследовано от UIElement)
RequestedTheme

Возвращает или задает тему пользовательского интерфейса, используемую элементом UIElement (и его дочерними элементами) для определения ресурсов. Тема пользовательского интерфейса, указанная с помощью RequestedTheme , может переопределить элемент RequestedTheme на уровне приложения.

RequestedThemeProperty

Определяет свойство зависимостей RequestedTheme .

Resources

Возвращает локально определенный словарь ресурсов. В XAML элементы ресурсов можно установить в качестве дочерних объектных frameworkElement.Resources элементов элемента свойства с помощью синтаксиса неявной коллекции XAML.

Rotation

Возвращает или задает угол поворота по часовой стрелке в градусах. Поворачивается относительно RotationAxis и CenterPoint. Влияет на позицию отрисовки элемента.

(Унаследовано от UIElement)
RotationAxis

Возвращает или задает ось для поворота элемента.

(Унаследовано от UIElement)
RotationTransition

Возвращает или задает scalarTransition, который анимирует изменения свойства Rotation.

(Унаследовано от UIElement)
Scale

Возвращает или задает масштаб элемента. Масштабируется относительно Элемента CenterPoint. Влияет на позицию отрисовки элемента.

(Унаследовано от UIElement)
ScaleTransition

Возвращает или задает Vector3Transition, который анимирует изменения в свойстве Scale.

(Унаследовано от UIElement)
Shadow

Возвращает или задает эффект тени, приведение к элементу .

(Унаследовано от UIElement)
Style

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

StyleProperty

Определяет свойство зависимостей Style .

TabFocusNavigation

Возвращает или задает значение, изменяющее работу tabbing и TabIndex для этого элемента управления.

(Унаследовано от UIElement)
TabIndex

Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя по элементам управления с помощью клавиши TAB .

(Унаследовано от UIElement)
Tag

Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте.

TagProperty

Идентифицирует свойство зависимостей Тег .

Transform3D

Возвращает или задает эффект трехмерного преобразования, применяемый при отрисовке этого элемента.

(Унаследовано от UIElement)
TransformMatrix

Возвращает или задает матрицу преобразования, применяемую к элементу .

(Унаследовано от UIElement)
Transitions

Возвращает или задает коллекцию элементов стиля перехода , применяемых к UIElement.

(Унаследовано от UIElement)
Translation

Возвращает или задает положение отрисовки x, y и z элемента.

(Унаследовано от UIElement)
TranslationTransition

Возвращает или задает Vector3Transition, который анимирует изменения свойства Translation.

(Унаследовано от UIElement)
Triggers

Возвращает коллекцию триггеров для анимаций, определенных для FrameworkElement. Редко используется. См. заметки.

UseLayoutRounding

Возвращает или задает значение, определяющее, должна ли отрисовка объекта и его визуального поддереви использовать поведение округления, которое выравнивает отрисовку по целым пикселям.

(Унаследовано от UIElement)
UseSystemFocusVisuals

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

(Унаследовано от UIElement)
VerticalAlignment

Возвращает или задает характеристики вертикального выравнивания, применяемые к Объекту FrameworkElement при его создании в родительском объекте, например в элементе управления "Панель" или "Элементы".

VerticalAlignmentProperty

Идентифицирует свойство зависимостей VerticalAlignment .

Visibility

Возвращает или задает видимость uiElement. Невидимый UIElement объект не отображается и не передает нужный размер макету.

(Унаследовано от UIElement)
Width

Возвращает или задает ширину элемента FrameworkElement.

WidthProperty

Определяет свойство зависимости Width .

XamlRoot

Возвращает или задает объект , XamlRoot в котором просматривается данный элемент.

(Унаследовано от UIElement)
XYFocusDown

Возвращает или задает объект, который получает фокус, когда пользователь нажимает на панель направления (D-pad) игрового контроллера.

(Унаследовано от UIElement)
XYFocusDownNavigationStrategy

Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз.

(Унаследовано от UIElement)
XYFocusKeyboardNavigation

Возвращает или задает значение, которое включает или отключает навигацию с помощью стрелки направления клавиатуры.

(Унаследовано от UIElement)
XYFocusLeft

Возвращает или задает объект, который получает фокус, когда пользователь нажимает кнопку слева на направленной панели (D-pad) игрового контроллера.

(Унаследовано от UIElement)
XYFocusLeftNavigationStrategy

Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента левой навигации.

(Унаследовано от UIElement)
XYFocusRight

Возвращает или задает объект, который получает фокус, когда пользователь нажимает прямо на панель направления (D-pad) игрового контроллера.

(Унаследовано от UIElement)
XYFocusRightNavigationStrategy

Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правильной навигации.

(Унаследовано от UIElement)
XYFocusUp

Возвращает или задает объект, который получает фокус, когда пользователь нажимает кнопку управления направлением (D-pad) игрового контроллера.

(Унаследовано от UIElement)
XYFocusUpNavigationStrategy

Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх.

(Унаследовано от UIElement)

Методы

AddHandler(RoutedEvent, Object, Boolean)

Добавляет обработчик перенаправленного события для указанного перенаправленного события, помещая этот обработчик в коллекцию обработчиков текущего элемента. Укажите handledEventsToo значение , true чтобы был вызван предоставленный обработчик, даже если событие обрабатывается в другом месте.

(Унаследовано от UIElement)
Arrange(Rect)

Размещает дочерние объекты и определяет размер элемента UIElement. Родительские объекты, реализующие пользовательский макет для своих дочерних элементов, должны вызывать этот метод из реализаций переопределения макета, чтобы сформировать рекурсивное обновление макета.

(Унаследовано от UIElement)
ArrangeOverride(Size)

Предоставляет поведение для прохода "Упорядочить" макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи "Упорядочить".

CancelDirectManipulations()

Отменяет текущую обработку прямых манипуляций (определяемое системой сдвиг или масштабирование) в любом родительском элементе ScrollViewer , содержающем текущий элемент UIElement.

(Унаследовано от UIElement)
CapturePointer(Pointer)

Задает запись указателя на uiElement. После захвата события, связанные с указателем, будут запускаться только элемент, имеющий запись.

(Унаследовано от UIElement)
ClearValue(DependencyProperty)

Очищает локальное значение свойства зависимостей.

(Унаследовано от DependencyObject)
DeferTree(DependencyObject)

Удаляет указанный элемент из визуального дерева XAML таким образом, чтобы его можно было отменить позже.

FindName(String)

Извлекает объект с указанным именем идентификатора.

FindSubElementsForTouchTargeting(Point, Rect)

Позволяет подклассу UIElement предоставлять дочерние элементы, помогающие в разрешении сенсорного нацеливания.

(Унаследовано от UIElement)
Focus(FocusState)

Попытка задать фокус для данного элемента.

(Унаследовано от UIElement)
GetAnimationBaseValue(DependencyProperty)

Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна.

(Унаследовано от DependencyObject)
GetBindingExpression(DependencyProperty)

Возвращает bindingExpression , представляющее привязку к указанному свойству.

GetChildrenInTabFocusOrder()

Позволяет подклассу UIElement предоставлять дочерние элементы, которые принимают участие в фокусе tab.

(Унаследовано от UIElement)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей из DependencyObject.

(Унаследовано от DependencyObject)
GetVisualInternal()

Извлекает объект , Visual в который разрешается элемент .

(Унаследовано от UIElement)
GoToElementStateCore(String, Boolean)

При реализации в производном классе позволяет создавать визуальное дерево для шаблона элемента управления в коде, а не загружать XAML для всех состояний при запуске элемента управления.

InvalidateArrange()

Делает недействительным состояние упорядочения (макет) для UIElement. После аннулирования макет UIElement будет обновлен, что будет происходить асинхронно.

(Унаследовано от UIElement)
InvalidateMeasure()

Делает недействительным состояние измерения (макет) для элемента UIElement.

(Унаследовано от UIElement)
InvalidateViewport()

Делает недействительным состояние окна просмотра для элемента UIElement , используемого для вычисления действующего окна просмотра.

Measure(Size)

Обновления DesiredSizeэлемента UIElement. Как правило, объекты, реализующие пользовательский макет для дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride , чтобы сформировать рекурсивное обновление макета.

(Унаследовано от UIElement)
MeasureOverride(Size)

Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение прохода "Measure".

OnApplyTemplate()

Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение макета) вызывают Метод ApplyTemplate. Проще говоря, это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона класса по умолчанию.

OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Вызывается перед событием BringIntoViewRequested .

(Унаследовано от UIElement)
OnCreateAutomationPeer()

При реализации в производном классе возвращает реализации AutomationPeer для конкретного класса для инфраструктуры Microsoft модель автоматизации пользовательского интерфейса.

(Унаследовано от UIElement)
OnDisconnectVisualChildren()

Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из свойства содержимого или дочерних элементов класса.

(Унаследовано от UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Вызывается при обработке сочетания клавиш (или ускорителя) в приложении. Переопределите этот метод для обработки реакции приложения при вызове ускорителя клавиатуры.

(Унаследовано от UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Вызывается непосредственно перед обработкой сочетания клавиш (или ускорителя) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerators. Переопределите этот метод, чтобы повлиять на обработку ускорителя по умолчанию.

(Унаследовано от UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Определяет свойство, которое можно анимировать.

(Унаследовано от UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

При переопределении в производном классе определяет свойство, которое можно анимировать.

(Унаследовано от UIElement)
ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если задано локальное значение.

(Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Регистрирует функцию уведомления для прослушивания изменений определенного DependencyProperty в этом экземпляре DependencyObject .

(Унаследовано от DependencyObject)
ReleasePointerCapture(Pointer)

Освобождает записи указателя для захвата одного конкретного указателя данным элементом UIElement.

(Унаследовано от UIElement)
ReleasePointerCaptures()

Освобождает все записи указателей, хранящиеся в этом элементе.

(Унаследовано от UIElement)
RemoveHandler(RoutedEvent, Object)

Удаляет указанный обработчик перенаправленных событий из этого элемента UIElement. Как правило, рассматриваемый обработчик был добавлен с помощью AddHandler.

(Унаследовано от UIElement)
SetBinding(DependencyProperty, BindingBase)

Присоединяет привязку к FrameworkElement, используя предоставленный объект привязки.

SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей для Объекта DependencyObject.

(Унаследовано от DependencyObject)
StartAnimation(ICompositionAnimationBase)

Начинает указанную анимацию элемента.

(Унаследовано от UIElement)
StartBringIntoView()

Инициирует запрос к платформе XAML для представления элемента в любых прокручиваемых областях, в которые он содержится.

(Унаследовано от UIElement)
StartBringIntoView(BringIntoViewOptions)

Инициирует запрос к платформе XAML для вывода элемента в представление с помощью указанных параметров.

(Унаследовано от UIElement)
StartDragAsync(ExpPointerPoint)

Предоставляет класс базовых элементов для объектов пользовательского интерфейса среда выполнения Windows. FrameworkElement определяет общий API, поддерживающий взаимодействие с пользовательским интерфейсом и систему автоматического макета. FrameworkElement также определяет API, связанные с привязкой данных, определением и изучением дерева объектов и отслеживанием времени существования объекта.

(Унаследовано от UIElement)
StartDragAsync(PointerPoint)

Инициирует операцию перетаскивания.

Важно!

Не поддерживается, если пользователь запускает приложение в режиме с повышенными привилегиями в качестве администратора.

(Унаследовано от UIElement)
StopAnimation(ICompositionAnimationBase)

Останавливает указанную анимацию в элементе .

(Унаследовано от UIElement)
TransformToVisual(UIElement)

Возвращает объект преобразования, который можно использовать для преобразования координат из UIElement в указанный объект.

(Унаследовано от UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Пытается вызвать сочетание клавиш (или ускоритель), выполнив поиск сочетания клавиш во всем визуальном дереве UIElement.

(Унаследовано от UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова Метода RegisterPropertyChangedCallback.

(Унаследовано от DependencyObject)
UpdateLayout()

Обеспечивает правильное обновление всех положений дочерних объектов UIElement для макета.

(Унаследовано от UIElement)

События

AccessKeyDisplayDismissed

Происходит, когда ключи доступа больше не должны отображаться.

(Унаследовано от UIElement)
AccessKeyDisplayRequested

Происходит, когда пользователь запрашивает отображение ключей доступа.

(Унаследовано от UIElement)
AccessKeyInvoked

Происходит, когда пользователь завершает последовательность ключей доступа.

(Унаследовано от UIElement)
ActualThemeChanged

Происходит при изменении значения свойства ActualTheme.

BringIntoViewRequested

Происходит при вызове StartBringIntoView для этого элемента или одного из его потомков.

(Унаследовано от UIElement)
CharacterReceived

Происходит при получении одного составного символа входной очередью.

(Унаследовано от UIElement)
ContextCanceled

Происходит, когда жест ввода контекста переходит в жест манипуляции, чтобы уведомить элемент о том, что всплывающий элемент контекста не должен открываться.

(Унаследовано от UIElement)
ContextRequested

Происходит, когда пользователь завершил жест ввода контекста, например щелчок правой кнопкой мыши.

(Унаследовано от UIElement)
DataContextChanged

Происходит при изменении значения свойства FrameworkElement.DataContext .

DoubleTapped

Происходит, когда необработанное в противном случае взаимодействие DoubleTap происходит над областью проверки попадания этого элемента.

(Унаследовано от UIElement)
DragEnter

Происходит, когда система ввода сообщает о базовом событии перетаскивания с этим элементом в качестве целевого объекта.

(Унаследовано от UIElement)
DragLeave

Происходит, когда система ввода сообщает о базовом событии перетаскивания с этим элементом в качестве источника.

(Унаследовано от UIElement)
DragOver

Происходит, когда подсистема ввода сообщает о соответствующем событии перетаскивания, имеющем в качестве потенциальной цели данный элемент.

(Унаследовано от UIElement)
DragStarting

Происходит при инициации операции перетаскивания.

(Унаследовано от UIElement)
Drop

Происходит, когда система ввода сообщает о базовом событии удаления с этим элементом в качестве цели удаления.

(Унаследовано от UIElement)
DropCompleted

Происходит при завершении операции перетаскивания с этим элементом в качестве источника.

(Унаследовано от UIElement)
EffectiveViewportChanged

Происходит при изменении действующего окна просмотраFrameworkElement.

GettingFocus

Происходит до того, как элемент UIElement получит фокус. Это событие создается синхронно, чтобы фокус не перемещался во время восходящего события.

(Унаследовано от UIElement)
GotFocus

Происходит, когда элемент UIElement получает фокус. Это событие возникает асинхронно, поэтому фокус может снова переместиться до завершения восходящего движения.

(Унаследовано от UIElement)
Holding

Происходит, когда в противном случае происходит необработанное взаимодействие удержания над областью проверки попадания этого элемента.

(Унаследовано от UIElement)
KeyDown

Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
KeyUp

Происходит при отпускание клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
LayoutUpdated

Происходит при изменении макета визуального дерева из-за изменения значения релевантных для макета свойств или другого действия, которое обновляет макет.

Loaded

Происходит, когда элемент FrameworkElement создан и добавлен в дерево объектов и готов к взаимодействию.

Loading

Происходит при начале загрузки FrameworkElement .

LosingFocus

Происходит до того, как элемент UIElement теряет фокус. Это событие создается синхронно, чтобы фокус не перемещался во время восходящего события.

(Унаследовано от UIElement)
LostFocus

Происходит, когда элемент UIElement теряет фокус. Это событие возникает асинхронно, поэтому фокус может снова переместиться до завершения восходящего движения.

(Унаследовано от UIElement)
ManipulationCompleted

Происходит после завершения манипуляции с UIElement .

(Унаследовано от UIElement)
ManipulationDelta

Происходит, когда устройство ввода меняет положение в процессе манипуляции.

(Унаследовано от UIElement)
ManipulationInertiaStarting

Происходит, если во время манипуляции устройство ввода теряет контакт с объектом UIElement и начинает действовать инерция.

(Унаследовано от UIElement)
ManipulationStarted

Происходит, когда устройство ввода начинает манипуляцию над UIElement.

(Унаследовано от UIElement)
ManipulationStarting

Происходит при первоначальном создании процессора манипулирования.

(Унаследовано от UIElement)
NoFocusCandidateFound

Происходит, когда пользователь пытается переместить фокус (с помощью табуляции или стрелки направления), но фокус не перемещается, так как в направлении перемещения не найден кандидат фокуса.

(Унаследовано от UIElement)
PointerCanceled

Происходит, когда указатель, создающий контакт, теряет контакт.

(Унаследовано от UIElement)
PointerCaptureLost

Происходит, когда захват указателя, ранее удерживаемый этим элементом, перемещается в другой элемент или в другое место.

(Унаследовано от UIElement)
PointerEntered

Происходит, когда указатель входит в область проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerExited

Происходит, когда указатель покидает область проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerMoved

Происходит при перемещении указателя, в то время как указатель остается в области проверки попадания этого элемента.

(Унаследовано от UIElement)
PointerPressed

Происходит, когда указатель инициирует действие Нажатие в этом элементе.

(Унаследовано от UIElement)
PointerReleased

Происходит при освобождении устройства указателя, которое ранее инициировало действие Нажатие , в этом элементе. Обратите внимание, что окончание действия Нажатие не гарантирует, что событие будет вызываться PointerReleased . Вместо этого могут возникать другие события. Дополнительные сведения см. в разделе Примечания.

(Унаследовано от UIElement)
PointerWheelChanged

Происходит при изменении разностного значения колесика указателя.

(Унаследовано от UIElement)
PreviewKeyDown

Происходит при нажатии клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
PreviewKeyUp

Происходит при отпускание клавиши клавиатуры, когда элемент UIElement находится в фокусе.

(Унаследовано от UIElement)
ProcessKeyboardAccelerators

Происходит при нажатии сочетания клавиш (или сочетания клавиш).

(Унаследовано от UIElement)
RightTapped

Возникает при возникновении стимула ввода правой кнопкой касания, когда указатель находится над элементом.

(Унаследовано от UIElement)
SizeChanged

Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement.

Tapped

Происходит, когда в противном случае происходит необработанное взаимодействие с касанием в области проверки попадания этого элемента.

(Унаследовано от UIElement)
Unloaded

Происходит, когда этот объект больше не подключен к дереву объектов main.

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

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