Element Kelas

Definisi

Ruang nama:

Microsoft.Maui.Controls

Rakitan:

Microsoft.Maui.Controls.dll

Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki 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

Warisan

Object

BindableObject

Element

Turunan

Microsoft.Maui.Controls.Application

Microsoft.Maui.Controls.AppLinkEntry

Microsoft.Maui.Controls.BaseMenuItem

Microsoft.Maui.Controls.Brush

Microsoft.Maui.Controls.Cell

Microsoft.Maui.Controls.FlyoutBase

Microsoft.Maui.Controls.FormattedString

Microsoft.Maui.Controls.GestureElement

Microsoft.Maui.Controls.GestureRecognizer

Microsoft.Maui.Controls.GradientStop

Microsoft.Maui.Controls.ImageSource

Microsoft.Maui.Controls.Maps.MapElement

Microsoft.Maui.Controls.Maps.Pin

Microsoft.Maui.Controls.MenuBar

Microsoft.Maui.Controls.NavigableElement

Microsoft.Maui.Controls.Shadow

Microsoft.Maui.Controls.SwipeItems

Penerapan

IEffectControlProvider IElementController INameScope IContextFlyoutElement IElement IToolTipElement IVisualTreeElement

Keterangan

Kategori penting elemen visual dicatat dalam tabel berikut:

Kelas	Deskripsi
VisualElement	Yang Element menempati area di layar, memiliki tampilan visual, dan dapat memperoleh input sentuhan.
Cell	Sel adalah elemen yang dimaksudkan untuk ditambahkan ke ListView atau TableView.
Page	Yang VisualElement menempati sebagian besar atau semua layar dan berisi satu anak.
Layout	Layoutmemiliki satu anak berjenis ViewLayout , sementara subkelas memiliki kumpulan beberapa tampilan anak, termasuk tata letak lainnya.
Kontrol dan khusus View	Bagian bawah diagram menunjukkan kelas Microsoft.Maui.Controls untuk kontrol yang tersedia secara universal, seperti Button dan TableView.

Konstruktor

Element()

Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls.

Bidang

AutomationIdProperty	Properti yang dapat diikat untuk AutomationId.
ClassIdProperty	Properti yang dapat diikat untuk ClassId.
ControlsElementMapper	Kedaluwarsa. Memetakan informasi UI ke implementasi khusus platform untuk layanan aksesibilitas

Properti

AutomationId	Mendapatkan atau menetapkan nilai yang memungkinkan kerangka kerja otomatisasi untuk menemukan dan berinteraksi dengan elemen ini.
BindingContext	Mendapatkan atau mengatur objek yang berisi properti yang akan ditargetkan oleh properti terikat milik ini BindableObject. Ini adalah properti yang dapat diikat. (Diperoleh dari BindableObject)
ClassId	Mendapatkan atau menetapkan nilai yang digunakan untuk mengidentifikasi kumpulan elemen serupa secara semantik.
Dispatcher	Mendapatkan dispatcher yang tersedia ketika objek yang dapat diikat ini dibuat, jika tidak, mencoba menemukan dispatcher terdekat yang tersedia (mungkin jendela/aplikasi). (Diperoleh dari BindableObject)
EffectControlProvider	Untuk penggunaan internal oleh .NET MAUI.
Effects	Mendapatkan atau mengatur gaya dan properti yang akan diterapkan ke elemen selama runtime.
Handler	Mendapatkan atau mengatur handler terkait untuk elemen ini.
Id	Mendapatkan nilai yang dapat digunakan untuk mengidentifikasi elemen secara unik selama menjalankan aplikasi Anda.
LogicalChildren	Kedaluwarsa. Untuk penggunaan internal oleh platform Microsoft.Maui.Controls.
Parent	Mendapatkan atau mengatur induk Element elemen ini.
RealParent	Untuk penggunaan internal oleh .NET MAUI.
StyleId	Mendapatkan atau menetapkan nilai yang ditentukan pengguna untuk mengidentifikasi elemen secara unik.

Metode

