Element 類別

定義

命名空間:

Xamarin.Forms

組件:

Xamarin.Forms.Core.dll

提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。

public abstract class Element : Xamarin.Forms.BindableObject, Xamarin.Forms.IElementController, Xamarin.Forms.Internals.INameScope

type Element = class
    inherit BindableObject
    interface INameScope
    interface IElementController

繼承

System.Object

BindableObject

Element

衍生

Xamarin.Forms.Application

Xamarin.Forms.AppLinkEntry

Xamarin.Forms.BaseMenuItem

Xamarin.Forms.Cell

Xamarin.Forms.FormattedString

Xamarin.Forms.GestureElement

Xamarin.Forms.GestureRecognizer

Xamarin.Forms.ImageSource

Xamarin.Forms.Maps.MapElement

Xamarin.Forms.Maps.Pin

Xamarin.Forms.NavigableElement

Xamarin.Forms.SwipeItems

實作

IElementController INameScope

備註

下表會說明視覺元素的重要類別：

類別	描述
VisualElement	佔用畫面區域的 Element 具有視覺外觀，而且可以取得觸控輸入。
Cell	儲存格都是要新增至 ListView 或 TableView 的項目。
Page	VisualElement佔用大部分或全部螢幕且包含單一子系的 。
Layout	Layout具有類型的單一子系 View ，而的子類別 Layout<T> 具有多個子系視圖的集合，包括其他版面配置。
控件和特製化View	圖表的下半部會顯示 Xamarin。Forms 通用控件的類別，例如 Buttons 和 TableViews。

建構函式

Element()

用來初始化項目的受保護建構函式。

欄位

AutomationIdProperty	AutomationId 欄位的備份存放區。
ClassIdProperty	識別 ClassId 可繫結屬性。
MenuProperty	附加功能表屬性的備份存放區。

屬性

AutomationId	取得或設定值，允許自動化架構尋找此項目並與之互動。
BindingContext	取得或設定物件，這個物件包含屬於此 BindableObject 屬性繫結屬性將設為目標的屬性。 (繼承來源 BindableObject)
ClassId	取得或設定值，用來識別語意類似項目的集合。
Dispatcher	提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。 (繼承來源 BindableObject)
EffectControlProvider	供 Xamarin.Forms 平台內部使用。
Effects	套用至此項目的效果清單。
Id	取得值，可用來在應用程式執行期間唯一識別項目。
LogicalChildren	供 Xamarin.Forms 平台內部使用。
Parent	取得或設定項目的父項目。
ParentView	已淘汰. 取得即此項目最接近上階的項目，而此項目是 VisualElement。
Platform	已淘汰. 提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。
RealParent	供 Xamarin.Forms 平台內部使用。
StyleId	取得或設定使用者定義值來唯一識別項目。

方法

ApplyBindings()	將繫結套用至 BindingContext。 (繼承來源 BindableObject)
ClearValue(BindableProperty)	清除 SetValue 針對 property 所設定的任何值。 (繼承來源 BindableObject)
ClearValue(BindablePropertyKey)	清除 SetValue 針對 propertyKey 所識別屬性設定的任何值。 (繼承來源 BindableObject)
CoerceValue(BindableProperty)	提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。 (繼承來源 BindableObject)
CoerceValue(BindablePropertyKey)	提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。 (繼承來源 BindableObject)
Descendants()	供 Xamarin.Forms 平台內部使用。
EffectIsAttached(String)	供 Xamarin.Forms 平台內部使用。
FindByName(String)	傳回具有指定名稱的元素。
GetMenu(BindableObject)	取得 bindable 的 Menu 物件。
GetValue(BindableProperty)	傳回 BindableProperty 中包含的值。 (繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty, BindableProperty)	已淘汰. 供 Xamarin.Forms 平台內部使用。 (繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty)	已淘汰. 供 Xamarin.Forms 平台內部使用。 (繼承來源 BindableObject)
IsSet(BindableProperty)	如果目標屬性存在且已設定，則傳回 true。 (繼承來源 BindableObject)
OnBindingContextChanged()	只要項目的繫結內容變更時就叫用。 實作這個方法可為此事件加入類別處理。
OnChildAdded(Element)	只要需要發出 ChildAdded 事件時即叫用。 實作這個方法可為此事件加入類別處理。
OnChildRemoved(Element, Int32)	提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。
OnChildRemoved(Element)	已淘汰. 只要需要發出 ChildRemoved 事件時即叫用。 實作這個方法可為此事件加入類別處理。
OnParentSet()	每當設定項目的父系時叫用。 實作這個方法，以便在項目新增至父系時新增行為。
OnPropertyChanged(String)	繫結屬性變更時呼叫的方法。
OnPropertyChanging(String)	從子類別呼叫這個方法，以通知屬性即將發生變更。 (繼承來源 BindableObject)
RemoveBinding(BindableProperty)	移除先前設定的繫結。 (繼承來源 BindableObject)
RemoveDynamicResource(BindableProperty)	移除先前設定的動態資源
SetBinding(BindableProperty, BindingBase)	將繫結指派給屬性。 (繼承來源 BindableObject)
SetDynamicResource(BindableProperty, String)	透過具有所提供索引鍵的 DynamicResource，設定更新此項目的 BindableProperty 屬性。
SetMenu(BindableObject, Menu)	設定 bindable 的功能表。
SetValue(BindableProperty, Object)	設定指定之屬性的值。 (繼承來源 BindableObject)
SetValue(BindablePropertyKey, Object)	設定 propertyKey 的值。 (繼承來源 BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)	供 Xamarin.Forms 平台內部使用。 (繼承來源 BindableObject)
SetValueFromRenderer(BindableProperty, Object)	供 Xamarin.Forms 平台內部使用。
SetValueFromRenderer(BindablePropertyKey, Object)	供 Xamarin.Forms 平台內部使用。
UnapplyBindings()	取消套用所有先前設定的繫結。 (繼承來源 BindableObject)

事件

BindingContextChanged	每當 BindingContext 屬性變更時引發。 (繼承來源 BindableObject)
ChildAdded	只要將子項目新增至項目時就發生。
ChildRemoved	只要從項目移除子項目時就發生。
DescendantAdded	只要將子項目新增至項目樹狀子目錄時即發生。
DescendantRemoved	只要從項目樹狀子目錄移除子項目時即發生。
PlatformSet	已淘汰. 提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。
PropertyChanged	在屬性變更時引發。 (繼承來源 BindableObject)
PropertyChanging	在屬性即將變更時引發。 (繼承來源 BindableObject)

明確介面實作

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)	供 Xamarin.Forms 平台內部使用。 (繼承來源 BindableObject)
IElementController.SetValueFromRenderer(BindableProperty, Object)	供 Xamarin.Forms 平台內部使用。
INameScope.RegisterName(String, Object)	僅供內部使用。

擴充方法

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)	提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)	提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)	建立並將繫結套用至屬性。
SetBinding<TSource>(BindableObject, BindableProperty, Expression<Func<TSource,Object>>, BindingMode, IValueConverter, String)	已淘汰. 從運算式建立及套用繫結。
SetOnAppTheme<T>(BindableObject, BindableProperty, T, T)	提供所有 Xamarin.Forms 階層式項目的基底類別。 此類別包含代表 Xamarin.Forms 階層中項目所需的所有方法和屬性。
FindByName<T>(Element, String)	傳回包含 element 的範圍中具有 name 名稱的 T 類型執行個體。