FrameworkElement Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет базовый класс элементов для объектов пользовательского интерфейса Windows Runtime.
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 : UIElementPublic Class FrameworkElement
Inherits UIElement- Наследование
- Производный
- Атрибуты
Комментарии
FrameworkElement является базовым элементом: это класс, от который многие другие классы Windows Runtime наследуются для поддержки модели элементов пользовательского интерфейса XAML. Свойства, методы и события, которые FrameworkElement определяются сотнями других классов Windows Runtime.
Многие распространенные классы пользовательского интерфейса XAML являются производными от FrameworkElement, напрямую или через промежуточные базовые классы, такие как Панель или Элемент управления. Как правило, вы не наследуете классы напрямую, FrameworkElementтак как определенные ожидаемые службы для класса, предназначенного для представления пользовательского интерфейса (например, поддержки шаблонов), не полностью реализованы там. Более часто используются базовые классы для производных пользовательских классов:
- Определенные элементы управления, которые не запечатаны (например, TextBox).
- Управление базовыми классами (Control, ContentControl, UserControl).
- Элементы навигации (Page, Frame).
- Классы панели (панель базового класса или определенные непечатанные реализации, такие как Grid).
Frameworkelement API и функции
FrameworkElement расширяет UIElement, который является другим базовым элементом и добавляет поддержку различных областей функций Windows Runtime.
Макет
Система макета распознает все объекты, производные от FrameworkElement элементов, которые потенциально участвуют в макете и должны иметь область отображения в пользовательском интерфейсе приложения. Система макета считывает различные свойства, определенные на FrameworkElement уровне, например MinWidth. Большинство элементов пользовательского интерфейса используют определяемую FrameworkElementширину и высоту для основных сведений о размерах.
FrameworkElement предоставляет расширяемые методы для специализированного поведения макета, которое панели и элементы управления с содержимым могут переопределяться в реализации класса. Дополнительные сведения см. в разделе "Определение макетов с помощью XAML".
Видный API этой поддержкиFrameworkElement: Height, Width, ActualHeight, ActualWidth, Margin, MeasureOverride, ArrangeOverride, HorizontalAlignment, VerticalAlignment, LayoutUpdated.
События времени существования объекта
Часто требуется знать, когда объект сначала загружается (загружается , как при присоединении объекта к дереву объектов, которое подключается к корневому визуальному элементу).
FrameworkElement определяет события, связанные со временем существования объекта, которые предоставляют полезные перехватчики для операций программной части. Например, вам нужна информация о времени существования объекта для добавления дочерних объектов в коллекцию или задания свойств дочерних объектов непосредственно перед использованием, с уверенностью в том, что необходимые объекты в дереве объектов уже созданы из разметки XAML. Дополнительные сведения см. в разделе "События" и обзор перенаправленных событий.
Известный FrameworkElement API, поддерживающий события времени существования объекта: Loaded, SizeChanged, Выгрузлено, OnApplyTemplate.
Привязка данных
Возможность задать значение потенциально унаследованного контекста данных для привязки данных реализуется FrameworkElement.
FrameworkElement также имеет API для установления привязки данных в коде, а не в XAML. Дополнительные сведения см. в разделе Подробное изучение привязки данных.
Известный FrameworkElement API, поддерживающий привязку данных: DataContext, DataContextChanged, SetBinding, GetBindingExpression.
Интеграция языка XAML и модели программирования
Обычно структура элементов приложения напоминает разметку XAML, определенную для создания пользовательского интерфейса, но иногда изменения структуры после анализа XAML.
FrameworkElement определяет свойство Name и связанный API, которые полезны для поиска элементов и связей элементов во время выполнения. Дополнительные сведения см. в пространствах имен XAML.
Известный FrameworkElement API, поддерживающий модель XAML и программирования: Name, FindName, Parent, BaseUri, OnApplyTemplate.
Globalization
Класс FrameworkElement определяет свойство Language и свойство FlowDirection . Дополнительные сведения см. в статье "Глобализация приложения".
Поддержка стилей и тем
Класс FrameworkElement определяет свойство Style и свойство RequestedTheme . Кроме того, свойство Resources используется для определения словарей ресурсов XAML на уровне страницы, которые обычно определяют стили и шаблоны, а также другие общие ресурсы. Дополнительные сведения см. в разделе "Элементы управления Styling " и ссылки на ресурсы ResourceDictionary и XAML.
Свойства зависимостей FrameworkElement
Многие свойства FrameworkElement чтения и записи базового класса элементов являются свойствами зависимостей. Свойства зависимостей поддерживают некоторые основные функции модели программирования для приложения Windows App SDK с помощью C++ или C#, таких как стили и шаблоны, привязка данных, ссылки на ресурсы XAML и логика изменения свойств. Дополнительные сведения о свойствах зависимостей и поддерживаемых функциях см. в обзоре свойств зависимостей.
Производные классы FrameworkElement
FrameworkElement — родительский класс для нескольких сразу производных классов, которые различают несколько широких классификаций элементов пользовательского интерфейса. Ниже приведены некоторые из известных производных классов:
- Control: Control имеет гораздо больше производных классов элементов управления, в основном все элементы управления XAML, используемые для пользовательского интерфейса Windows Runtime, производные от Control.
- Выступающие: ведущий — это класс, который дает визуальный вид, обычно путем внесения в некоторый сценарий управления, но сам выступающий не обычно интерактивный. Например: Border, ContentPresenter (родительский элемент ScrollContentPresenter и другие), ItemsPresenter, Viewbox.
- Элементы мультимедиа и веб-элементов: Image, WebView, MediaPlayerElement. Они отображают содержимое и имеют некоторый уровень интерактивности, который происходит в их содержимом, но они на самом деле не являются элементами управления.
- Элементы отображения текста: TextBlock, RichTextBlock, RichTextBlockOverflow, Глифы. (Текстовые элементы, такие как Run и Гиперссылка, которые часто объявляют содержимое элемента отображения текста, не являются производными от FrameworkElement.)
- Базовый класс Panel : Панель является родительским классом для общих панелей, таких как Grid, StackPanel и т. д.
- Базовый класс Фигуры : фигура является родительским классом для Path, Rectangle и т. д.
- Базовый класс IconElement : родительский класс для FontIcon, SymbolIcon и т. д.
- Другие элементы пользовательского интерфейса: Всплывающее окно, TickBar, Viewbox.
Конструкторы
| Имя | Описание |
|---|---|
| FrameworkElement() |
Предоставляет поведение инициализации базового класса для классов, производных от FrameworkElement. |
Свойства
| Имя | Описание |
|---|---|
| AccessKey |
Получает или задает ключ доступа (mnemonic) для этого элемента. (Унаследовано от UIElement) |
| AccessKeyScopeOwner |
Возвращает или задает исходный элемент, предоставляющий область ключа доступа для этого элемента, даже если он не находится в визуальном дереве исходного элемента. (Унаследовано от UIElement) |
| ActualHeight |
Возвращает отрисованную высоту объекта FrameworkElement. См. примечания. |
| ActualHeightProperty |
Определяет свойство зависимости ActualHeight . См. примечания. |
| ActualOffset |
Получает позицию этого UIElement относительно родительского элемента, вычисляемого во время прохождения процесса макета. (Унаследовано от UIElement) |
| ActualSize |
Возвращает размер, вычисляемый этим UIElement во время упорядочивания процесса макета. (Унаследовано от UIElement) |
| ActualTheme |
Возвращает тему пользовательского интерфейса, которая в настоящее время используется элементом, который может отличаться от запрошенного элемента. |
| 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 |
Возвращает или задает прямоугольникGeometry , используемый для определения структуры содержимого UIElement. (Унаследовано от UIElement) |
| CompositeMode |
Возвращает или задает свойство, которое объявляет альтернативные режимы композиции и смешивания для элемента в родительском макете и окне. Это относится к элементам, участвующим в смешанном пользовательском интерфейсе XAML или Microsoft DirectX. (Унаследовано от UIElement) |
| ContextFlyout |
Возвращает или задает всплывающий элемент, связанный с этим элементом. (Унаследовано от UIElement) |
| DataContext |
Возвращает или задает контекст данных для FrameworkElement. Обычно используется контекст данных, когда |
| DataContextProperty |
Определяет свойство зависимостей DataContext . |
| DesiredSize |
Возвращает размер, вычисляемый этим UIElement во время прохождения меры процесса макета. (Унаследовано от UIElement) |
| Dispatcher |
Всегда возвращается |
| DispatcherQueue |
Возвращает, |
| ExitDisplayModeOnAccessKeyInvoked |
Возвращает или задает значение, указывающее, закрывается ли отображение ключа доступа при вызове ключа доступа. (Унаследовано от UIElement) |
| FlowDirection |
Получает или задает направление, в котором поток текста и других элементов пользовательского интерфейса в любом родительском элементе, который управляет их макетом. Это свойство может иметь значение |
| FlowDirectionProperty |
Определяет свойство зависимости FlowDirection . |
| FocusState |
Возвращает значение, указывающее, имеет ли этот элемент управления фокус и режим получения фокуса. (Унаследовано от UIElement) |
| FocusVisualMargin |
Возвращает или задает внешнее поле визуального элемента фокуса для FrameworkElement. |
| FocusVisualMarginProperty |
Определяет свойство зависимости FocusVisualMargin . |
| FocusVisualPrimaryBrush |
Возвращает или задает кисть, используемую для рисования внешней границы визуального элемента или |
| FocusVisualPrimaryBrushProperty |
Определяет свойство зависимости FocusVisualPrimaryBrush . |
| FocusVisualPrimaryThickness |
Возвращает или задает толщину внешней границы визуального элемента или |
| FocusVisualPrimaryThicknessProperty |
Определяет свойство зависимости FocusVisualPrimaryThickness . |
| FocusVisualSecondaryBrush |
Возвращает или задает кисть, используемую для рисования внутренней границы визуального элемента или |
| FocusVisualSecondaryBrushProperty |
Определяет свойство зависимостей FocusVisualSecondaryBrush . |
| FocusVisualSecondaryThickness |
Возвращает или задает толщину внутренней границы визуального элемента или |
| 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 |
Возвращает или задает значение, определяющее, может ли событие "Касаться" из этого элемента. (Унаследовано от UIElement) |
| KeyboardAcceleratorPlacementMode |
Возвращает или задает значение, указывающее, отображается ли подсказка элемента управления сочетание клавиш для связанного акселератора клавиатуры. (Унаследовано от UIElement) |
| KeyboardAcceleratorPlacementTarget |
Возвращает или задает значение, указывающее подсказку элемента управления, отображающую сочетание клавиш акселератора. (Унаследовано от UIElement) |
| KeyboardAccelerators |
Возвращает коллекцию сочетаний клавиш, которые вызывают действие с помощью клавиатуры. Ускорители обычно назначаются кнопкам или элементам меню.
|
| 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 |
Получает или задает проекцию перспективы (эффект 3-D), применяемую при отрисовке этого элемента. (Унаследовано от UIElement) |
| ProtectedCursor |
Возвращает или задает курсор, отображающийся, когда указатель находится над этим элементом. По умолчанию имеет значение NULL, указывающее, что курсор не изменяется. (Унаследовано от UIElement) |
| RasterizationScale |
Возвращает значение, представляющее дополнительный коэффициент масштабирования, используемый при отрисовке фигур, изображений, текста или мультимедиа, как правило, для отрисовки в более высоком разрешении, чем обычно. (Унаследовано от UIElement) |
| RenderSize |
Возвращает окончательный размер отрисовки пользовательского элемента UIElement. Использование не рекомендуется, см. примечания. (Унаследовано от UIElement) |
| RenderTransform |
Возвращает или задает сведения о преобразовании, влияющие на положение отрисовки пользовательского элемента UIElement. (Унаследовано от UIElement) |
| RenderTransformOrigin |
Возвращает или задает точку источника любого возможного преобразования отрисовки, объявленного RenderTransform, относительно границ uiElement. (Унаследовано от UIElement) |
| RequestedTheme |
Возвращает или задает тему пользовательского интерфейса, используемую UIElement (и ее дочерними элементами) для определения ресурсов. Указанная тема |
| RequestedThemeProperty |
Определяет свойство зависимостей RequestedTheme . |
| Resources |
Возвращает локально определенный словарь ресурсов. В XAML можно установить элементы ресурсов в качестве дочерних |
| Rotation |
Получает или задает угол поворота по часовой стрелке в градусах. Поворот по отношению к RotationAxis и CenterPoint. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| RotationAxis |
Возвращает или задает ось для поворота элемента вокруг. (Унаследовано от UIElement) |
| RotationTransition |
Возвращает или задает ScalarTransition, который анимирует изменения свойства "Поворот". (Унаследовано от UIElement) |
| Scale |
Возвращает или задает масштаб элемента. Масштабируется относительно ЦентраPoint элемента. Влияет на положение отрисовки элемента. (Унаследовано от UIElement) |
| ScaleTransition |
Возвращает или задает объект Vector3Transition, который анимирует изменения свойства Scale. (Унаследовано от UIElement) |
| Shadow |
Возвращает или задает эффект тени, приведение к элементу. (Унаследовано от UIElement) |
| Style |
Возвращает или задает стиль экземпляра, применяемый для этого объекта во время макета и отрисовки. |
| StyleProperty |
Определяет свойство зависимостей style . |
| TabFocusNavigation |
Возвращает или задает значение, которое изменяет работу табуляции и tabIndex для этого элемента управления. (Унаследовано от UIElement) |
| TabIndex |
Возвращает или задает значение, определяющее порядок, в котором элементы получают фокус при переходе пользователя через элементы управления с помощью клавиши TAB . (Унаследовано от UIElement) |
| Tag |
Возвращает или задает произвольное значение объекта, которое можно использовать для хранения пользовательских сведений об этом объекте. |
| TagProperty |
Определяет свойство зависимостей тега . |
| Transform3D |
Возвращает или задает эффект преобразования 3-D, применяемый при отрисовке этого элемента. (Унаследовано от 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. Объект |
| Width |
Возвращает или задает ширину FrameworkElement. |
| WidthProperty |
Определяет свойство зависимостей Width . |
| XamlRoot |
Возвращает или задает объект |
| XYFocusDown |
Получает или задает объект, который получает фокус, когда пользователь нажимает вниз на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusDownNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вниз. (Унаследовано от UIElement) |
| XYFocusKeyboardNavigation |
Возвращает или задает значение, которое включает или отключает навигацию с помощью клавишных стрелков. (Унаследовано от UIElement) |
| XYFocusLeft |
Получает или задает объект, который получает фокус, когда пользователь нажимает слева на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusLeftNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации слева. (Унаследовано от UIElement) |
| XYFocusRight |
Получает или задает объект, который получает фокус, когда пользователь нажимает прямо на панели направления (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusRightNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента правой навигации. (Унаследовано от UIElement) |
| XYFocusUp |
Возвращает или задает объект, который получает фокус, когда пользователь нажимает клавишу Directional Pad (D-pad) игрового контроллера. (Унаследовано от UIElement) |
| XYFocusUpNavigationStrategy |
Возвращает или задает значение, указывающее стратегию, используемую для определения целевого элемента навигации вверх. (Унаследовано от UIElement) |
Методы
| Имя | Описание |
|---|---|
| AddHandler(RoutedEvent, Object, Boolean) |
Добавляет перенаправленный обработчик событий для указанного перенаправленного события, добавив обработчик в коллекцию обработчика текущего элемента. Укажите |
| 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() |
Извлекает разрешение |
| GoToElementStateCore(String, Boolean) |
При реализации в производном классе позволяет создавать визуальное дерево визуального дерева для шаблона элемента управления в коде, а не загружать XAML для всех состояний при запуске элемента управления. |
| InvalidateArrange() |
Отменяет состояние упорядочивания (макет) для UIElement. После недопустимости uiElement будет обновлен его макет, который будет выполняться асинхронно. (Унаследовано от UIElement) |
| InvalidateMeasure() |
Отменяет состояние измерения (макет) для UIElement. (Унаследовано от UIElement) |
| InvalidateViewport() |
Отменяет состояние окна просмотра для пользовательского интерфейса, используемого для вычисления эффективного окна просмотра. |
| Measure(Size) |
Обновляет элемент DesiredSizeпользовательского интерфейса. Как правило, объекты, реализующие настраиваемый макет для дочерних элементов макета, вызывают этот метод из собственных реализаций MeasureOverride для формирования рекурсивного обновления макета. (Унаследовано от UIElement) |
| MeasureOverride(Size) |
Предоставляет поведение для прохода "Measure" цикла макета. Классы могут переопределить этот метод, чтобы определить собственное поведение передачи Measure. |
| OnApplyTemplate() |
Вызывается всякий раз, когда код приложения или внутренние процессы (например, перестроение прохода макета) вызывают ApplyTemplate. В самых простых терминах это означает, что метод вызывается непосредственно перед отображением элемента пользовательского интерфейса в приложении. Переопределите этот метод, чтобы повлиять на логику после шаблона по умолчанию класса. |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Вызывается перед событием BringIntoViewRequested . (Унаследовано от UIElement) |
| OnCreateAutomationPeer() |
При реализации в производном классе возвращает AutomationPeer реализации для инфраструктуры Microsoft UI Automation. (Унаследовано от UIElement) |
| OnDisconnectVisualChildren() |
Переопределите этот метод, чтобы реализовать поведение макета и логики при удалении элементов из содержимого определенного класса или дочернего свойства. (Унаследовано от UIElement) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Вызывается при обработке сочетания клавиш (или акселератора) в приложении. Переопределите этот метод для обработки реагирования приложения при вызове акселератора клавиатуры. (Унаследовано от UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Вызывается непосредственно перед обработкой сочетания клавиш (или акселератора) в приложении. Вызывается всякий раз, когда код приложения или внутренние процессы вызывают ProcessKeyboardAccelerator. Переопределите этот метод, чтобы повлиять на обработку акселератора по умолчанию. (Унаследовано от 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 Runtime.
|
| StartDragAsync(PointerPoint) |
Инициирует операцию перетаскивания. Important Не поддерживается, если пользователь запускает приложение в режиме с повышенными привилегиями, как администратор. |
| 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 |
Происходит, когда устройство указателя инициирует действие Press в этом элементе. (Унаследовано от UIElement) |
| PointerReleased |
Происходит при выпуске указателя устройства, инициированного ранее действием Press , в то время как в этом элементе. Обратите внимание, что конец действия прессы не гарантируется для запуска |
| PointerWheelChanged |
Происходит при изменении разностного значения колесика указателя. (Унаследовано от UIElement) |
| PreviewKeyDown |
Происходит при нажатии клавиши клавиатуры, когда элемент UIElement имеет фокус. (Унаследовано от UIElement) |
| PreviewKeyUp |
Происходит при выпуске клавиши клавиатуры, когда элемент UIElement имеет фокус. (Унаследовано от UIElement) |
| ProcessKeyboardAccelerators |
Происходит при нажатии сочетания клавиш (или акселератора ). (Унаследовано от UIElement) |
| RightTapped |
Происходит, когда стимул ввода правого касания происходит, пока указатель находится над элементом. (Унаследовано от UIElement) |
| SizeChanged |
Происходит при изменении значения свойства ActualHeight или ActualWidth в FrameworkElement. |
| Tapped |
Возникает, когда в противном случае необработанное взаимодействие касания происходит через область теста попадания этого элемента. (Унаследовано от UIElement) |
| Unloaded |
Происходит, когда этот объект больше не подключен к дереву основного объекта. |