AddLogicalChild(Element)	Element Menambahkan ke anak-anak logis.
ApplyBindings()	Menerapkan semua pengikatan saat ini ke BindingContext. (Diperoleh dari BindableObject)
ClearLogicalChildren()	Menghapus semua anak Element.
ClearValue(BindableProperty)	Menghapus nilai apa pun yang sebelumnya ditetapkan untuk properti yang dapat diikat. (Diperoleh dari BindableObject)
ClearValue(BindablePropertyKey)	Menghapus nilai apa pun yang sebelumnya ditetapkan untuk properti yang dapat diikat, yang diidentifikasi oleh kuncinya. (Diperoleh dari BindableObject)
CoerceValue(BindableProperty)	Memaksakan nilai properti yang dapat diikat yang ditentukan. Ini dilakukan dengan memanggil BindableProperty.CoerceValueDelegate properti yang dapat diikat yang ditentukan. (Diperoleh dari BindableObject)
CoerceValue(BindablePropertyKey)	Memaksakan nilai properti yang dapat diikat yang ditentukan. Ini dilakukan dengan memanggil BindableProperty.CoerceValueDelegate properti yang dapat diikat yang ditentukan. (Diperoleh dari BindableObject)
EffectIsAttached(String)	Untuk penggunaan internal oleh .NET MAUI.
FindByName(String)	Mengembalikan elemen yang memiliki nama yang ditentukan.
GetValue(BindableProperty)	Mengembalikan nilai yang terkandung dalam properti yang dapat diikat yang diberikan. (Diperoleh dari BindableObject)
InsertLogicalChild(Int32, Element)	Element Menyisipkan ke turunan logika pada indeks yang ditentukan.
IsSet(BindableProperty)	Menentukan apakah properti yang dapat diikat ada atau tidak dan memiliki set nilai. (Diperoleh dari BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)	Memetakan properti abstrak ExcludedWithChildrenProperty ke implementasi khusus platform.
MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)	Memetakan properti abstrak IsInAccessibleTreeProperty ke implementasi khusus platform.
OnBindingContextChanged()	Dipanggil setiap kali konteks pengikatan elemen berubah. Terapkan metode ini untuk menambahkan penanganan kelas untuk peristiwa ini.
OnChildAdded(Element)	Memunculkan kejadian ChildAdded. Terapkan metode ini untuk menambahkan penanganan kelas untuk peristiwa ini.
OnChildRemoved(Element, Int32)	Memunculkan kejadian ChildRemoved. Terapkan metode ini untuk menambahkan penanganan kelas untuk kejadian ini
OnHandlerChanged()	Ketika ditimpa di kelas turunan, harus menaikkan HandlerChanged acara.
OnHandlerChanging(HandlerChangingEventArgs)	Ketika ditimpa di kelas turunan, harus menaikkan HandlerChanging acara.
OnParentChanged()	Ketika ditimpa di kelas turunan, harus menaikkan ParentChanged acara.
OnParentChanging(ParentChangingEventArgs)	Ketika ditimpa di kelas turunan, harus menaikkan ParentChanging acara.
OnParentSet()	Menaikkan peristiwa (internal). ParentSet Terapkan metode ini untuk menambahkan perilaku saat elemen ditambahkan ke induk.
OnPropertyChanged(String)	Metode yang dipanggil ketika properti terikat diubah.
OnPropertyChanging(String)	Memunculkan kejadian PropertyChanging. (Diperoleh dari BindableObject)
RemoveBinding(BindableProperty)	Menghapus pengikatan yang diatur sebelumnya dari properti yang dapat diikat. (Diperoleh dari BindableObject)
RemoveDynamicResource(BindableProperty)	Menghapus sumber daya dinamis yang ditetapkan sebelumnya.
RemoveLogicalChild(Element)	Menghapus kemunculan pertama tertentu Element dari turunan logis.
SetBinding(BindableProperty, BindingBase)	Menetapkan pengikatan ke properti yang dapat diikat. (Diperoleh dari BindableObject)
SetDynamicResource(BindableProperty, String)	BindableProperty Mengatur properti elemen ini untuk diperbarui melalui DynamicResource dengan kunci yang disediakan.
SetValue(BindableProperty, Object)	Mengatur nilai properti yang dapat diikat yang ditentukan. (Diperoleh dari BindableObject)
SetValue(BindablePropertyKey, Object)	Mengatur nilai properti yang dapat diikat yang ditentukan. (Diperoleh dari BindableObject)
SetValueFromRenderer(BindableProperty, Object)	Untuk penggunaan internal oleh .NET MAUI.
SetValueFromRenderer(BindablePropertyKey, Object)	Untuk penggunaan internal oleh .NET MAUI.
UnapplyBindings()	Menghapus semua pengikatan saat ini dari konteks saat ini. (Diperoleh dari BindableObject)

