Element Klasse

Definition

Namespace:

Microsoft.Maui.Controls

Assembly:

Microsoft.Maui.Controls.dll

Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.

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

Vererbung

Object

BindableObject

Element

Abgeleitet

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

Implementiert

IEffectControlProvider IElementController INameScope IContextFlyoutElement IElement IToolTipElement IVisualTreeElement

Hinweise

Wichtige Kategorien visueller Elemente sind in der folgenden Tabelle aufgeführt:

Klasse	BESCHREIBUNG
VisualElement	Eine Element , die einen Bereich auf dem Bildschirm einnimmt, eine visuelle Darstellung aufweist und Toucheingaben erhalten kann.
Cell	Zellen sind Elemente, die ListView oder TableView hinzugefügt werden sollen.
Page	Eine VisualElement , die den großteils oder den gesamten Bildschirm einnimmt und ein einzelnes untergeordnetes Element enthält.
Layout	LayoutSie verfügen über ein einzelnes untergeordnetes Element des-Typs View , während Unterklassen von Layout eine Auflistung mehrerer untergeordneter Sichten aufweisen, einschließlich anderer Layouts.
Steuerelemente und spezialisierte View	Der untere Teil des Diagramms zeigt die Microsoft.Maui.Controls-Klassen für universell verfügbare Steuerelemente, z Button . B. und TableView.

Konstruktoren

Element()

Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.

Felder

AutomationIdProperty	Bindable-Eigenschaft für AutomationId.
ClassIdProperty	Bindable-Eigenschaft für ClassId.
ControlsElementMapper	Veraltet. Zuordnen von Benutzeroberflächeninformationen zu plattformspezifischen Implementierungen für Barrierefreiheitsdienste

Eigenschaften

AutomationId	Ruft einen Wert ab, mit dem das Automatisierungsframework das Element finden und damit interagieren kann.
BindingContext	Ruft ein -Objekt ab, das die Eigenschaften enthält, die von den gebundenen Eigenschaften, die zu diesem gehören, anvisiert werden, oder legt es BindableObjectfest. Dies ist eine bindbare Eigenschaft. (Geerbt von BindableObject)
ClassId	Ruft einen Wert ab, mit dem eine Sammlung von semantisch ähnlichen Elementen identifiziert wird, bzw. legt diesen fest.
Dispatcher	Ruft den Verteiler ab, der verfügbar war, als dieses bindbare Objekt erstellt wurde, andernfalls versucht, den nächstgelegenen verfügbaren Verteiler (wahrscheinlich die des Fensters/der App) zu finden. (Geerbt von BindableObject)
EffectControlProvider	Zur internen Verwendung durch .NET MAUI.
Effects	Ruft die Stile und Eigenschaften ab, die während der Laufzeit auf das Element angewendet werden, oder legt diese fest.
Handler	Ruft den zugeordneten Handler für dieses Element ab oder legt diesen fest.
Id	Ruft einen Wert ab, der verwendet werden kann, um ein Element während der gesamten Ausführung Ihrer Anwendung eindeutig zu identifizieren.
LogicalChildren	Veraltet. Zur internen Verwendung durch die Microsoft.Maui.Controls-Plattform.
Parent	Ruft das übergeordnete Element Element ab oder legt es fest.
RealParent	Zur internen Verwendung durch .NET MAUI.
StyleId	Ruft einen benutzerdefinierten Wert ab, mit dem das Element eindeutig identifiziert wird, bzw. legt diesen fest.

Methoden

