通过

Element 类

  • 参考

定义

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

为所有 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占据大部分或全部屏幕并包含单个子元素的 A。
Layout Layout 具有类型的 View单个子类，而子类 Layout 具有多个子视图的集合，包括其他布局。
控件和专用 View关系图的下半部分显示了适用于通用控件（如 Button 和 TableView）的 Microsoft.Maui.Controls 类。

构造函数

Element()

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

字段

AutomationIdProperty

的可绑定属性 AutomationId。
ClassIdProperty

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

将 UI 信息映射到辅助功能服务特定于平台的实现
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()

删除所有子项 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)
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)

注册此元素的指定 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 点的可视化树元素子项的列表。

适用于