Freigeben über


Element Klasse

Definition

Stellt die Basisklasse für alle hierarchalen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Hierarchie "Microsoft.Maui.Controls" 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
Abgeleitet
Implementiert

Hinweise

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

Klasse Beschreibung
VisualElement Ein Element Bereich, der 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 Ein VisualElement Element, das die meisten oder alle Bildschirme einnimmt und ein einzelnes untergeordnetes Element enthält.
Layout Layout ein einzelnes untergeordnetes Element vom Typ Viewaufweisen, während Unterklassen mit Layout einer Sammlung mehrerer untergeordneter Ansichten, einschließlich anderer Layouts, vorhanden sind.
Steuerelemente und spezialisierte ViewDer 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 hierarchalen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Hierarchie "Microsoft.Maui.Controls" erforderlich sind.

Felder

AutomationIdProperty

Bindable-Eigenschaft für AutomationId.

ClassIdProperty

Bindable-Eigenschaft für ClassId.

ControlsElementMapper
Veraltet.

Karten Ui-Informationen zu plattformspezifischen Implementierungen für Barrierefreiheitsdienste

Eigenschaften

AutomationId

Ruft einen Wert ab, mit dem das Automatisierungsframework das Element finden und damit interagieren kann.

BindingContext

Dient zum Abrufen oder Festlegen eines Objekts, das die Eigenschaften enthält, die von den gebundenen Eigenschaften bestimmt werden, die zu diesem BindableObjectGehören. 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 Dispatcher ab, der verfügbar war, als dieses bindbare Objekt erstellt wurde, andernfalls versucht, den nächstgelegenen verfügbaren Verteiler (wahrscheinlich die Fenster/App's) zu finden.

(Geerbt von BindableObject)
EffectControlProvider

Für die interne 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

Dient zum Abrufen oder Festlegen des zugeordneten Handlers für dieses Element.

Id

Ruft einen Wert ab, der verwendet werden kann, um ein Element während der gesamten Ausführung Der Anwendung eindeutig zu identifizieren.

LogicalChildren
Veraltet.

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

Parent

Dient zum Abrufen oder Festlegen des übergeordneten Element Elements dieses Elements.

RealParent

Für die interne 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 ein Element .

ApplyBindings()

Wendet alle aktuellen Bindungen auf BindingContext.

(Geerbt von BindableObject)
ClearLogicalChildren()

Entfernt alle untergeordneten ElementElemente.

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 den Schlüssel identifiziert wird.

(Geerbt von BindableObject)
CoerceValue(BindableProperty)

Wandelt den Wert der angegebenen bindungsfähigen Eigenschaft um. Dies erfolgt durch Aufrufen BindableProperty.CoerceValueDelegate der angegebenen bindungsfähigen Eigenschaft.

(Geerbt von BindableObject)
CoerceValue(BindablePropertyKey)

Wandelt den Wert der angegebenen bindungsfähigen Eigenschaft um. Dies erfolgt durch Aufrufen BindableProperty.CoerceValueDelegate der angegebenen bindungsfähigen Eigenschaft.

(Geerbt von BindableObject)
EffectIsAttached(String)

Für die interne 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 bindungsfähigen Eigenschaft enthalten ist.

(Geerbt von BindableObject)
InsertLogicalChild(Int32, Element)

Fügt an Element die logischen untergeordneten Elemente am angegebenen Index ein.

IsSet(BindableProperty)

Bestimmt, ob eine bindungsfähige Eigenschaft vorhanden ist und einen Wert festgelegt hat.

(Geerbt von BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)

Karten die abstrakte ExcludedWithChildrenProperty Eigenschaft an die plattformspezifischen Implementierungen.

MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)

Karten die abstrakte IsInAccessibleTreeProperty Eigenschaft an die plattformspezifischen Implementierungen.

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()

Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, sollte das HandlerChanged Ereignis ausgelöst werden.

OnHandlerChanging(HandlerChangingEventArgs)

Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, sollte das HandlerChanging Ereignis ausgelöst werden.

OnParentChanged()

Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, sollte das ParentChanged Ereignis ausgelöst werden.

OnParentChanging(ParentChangingEventArgs)

Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, sollte das ParentChanging Ereignis ausgelöst werden.

OnParentSet()

Löst das (interne) Ereignis aus ParentSet . 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 bindungsfähigen Eigenschaft.

(Geerbt von BindableObject)
RemoveDynamicResource(BindableProperty)

