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() |
Вызывает событие (внутреннее). |
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) |
Возвращает список дочерних элементов визуального дерева на основе прямоугольника, определенного его координатами, которые указываются в единицах платформы, а не в пикселях. |
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по