AddLogicalChild(Element)	Fügt den logischen untergeordneten Elementen eine hinzu Element .
ApplyBindings()	Wendet alle aktuellen Bindungen auf an BindingContext. (Geerbt von BindableObject)
ClearLogicalChildren()	Entfernt alle untergeordneten Elements.
ClearValue(BindableProperty)	Löscht alle Werte, die zuvor für eine bindungsfähige Eigenschaft festgelegt wurden. (Geerbt von BindableObject)
ClearValue(BindablePropertyKey)	Löscht jeden Wert, der zuvor für eine bindungsfähige Eigenschaft festgelegt wurde, die durch ihren Schlüssel identifiziert wurde. (Geerbt von BindableObject)
CoerceValue(BindableProperty)	Bindet den Wert der angegebenen bindbaren Eigenschaft. Dies erfolgt durch Aufrufen BindableProperty.CoerceValueDelegate der angegebenen bindbaren Eigenschaft. (Geerbt von BindableObject)
CoerceValue(BindablePropertyKey)	Bindet den Wert der angegebenen bindbaren Eigenschaft. Dies erfolgt durch Aufrufen BindableProperty.CoerceValueDelegate der angegebenen bindbaren Eigenschaft. (Geerbt von BindableObject)
EffectIsAttached(String)	Zur internen Verwendung durch .NET MAUI.
FindByName(String)	Gibt das Element mit dem angegebenen Namen zurück.
GetValue(BindableProperty)	Gibt den Wert zurück, der in der angegebenen bindbaren Eigenschaft enthalten ist. (Geerbt von BindableObject)
InsertLogicalChild(Int32, Element)	Fügt einen Element in die logischen untergeordneten Elemente am angegebenen Index ein.
IsSet(BindableProperty)	Bestimmt, ob eine bindungsfähige Eigenschaft vorhanden ist und über einen Wert festgelegt ist. (Geerbt von BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)	Ordnet die abstrakte ExcludedWithChildrenProperty Eigenschaft den plattformspezifischen Implementierungen zu.
MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)	Ordnet die abstrakte IsInAccessibleTreeProperty Eigenschaft den plattformspezifischen Implementierungen zu.
OnBindingContextChanged()	Wird immer dann aufgerufen, wenn der Bindungskontext des Elements geändert wird. Implementieren Sie diese Methode, um eine Klassenbehandlung für dieses Ereignis hinzuzufügen.
OnChildAdded(Element)	Löst das ChildAdded-Ereignis aus. Implementieren Sie diese Methode, um eine Klassenbehandlung für dieses Ereignis hinzuzufügen.
OnChildRemoved(Element, Int32)	Löst das ChildRemoved-Ereignis aus. Implementieren Sie diese Methode, um die Klassenbehandlung für dieses Ereignis hinzuzufügen.
OnHandlerChanged()	Beim Überschreiben in einer abgeleiteten Klasse sollte das HandlerChanged Ereignis ausgelöst werden.
OnHandlerChanging(HandlerChangingEventArgs)	Beim Überschreiben in einer abgeleiteten Klasse sollte das HandlerChanging Ereignis ausgelöst werden.
OnParentChanged()	Beim Überschreiben in einer abgeleiteten Klasse sollte das ParentChanged Ereignis ausgelöst werden.
OnParentChanging(ParentChangingEventArgs)	Beim Überschreiben in einer abgeleiteten Klasse sollte das ParentChanging Ereignis ausgelöst werden.
OnParentSet()	Löst das (interne) ParentSet Ereignis aus. Implementiert diese Methode, um Verhalten hinzuzufügen, wenn das Element einem übergeordneten Element hinzugefügt wird.
OnPropertyChanged(String)	Die Methode, die aufgerufen wird, wenn eine gebundene Eigenschaft geändert wird.
OnPropertyChanging(String)	Löst das PropertyChanging-Ereignis aus. (Geerbt von BindableObject)
RemoveBinding(BindableProperty)	Entfernt eine zuvor festgelegte Bindung aus einer bindbaren Eigenschaft. (Geerbt von BindableObject)
RemoveDynamicResource(BindableProperty)	Entfernt eine zuvor festgelegte dynamische Ressource.
RemoveLogicalChild(Element)	Entfernt das erste Vorkommen eines bestimmten aus den logischen untergeordneten Element Elementen.
SetBinding(BindableProperty, BindingBase)	Weist einer bindungsfähigen Eigenschaft eine Bindung zu. (Geerbt von BindableObject)
SetDynamicResource(BindableProperty, String)	Legt die BindableProperty Eigenschaft dieses Elements fest, die über DynamicResource mit dem angegebenen Schlüssel aktualisiert werden soll.
SetValue(BindableProperty, Object)	Legt den Wert der angegebenen bindbaren Eigenschaft fest. (Geerbt von BindableObject)
SetValue(BindablePropertyKey, Object)	Legt den Wert der angegebenen bindbaren Eigenschaft fest. (Geerbt von BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)	Zur internen Verwendung durch die Microsoft.Maui.Controls-Plattform. (Geerbt von BindableObject)
SetValueFromRenderer(BindableProperty, Object)	Zur internen Verwendung durch .NET MAUI.
SetValueFromRenderer(BindablePropertyKey, Object)	Zur internen Verwendung durch .NET MAUI.
UnapplyBindings()	Entfernt alle aktuellen Bindungen aus dem aktuellen Kontext. (Geerbt von BindableObject)