Entfernt eine zuvor festgelegte dynamische Ressource.

RemoveLogicalChild(Element)

Entfernt das erste Vorkommen eines bestimmten Element aus den logischen untergeordneten 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 die DynamicResource mit dem bereitgestellten Schlüssel aktualisiert werden soll.

SetValue(BindableProperty, Object)

Legt den Wert der angegebenen bindungsfähigen Eigenschaft fest.

(Geerbt von BindableObject)
SetValue(BindablePropertyKey, Object)

Legt den Wert der angegebenen bindungsfähigen Eigenschaft fest.

(Geerbt von BindableObject)
SetValueFromRenderer(BindableProperty, Object)

Für die interne Verwendung durch .NET MAUI.

SetValueFromRenderer(BindablePropertyKey, Object)

Für die interne 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 ein untergeordnetes Element der Unterstruktur des Elements hinzugefügt wird.

DescendantRemoved

Wird ausgelöst, wenn ein untergeordnetes Element aus der Unterstruktur der Elemente entfernt wird.

HandlerChanged

Wird ausgelöst, wenn sich der Handler des Elements geändert hat.

HandlerChanging

Wird ausgelöst, wenn der Handler des Elements zu ändern beginnt.

ParentChanged

Wird ausgelöst, wenn sich das übergeordnete Element geändert hat.

ParentChanging

Wird immer ausgelöst, wenn das Element zu ändern beginnt.

PropertyChanged

Tritt auf, wenn sich ein Eigenschaftswert ändert.

(Geerbt von BindableObject)
PropertyChanging

Tritt auf, wenn sich ein Eigenschaftswert ändert.

(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 hierarchalen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Hierarchie "Microsoft.Maui.Controls" erforderlich sind.

(Geerbt von BindableObject)
IEffectControlProvider.RegisterEffect(Effect)

Registriert das angegebene effect Element.

IElement.Parent

Ruft das übergeordnete Element des Elements ab.

IElementController.Descendants()

Für die interne Verwendung durch .NET MAUI.

IElementController.LogicalChildren

Für die interne Verwendung durch .NET MAUI.

IElementController.SetValueFromRenderer(BindableProperty, Object)

Für die interne Verwendung durch .NET MAUI.

INameScope.RegisterName(String, Object)

Für die interne Verwendung durch .NET MAUI.

INameScope.UnregisterName(String)

Für die interne 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 Mauszeiger auf der Ansicht befindet.

IVisualTreeElement.GetVisualChildren()

Ruft eine readonly-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 hierarchalen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Hierarchie "Microsoft.Maui.Controls" erforderlich sind.

SetAppTheme<T>(BindableObject, BindableProperty, T, T)

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

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

Stellt die Basisklasse für alle hierarchalen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Hierarchie "Microsoft.Maui.Controls" 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 hierarchalen Elemente von Microsoft.Maui.Controls bereit. Diese Klasse enthält alle Methoden und Eigenschaften, die zum Darstellen eines Elements in der Hierarchie "Microsoft.Maui.Controls" erforderlich sind.

ToHandler(IElement, IMauiContext)

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

ToPlatform(IElement, IMauiContext)

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

GetVisualElementWindow(IVisualTreeElement)

Ruft das Fenster ab, das das visuelle Strukturelement enthält, wenn das Element in einem Element enthalten ist.

GetVisualTreeDescendants(IVisualTreeElement)

Ruft die gesamte Hierarchie von Nachfolgern als Liste der untergeordneten Elemente für ein bestimmtes visuelles Strukturelement ab.

GetVisualTreeElements(IVisualTreeElement, Point)

Ruft eine Liste der untergeordneten Elemente eines visuellen Baumelements basierend auf einem bestimmten Punkt ab.

GetVisualTreeElements(IVisualTreeElement, Rect)

Ruft eine Liste der untergeordneten Elemente einer visuellen Struktur ab, die auf einem Rechteck basiert.

GetVisualTreeElements(IVisualTreeElement, Double, Double)

Ruft die Liste einer untergeordneten Visuellen Strukturelemente basierend auf einem bestimmten x,y-Punkt ab.

GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)

Ruft eine Liste der untergeordneten Elemente einer visuellen Struktur auf grundlage eines Rechtecks ab, das durch seine Koordinaten definiert wird, die in Plattformeinheiten und nicht pixeln angegeben sind.

Gilt für: