Element Класс

Определение

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

public ref class Element abstract : Microsoft::Maui::Controls::BindableObject, Microsoft::Maui::Controls::IEffectControlProvider, Microsoft::Maui::Controls::IElementController, Microsoft::Maui::Controls::Internals::INameScope, Microsoft::Maui::IContextFlyoutElement, Microsoft::Maui::IElement, Microsoft::Maui::IToolTipElement, Microsoft::Maui::IVisualTreeElement
public abstract class Element : Microsoft.Maui.Controls.BindableObject, Microsoft.Maui.Controls.IEffectControlProvider, Microsoft.Maui.Controls.IElementController, Microsoft.Maui.Controls.Internals.INameScope, Microsoft.Maui.IContextFlyoutElement, Microsoft.Maui.IElement, Microsoft.Maui.IToolTipElement, Microsoft.Maui.IVisualTreeElement
type Element = class
    inherit BindableObject
    interface INameScope
    interface IElementController
    interface IVisualTreeElement
    interface IElement
    interface IEffectControlProvider
    interface IToolTipElement
    interface IContextFlyoutElement
Public MustInherit Class Element
Inherits BindableObject
Implements IContextFlyoutElement, IEffectControlProvider, IElement, IElementController, INameScope, IToolTipElement, IVisualTreeElement
Наследование
Производный
Реализации

Комментарии

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

Класс Описание
VisualElement Объект , Element который занимает область на экране, имеет внешний вид и может получать сенсорный ввод.
Cell Ячейки являются элементами, которые предназначены для добавления в ListView или TableView.
Page Объект , VisualElement который занимает большую или всю часть экрана и содержит один дочерний элемент.
Layout Layoutиметь один дочерний элемент типа View , тогда как подклассы Layout имеют коллекцию из нескольких дочерних представлений, включая другие макеты.
Элементы управления и специализированные ViewВ нижней части схемы показаны классы Microsoft.Maui.Controls для универсальных элементов управления, таких как Button и TableView.

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

Element()

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

Поля

AutomationIdProperty

Привязываемое свойство для AutomationId.

ClassIdProperty

Привязываемое свойство для ClassId.

ControlsElementMapper
Устаревшие..

Сопоставляет сведения о пользовательском интерфейсе с реализациями для конкретных платформ для служб специальных возможностей

Свойства

AutomationId

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

BindingContext

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

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

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

Dispatcher

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

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

Для внутреннего использования .NET MAUI.

Effects

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

Handler

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

Id

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

LogicalChildren
Устаревшие..

Для внутреннего использования платформой Microsoft.Maui.Controls.

Parent

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

RealParent

Для внутреннего использования .NET MAUI.

StyleId

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

Методы

AddLogicalChild(Element)

Добавляет к Element логическим дочерним элементам.

ApplyBindings()

Применяет все текущие привязки к BindingContext.

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

Удаляет все дочерние Elementэлементы.

ClearValue(BindableProperty)

Очищает все значения, ранее заданные для привязываемого свойства.

(Унаследовано от BindableObject)
ClearValue(BindablePropertyKey)

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

(Унаследовано от BindableObject)
CoerceValue(BindableProperty)

Вызывает значение указанного привязываемого свойства. Это делается путем вызова BindableProperty.CoerceValueDelegate указанного привязываемого свойства.

(Унаследовано от BindableObject)
CoerceValue(BindablePropertyKey)

Вызывает значение указанного привязываемого свойства. Это делается путем вызова BindableProperty.CoerceValueDelegate указанного привязываемого свойства.

(Унаследовано от BindableObject)
EffectIsAttached(String)

Для внутреннего использования .NET MAUI.

FindByName(String)

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

GetValue(BindableProperty)

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

(Унаследовано от BindableObject)
InsertLogicalChild(Int32, Element)

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

IsSet(BindableProperty)

Определяет, существует ли привязываемое свойство и имеет ли значение задано.

(Унаследовано от BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)

Сопоставляет абстрактное ExcludedWithChildrenProperty свойство с реализациями, зависящими от платформы.

MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)

Сопоставляет абстрактное IsInAccessibleTreeProperty свойство с реализациями, зависящими от платформы.

OnBindingContextChanged()

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

OnChildAdded(Element)

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