Ereignisse

BindingContextChanged	Tritt auf, wenn sich der Wert der BindingContext-Eigenschaft ändert. (Geerbt von BindableObject)
ChildAdded	Wird ausgelöst, wenn dem Element ein untergeordnetes Element hinzugefügt wird.
ChildRemoved	Wird ausgelöst, wenn ein untergeordnetes Element aus dem Element entfernt wird.
DescendantAdded	Wird ausgelöst, wenn der Unterstruktur des Elements ein untergeordnetes Element hinzugefügt wird.
DescendantRemoved	Wird ausgelöst, wenn ein untergeordnetes Element aus der Elementunterstruktur entfernt wird.
HandlerChanged	Wird ausgelöst, wenn sich der Handler des Elements geändert hat.
HandlerChanging	Wird immer dann ausgelöst, wenn sich der Handler des Elements zu ändern beginnt.
ParentChanged	Wird immer dann ausgelöst, wenn sich das übergeordnete Element geändert hat.
ParentChanging	Wird immer dann ausgelöst, wenn sich das Element zu ändern beginnt.
PropertyChanged	Tritt ein, wenn sich ein Eigenschaftswert ändert. (Geerbt von BindableObject)
PropertyChanging	Tritt ein, wenn ein Eigenschaftswert geändert wird. (Geerbt von BindableObject)

Explizite Schnittstellenimplementierungen

IContextFlyoutElement.ContextFlyout	Ruft die ContextFlyout für die Ansicht ab. Menü-Flyouts, Menü-Flyout-Unterelemente und Menü-Flyouttrennzeichen können dem Kontext-Flyout hinzugefügt werden.
IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)	Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind. (Geerbt von BindableObject)
IEffectControlProvider.RegisterEffect(Effect)	Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.
IElement.Parent	Ruft das übergeordnete Element ab.
IElementController.Descendants()	Zur internen Verwendung durch .NET MAUI.
IElementController.LogicalChildren	Zur internen Verwendung durch .NET MAUI.
IElementController.SetValueFromRenderer(BindableProperty, Object)	Zur internen Verwendung durch .NET MAUI.
INameScope.RegisterName(String, Object)	Zur internen Verwendung durch .NET MAUI.
INameScope.UnregisterName(String)	Zur internen Verwendung durch .NET MAUI.
IToolTipElement.ToolTip	Stellt ein kleines rechteckiges Popupfenster dar, in dem eine kurze Beschreibung des Zwecks einer Ansicht angezeigt wird, wenn der Benutzer den Zeiger auf die Ansicht aufgibt.
IVisualTreeElement.GetVisualChildren()	Ruft eine schreibgeschützte Liste der visuellen untergeordneten Elemente des Elements ab.
IVisualTreeElement.GetVisualParent()	Ruft das visuelle übergeordnete Element ab.

Erweiterungsmethoden

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)	Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.
SetAppTheme<T>(BindableObject, BindableProperty, T, T)	Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)	Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)	Erstellt eine Bindung mit einer Eigenschaft und wendet diese an.
FindByName<T>(Element, String)	Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.
ToHandler(IElement, IMauiContext)	Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.
ToPlatform(IElement, IMauiContext)	Stellt die Basisklasse für alle hierarchischen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Microsoft.Maui.Controls-Hierarchie erforderlich sind.
GetVisualElementWindow(IVisualTreeElement)	Ruft das Fenster ab, das das Visual Tree-Element enthält, wenn das Element in einem element enthalten ist.
GetVisualTreeDescendants(IVisualTreeElement)	Ruft die gesamte Hierarchie der nachkommenden Elemente als Liste von untergeordneten Elementen für ein bestimmtes visuelles Strukturelement ab.
GetVisualTreeElements(IVisualTreeElement, Point)	Ruft die Liste der untergeordneten Elemente eines Visuellen Baumelements basierend auf einem bestimmten Punkt ab.
GetVisualTreeElements(IVisualTreeElement, Rect)	Ruft eine Liste mit untergeordneten Visual Tree Elements basierend auf einem Rechteck ab.
GetVisualTreeElements(IVisualTreeElement, Double, Double)	Ruft eine Liste mit untergeordneten Visual Tree Elements basierend auf einem bestimmten x- und y-Punkt ab.
GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)	Ruft eine Liste von untergeordneten Visual Tree Elements basierend auf einem Rechteck ab, das durch seine Koordinaten definiert ist, die in Plattformeinheiten und nicht in Pixeln angegeben sind.