Element 类

  • 参考

定义

命名空间:
Microsoft.Maui.Controls
程序集:
Microsoft.Maui.Controls.dll

为所有 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
继承
Object
BindableObject
Element
派生
实现
IEffectControlProvider IElementController INameScope IContextFlyoutElement IElement IToolTipElement IVisualTreeElement

注解

下表中记录了视觉元素的重要类别：

类 说明
VisualElement 一个 Element ，它占据屏幕上的一个区域，具有视觉外观，并且可以获取触摸输入。
Cell 单元是要添加到 ListView 或 TableView 的元素。
Page 一个 VisualElement ，它占据屏幕的大部分或全部，并且包含一个子级。
Layout Layout具有一个类型的子类型 View ，而的子类 Layout 具有多个子视图的集合，其中包括其他布局。
控件和专用 View关系图的下半部分显示了适用于通用控件（如 和 TableView）Button的 Microsoft.Maui.Controls 类。

构造函数

Element()

为所有 Microsoft.Maui.Controls 层次结构元素提供基类。 此类包含表示 Microsoft.Maui.Controls 层次结构中的元素所需的所有方法和属性。

字段

AutomationIdProperty

的 AutomationId可绑定属性。
ClassIdProperty

的 ClassId可绑定属性。
ControlsElementMapper
已过时.

将 UI 信息映射到特定于平台的辅助功能服务实现

属性

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)

获取基于由坐标定义的矩形（以平台单位而不是像素指定的）的可视树元素子级的列表。

适用于