FrameworkElement Класс

Определение

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

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

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

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

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

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

Frameworkelement API и функции

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

Макет

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

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

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

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

Известный API FrameworkElement, поддерживающий события времени существования объекта: 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 для чтения и записи являются свойствами зависимостей. Свойства зависимостей поддерживают некоторые основные функции модели программирования для приложения UWP с помощью C++, C# или Visual Basic, такие как стили и шаблоны, привязка данных, ссылки на ресурсы XAML и логика изменения свойств. Дополнительные сведения о свойствах зависимостей и поддерживаемых функциях см. в обзоре свойств зависимостей.

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

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

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

Журнал версий

Версия Windows Версия пакета SDK Добавлено значение
1607 14393 AllowFocusOnInteraction
1607 14393 AllowFocusWhenDisabled
1607 14393 FocusVisualMargin
1607 14393 FocusVisualPrimaryBrush
1607 14393 FocusVisualPrimaryThickness
1607 14393 FocusVisualSecondaryBrush
1607 14393 FocusVisualSecondaryThickness
1703 15063 DeferTree
1709 16299 ActualTheme
1709 16299 ActualThemeChanged
1809 17763 EffectiveViewportChanged
1809 17763 InvalidateViewport
1809 17763 IsLoaded

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

FrameworkElement()

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

Свойства

AccessKey

Получает или задает ключ доступа (mnemonic) для этого элемента.

(Унаследовано от 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

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

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

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

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

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

FlowDirectionProperty

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

FocusVisualMargin

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

FocusVisualMarginProperty

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

FocusVisualPrimaryBrush

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

FocusVisualPrimaryBrushProperty

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

FocusVisualPrimaryThickness

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

FocusVisualPrimaryThicknessProperty

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

FocusVisualSecondaryBrush

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

FocusVisualSecondaryBrushProperty

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

FocusVisualSecondaryThickness

Возвращает или задает толщину внутренней границы визуального элемента или Reveal фокуса HighVisibility для 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)
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)
RenderSize

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

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

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

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

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

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

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

RequestedThemeProperty

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

Resources

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

Rotation

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

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

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

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

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

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

Возвращает или задает масштаб элемента. Масштабируется относительно ЦентраPoint элемента. Влияет на положение отрисовки элемента.

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

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

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

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

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

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

StyleProperty

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

TabFocusNavigation

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

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

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

TagProperty

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

Transform3D

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

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

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

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

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

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

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

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

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

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

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

UIContext

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

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

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

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

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

VerticalAlignmentProperty

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

Visibility

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

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

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

WidthProperty

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

XamlRoot

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

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

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

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

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

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

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

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

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

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

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

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

Методы

AddHandler(RoutedEvent, Object, Boolean)

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

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

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

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

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

CancelDirectManipulations()

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

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

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

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

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

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

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

FindName(String)

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

FindSubElementsForTouchTargeting(Point, Rect)

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

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

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

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

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

GetChildrenInTabFocusOrder()

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

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

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

(Унаследовано от DependencyObject)
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(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

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

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

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

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

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