Element 類別

定義

提供所有 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
繼承
衍生
實作

備註

下表注明視覺元素的重要類別:

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

建構函式

Element()

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

欄位

AutomationIdProperty

AutomationId 欄位的備份存放區。

ClassIdProperty

識別 ClassId 可繫結屬性。

MenuProperty

附加功能表屬性的備份存放區。

屬性

AutomationId

取得或設定值,允許自動化架構尋找此項目並與之互動。

BindingContext

取得或設定物件,這個物件包含屬於此 BindableObject 屬性繫結屬性將設為目標的屬性。

(繼承來源 BindableObject)
ClassId

取得或設定值,用來識別語意類似項目的集合。

Dispatcher (繼承來源 BindableObject)
EffectControlProvider

供 Xamarin.Forms 平台內部使用。

Effects

套用至此項目的效果清單。

Id

取得值,可用來在應用程式執行期間唯一識別項目。

LogicalChildren

供 Xamarin.Forms 平台內部使用。

Parent

取得或設定項目的父項目。

ParentView
已過時。

取得即此項目最接近上階的項目,而此項目是 VisualElement

Platform
RealParent

供 Xamarin.Forms 平台內部使用。

StyleId

取得或設定使用者定義值來唯一識別項目。

方法

ApplyBindings()

將繫結套用至 BindingContext

(繼承來源 BindableObject)
ClearValue(BindableProperty)

清除 SetValue 針對 property 所設定的任何值。

(繼承來源 BindableObject)
ClearValue(BindablePropertyKey)

清除 SetValue 針對 propertyKey 所識別屬性設定的任何值。

(繼承來源 BindableObject)
CoerceValue(BindableProperty) (繼承來源 BindableObject)
CoerceValue(BindablePropertyKey) (繼承來源 BindableObject)
Descendants()

供 Xamarin.Forms 平台內部使用。

EffectIsAttached(String)

供 Xamarin.Forms 平台內部使用。

FindByName(String)

傳回具有指定名稱的元素。

GetMenu(BindableObject)

取得 bindableMenu 物件。

GetValue(BindableProperty)

傳回 BindableProperty 中包含的值。

(繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty)
已過時。

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty, BindableProperty)
已過時。

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
IsSet(BindableProperty)

如果目標屬性存在且已設定,則傳回 true

(繼承來源 BindableObject)
OnBindingContextChanged()

只要項目的繫結內容變更時就叫用。 實作這個方法可為此事件加入類別處理。

OnChildAdded(Element)

只要需要發出 ChildAdded 事件時即叫用。 實作這個方法可為此事件加入類別處理。

OnChildRemoved(Element)
已過時。

只要需要發出 ChildRemoved 事件時即叫用。 實作這個方法可為此事件加入類別處理。

OnChildRemoved(Element, Int32)
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
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)
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

建立並將繫結套用至屬性。

SetBinding<TSource>(BindableObject, BindableProperty, Expression<Func<TSource,Object>>, BindingMode, IValueConverter, String)
已過時。

從運算式建立及套用繫結。

SetOnAppTheme<T>(BindableObject, BindableProperty, T, T)
FindByName<T>(Element, String)

傳回包含 element 之範圍中具有 name 名稱的 T 類型執行個體。

適用於