OnChildRemoved(Element, Int32)

Вызывает событие ChildRemoved. Реализация этого метода для добавления обработки классов для этого события

OnHandlerChanged()

При переопределении в производном классе должен вызывать HandlerChanged событие .

OnHandlerChanging(HandlerChangingEventArgs)

При переопределении в производном классе должен вызывать HandlerChanging событие .

OnParentChanged()

При переопределении в производном классе должен вызывать ParentChanged событие .

OnParentChanging(ParentChangingEventArgs)

При переопределении в производном классе должен вызывать ParentChanging событие .

OnParentSet()

Вызывает событие (внутреннее). ParentSet Реализуйте этот метод, чтобы добавить поведение при добавлении элемента в родительский элемент.

OnPropertyChanged(String)

Метод, вызываемый при изменении привязанного свойства.

OnPropertyChanging(String)

Вызывает событие PropertyChanging.

(Унаследовано от BindableObject)
RemoveBinding(BindableProperty)

Удаляет ранее заданную привязку из привязываемого свойства.

(Унаследовано от BindableObject)
RemoveDynamicResource(BindableProperty)

Удаляет ранее заданный динамический ресурс.

RemoveLogicalChild(Element)

Удаляет первое вхождение конкретного Element из логических дочерних элементов.

SetBinding(BindableProperty, BindingBase)

Назначает привязку привязываемому свойству.

(Унаследовано от BindableObject)
SetDynamicResource(BindableProperty, String)

BindableProperty Задает свойство этого элемента для обновления с помощью DynamicResource с помощью предоставленного ключа.

SetValue(BindableProperty, Object)

Задает значение указанного привязываемого свойства.

(Унаследовано от BindableObject)
SetValue(BindablePropertyKey, Object)

Задает значение указанного привязываемого свойства.

(Унаследовано от BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)

Для внутреннего использования платформой Microsoft.Maui.Controls.

(Унаследовано от BindableObject)
SetValueFromRenderer(BindableProperty, Object)

Для внутреннего использования .NET MAUI.

SetValueFromRenderer(BindablePropertyKey, Object)

Для внутреннего использования .NET MAUI.

UnapplyBindings()

Удаляет все текущие привязки из текущего контекста.

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

События

BindingContextChanged

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

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

Возникает при каждом добавлении дочернего элемента в элемент .

ChildRemoved

Возникает при каждом удалении дочернего элемента из элемента .

DescendantAdded

Возникает при каждом добавлении дочернего элемента в поддерево элемента.

DescendantRemoved

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

HandlerChanged

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

HandlerChanging

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

ParentChanged

Возникает при каждом изменении родительского элемента.

ParentChanging

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

PropertyChanged

Возникает при смене значения свойства.

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

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

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

Явные реализации интерфейса

IContextFlyoutElement.ContextFlyout

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

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

(Унаследовано от BindableObject)
IEffectControlProvider.RegisterEffect(Effect)

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

IElement.Parent

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

IElementController.Descendants()

Для внутреннего использования .NET MAUI.

IElementController.LogicalChildren

Для внутреннего использования .NET MAUI.

IElementController.SetValueFromRenderer(BindableProperty, Object)

Для внутреннего использования .NET MAUI.

INameScope.RegisterName(String, Object)

Для внутреннего использования .NET MAUI.

INameScope.UnregisterName(String)

Для внутреннего использования .NET MAUI.

IToolTipElement.ToolTip

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

IVisualTreeElement.GetVisualChildren()

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

IVisualTreeElement.GetVisualParent()

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

Методы расширения

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

SetAppTheme<T>(BindableObject, BindableProperty, T, T)

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

Создает и применяет привязку к свойству.

FindByName<T>(Element, String)

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

ToHandler(IElement, IMauiContext)

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

ToPlatform(IElement, IMauiContext)

Предоставляет базовый класс для всех иерархических элементов Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls.

GetVisualElementWindow(IVisualTreeElement)

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

GetVisualTreeDescendants(IVisualTreeElement)

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

GetVisualTreeElements(IVisualTreeElement, Point)

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

GetVisualTreeElements(IVisualTreeElement, Rect)

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

GetVisualTreeElements(IVisualTreeElement, Double, Double)

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

GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)

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

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