Acara

BindingContextChanged	Terjadi ketika nilai BindingContext properti berubah. (Diperoleh dari BindableObject)
ChildAdded	Dimunculkan setiap kali elemen anak ditambahkan ke elemen .
ChildRemoved	Dimunculkan setiap kali elemen turunan dihapus dari elemen .
DescendantAdded	Dimunculkan setiap kali elemen anak ditambahkan ke subtree elemen.
DescendantRemoved	Dimunculkan setiap kali elemen anak dihapus dari subtree elemen.
HandlerChanged	Dimunculkan setiap kali handler elemen berubah.
HandlerChanging	Dimunculkan setiap kali handler elemen mulai berubah.
ParentChanged	Dimunculkan setiap kali induk elemen telah berubah.
ParentChanging	Dimunculkan setiap kali elemen mulai berubah.
PropertyChanged	Terjadi saat nilai properti berubah. (Diperoleh dari BindableObject)
PropertyChanging	Terjadi ketika nilai properti berubah. (Diperoleh dari BindableObject)

Implementasi Antarmuka Eksplisit

IContextFlyoutElement.ContextFlyout	ContextFlyout Mendapatkan untuk tampilan. Flyout menu, subitem flyout menu, dan pemisah flyout menu dapat ditambahkan ke flyout konteks.
IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)	Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls. (Diperoleh dari BindableObject)
IEffectControlProvider.RegisterEffect(Effect)	Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls.
IElement.Parent	Mendapatkan Induk Elemen.
IElementController.Descendants()	Untuk penggunaan internal oleh .NET MAUI.
IElementController.LogicalChildren	Untuk penggunaan internal oleh .NET MAUI.
IElementController.SetValueFromRenderer(BindableProperty, Object)	Untuk penggunaan internal oleh .NET MAUI.
INameScope.RegisterName(String, Object)	Untuk penggunaan internal oleh .NET MAUI.
INameScope.UnregisterName(String)	Untuk penggunaan internal oleh .NET MAUI.
IToolTipElement.ToolTip	Mewakili jendela pop-up persegi kecil yang menampilkan deskripsi singkat tentang tujuan tampilan saat pengguna mengarahkan penunjuk pada tampilan.
IVisualTreeElement.GetVisualChildren()	Mendapatkan daftar readonly dari anak-anak visual elemen.
IVisualTreeElement.GetVisualParent()	Mendapatkan induk visual elemen.

Metode Ekstensi

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)	Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls.
SetAppTheme<T>(BindableObject, BindableProperty, T, T)	Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls.
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)	Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls.
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)	Membuat dan menerapkan pengikatan ke properti.
FindByName<T>(Element, String)	Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls.
ToHandler(IElement, IMauiContext)	Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls.
ToPlatform(IElement, IMauiContext)	Menyediakan kelas dasar untuk semua elemen hierarki Microsoft.Maui.Controls. Kelas ini berisi semua metode dan properti yang diperlukan untuk mewakili elemen dalam hierarki Microsoft.Maui.Controls.
GetVisualElementWindow(IVisualTreeElement)	Mendapatkan Jendela yang berisi Elemen Visual Tree, jika elemen terkandung dalam satu.
GetVisualTreeDescendants(IVisualTreeElement)	Mendapatkan seluruh hierarki turunan sebagai daftar anak untuk Elemen Visual Tree tertentu.
GetVisualTreeElements(IVisualTreeElement, Point)	Mendapatkan daftar turunan Visual Tree Element berdasarkan Titik tertentu.
GetVisualTreeElements(IVisualTreeElement, Rect)	Mendapatkan daftar turunan Elemen Pohon Visual berdasarkan persegi panjang.
GetVisualTreeElements(IVisualTreeElement, Double, Double)	Mendapatkan daftar turunan Elemen Pohon Visual berdasarkan titik x, y tertentu.
GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)	Mendapatkan daftar turunan Elemen Pohon Visual berdasarkan persegi panjang yang ditentukan oleh koordinatnya yang ditentukan dalam unit platform, bukan piksel.