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::IVisualTreeElementpublic 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.IVisualTreeElementtype Element = class
inherit BindableObject
interface INameScope
interface IElementController
interface IVisualTreeElement
interface IElement
interface IEffectControlProvider
interface IToolTipElement
interface IContextFlyoutElementPublic 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 |
Устаревшие..
Сопоставляет сведения о пользовательском интерфейсе с реализацией для конкретных платформ для служб специальных возможностей |
| transientNamescope |
Предоставляет базовый класс для всех элементов иерархии Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls. |
Свойства
| AutomationId |
Возвращает или задает значение, которое позволяет платформе автоматизации находить этот элемент и взаимодействовать с ним. |
| BindingContext |
Возвращает или задает объект, содержащий свойства, предназначенные для связанных свойств, принадлежащих этому BindableObject. Это свойство может быть привязано. (Унаследовано от BindableObject) |
| ClassId |
Возвращает или задает значение, используемое для идентификации коллекции семантически схожих элементов. |
| Dispatcher |
Возвращает диспетчер, который был доступен при создании этого привязываемого объекта, в противном случае пытается найти ближайший доступный диспетчер (вероятно, окно или приложение). (Унаследовано от BindableObject) |
| EffectControlProvider |
Для внутреннего использования .NET MAUI. |
| Effects |
Возвращает или задает стили и свойства, которые будут применяться к элементу во время выполнения. |
| Handler |
Возвращает или задает связанный обработчик для этого элемента. |
| Id |
Получает значение, которое можно использовать для уникальной идентификации элемента во время выполнения приложения. |
| LogicalChildren |
Устаревшие..
Предоставляет базовый класс для всех элементов иерархии Microsoft.Maui.Controls. Этот класс содержит все методы и свойства, необходимые для представления элемента в иерархии Microsoft.Maui.Controls. |
| Parent |
Возвращает или задает родительский элемент Element этого элемента. |
| RealParent |
Для внутреннего использования .NET MAUI. |
| StyleId |
Возвращает или задает определяемое пользователем значение для уникальной идентификации элемента. |
Методы
| AddLogicalChild(Element) |
Добавляет в Element логические дочерние элементы. |
| ApplyBindings() |
Применяет все текущие привязки к BindingContext. (Унаследовано от BindableObject) |
| ClearLogicalChildren() |
Удаляет все дочерние Elements. |
| 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() |
Вызывает событие (внутреннее). |
| 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) |
| 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) |
Регистрирует указанный |
| 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) |
Создает и применяет привязку к свойству. |
| SetBinding<TSource,TProperty>(BindableObject, BindableProperty, Func<TSource,TProperty>, BindingMode, IValueConverter, Object, String, Object, Object, Object) |
Создает привязку между свойством исходного объекта и свойством целевого объекта. |
| 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, Double, Double) |
Возвращает список дочерних элементов визуального дерева на основе прямоугольника, определенного его координатами, указанными в единицах платформы, а не пикселями. |
| GetVisualTreeElements(IVisualTreeElement, Double, Double) |
Возвращает список дочерних элементов визуального дерева, основанных на заданной точке x, y. |
