Condividi tramite


Element Classe

Definizione

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia 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
Ereditarietà
Derivato
Implementazioni

Commenti

Nella tabella seguente sono indicate categorie importanti di elementi visivi:

Classe Descrizione
VisualElement Oggetto Element che occupa un'area sullo schermo, ha un aspetto visivo e può ottenere l'input tocco.
Cell Le celle sono gli elementi da aggiungere a ListView o a TableView.
Page Oggetto VisualElement che occupa la maggior parte o tutto lo schermo e contiene un singolo elemento figlio.
Layout Layout hanno un singolo elemento figlio di tipo View, mentre le sottoclassi di Layout hanno una raccolta di più visualizzazioni figlio, inclusi altri layout.
Controlli e specializzati ViewLa parte inferiore del diagramma mostra le classi Microsoft.Maui.Controls per i controlli disponibili universalmente, ad esempio Button e TableView.

Costruttori

Element()

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

Campi

AutomationIdProperty

Proprietà associabile per AutomationId.

ClassIdProperty

Proprietà associabile per ClassId.

ControlsElementMapper
Obsoleti.

Mappe informazioni sull'interfaccia utente alle implementazioni specifiche della piattaforma per i servizi di accessibilità

Proprietà

AutomationId

Ottiene o imposta un valore che consente al framework di automazione di individuare questo elemento e di interagire con esso.

BindingContext

Ottiene o imposta un oggetto che contiene le proprietà di destinazione delle proprietà associate che appartengono a questo BindableObjectoggetto . Si tratta di una proprietà associabile.

(Ereditato da BindableObject)
ClassId

Ottiene o imposta un valore utilizzato per identificare una raccolta di elementi semanticamente simili.

Dispatcher

Ottiene il dispatcher disponibile al momento della creazione di questo oggetto associabile. In caso contrario, tenta di trovare il dispatcher più vicino disponibile (probabilmente quello della finestra o dell'app).

(Ereditato da BindableObject)
EffectControlProvider

Per l'uso interno da parte di .NET MAUI.

Effects

Ottiene o imposta gli stili e le proprietà che verranno applicati all'elemento durante il runtime.

Handler

Ottiene o imposta il gestore associato per questo elemento.

Id

Ottiene un valore che può essere usato per identificare in modo univoco un elemento durante l'esecuzione dell'applicazione.

LogicalChildren
Obsoleti.

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

Parent

Ottiene o imposta l'elemento padre Element di questo elemento.

RealParent

Per l'uso interno da parte di .NET MAUI.

StyleId

Ottiene o imposta un valore definito dall'utente per identificare in modo univoco l'elemento.

Metodi

AddLogicalChild(Element)

Aggiunge un oggetto Element agli elementi figlio logici.

ApplyBindings()

Applica tutte le associazioni correnti a BindingContext.

(Ereditato da BindableObject)
ClearLogicalChildren()

Rimuove tutti gli elementi figlio Element.

ClearValue(BindableProperty)

Cancella qualsiasi valore impostato in precedenza per una proprietà associabile.

(Ereditato da BindableObject)
ClearValue(BindablePropertyKey)

Cancella qualsiasi valore impostato in precedenza per una proprietà associabile, identificata dalla relativa chiave.

(Ereditato da BindableObject)
CoerceValue(BindableProperty)

Forza il valore della proprietà associabile specificata. Questa operazione viene eseguita richiamando BindableProperty.CoerceValueDelegate la proprietà associabile specificata.

(Ereditato da BindableObject)
CoerceValue(BindablePropertyKey)

Forza il valore della proprietà associabile specificata. Questa operazione viene eseguita richiamando BindableProperty.CoerceValueDelegate la proprietà associabile specificata.

(Ereditato da BindableObject)
EffectIsAttached(String)

Per l'uso interno da parte di .NET MAUI.

FindByName(String)

Restituisce l'elemento con il nome specificato.

GetValue(BindableProperty)

Restituisce il valore contenuto nella proprietà associabile specificata.

(Ereditato da BindableObject)
InsertLogicalChild(Int32, Element)

Inserisce un oggetto Element negli elementi figlio logici in corrispondenza dell'indice specificato.

IsSet(BindableProperty)

Determina se esiste o meno una proprietà associabile e ha un valore impostato.

(Ereditato da BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)

Mappe la proprietà astratta ExcludedWithChildrenProperty alle implementazioni specifiche della piattaforma.

MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)

Mappe la proprietà astratta IsInAccessibleTreeProperty alle implementazioni specifiche della piattaforma.

OnBindingContextChanged()

Richiamato ogni volta che il contesto di associazione dell'elemento cambia. Implementare questo metodo per aggiungere la gestione delle classi per questo evento.

OnChildAdded(Element)

Genera l'evento ChildAdded. Implementare questo metodo per aggiungere la gestione delle classi per questo evento.

OnChildRemoved(Element, Int32)

Genera l'evento ChildRemoved. Implementare questo metodo per aggiungere la gestione delle classi per questo evento

OnHandlerChanged()

Quando sottoposto a override in una classe derivata, deve generare l'evento HandlerChanged .

OnHandlerChanging(HandlerChangingEventArgs)

Quando sottoposto a override in una classe derivata, deve generare l'evento HandlerChanging .

OnParentChanged()

Quando sottoposto a override in una classe derivata, deve generare l'evento ParentChanged .

OnParentChanging(ParentChangingEventArgs)

Quando sottoposto a override in una classe derivata, deve generare l'evento ParentChanging .

OnParentSet()

Genera l'evento (interno). ParentSet Implementare questo metodo per aggiungere il comportamento quando l'elemento viene aggiunto a un elemento padre.

OnPropertyChanged(String)

Metodo chiamato quando viene modificata una proprietà associata.

OnPropertyChanging(String)

Genera l'evento PropertyChanging.

(Ereditato da BindableObject)
RemoveBinding(BindableProperty)

Rimuove un'associazione impostata in precedenza da una proprietà associabile.

(Ereditato da BindableObject)
RemoveDynamicResource(BindableProperty)

Rimuove una risorsa dinamica impostata in precedenza.

RemoveLogicalChild(Element)

Rimuove la prima occorrenza di un elemento specifico Element dagli elementi figlio logici.

SetBinding(BindableProperty, BindingBase)

Assegna un'associazione a una proprietà associabile.

(Ereditato da BindableObject)
SetDynamicResource(BindableProperty, String)

Imposta la BindableProperty proprietà di questo elemento da aggiornare tramite DynamicResource con la chiave specificata.

SetValue(BindableProperty, Object)

Imposta il valore della proprietà associabile specificata.

(Ereditato da BindableObject)
SetValue(BindablePropertyKey, Object)

Imposta il valore della proprietà associabile specificata.

(Ereditato da BindableObject)
SetValueFromRenderer(BindableProperty, Object)

Per l'uso interno da parte di .NET MAUI.

SetValueFromRenderer(BindablePropertyKey, Object)

Per l'uso interno da parte di .NET MAUI.

UnapplyBindings()

Rimuove tutte le associazioni correnti dal contesto corrente.

(Ereditato da BindableObject)

Eventi

BindingContextChanged

Si verifica quando il valore della proprietà BindingContext cambia.

(Ereditato da BindableObject)
ChildAdded

Generato ogni volta che viene aggiunto un elemento figlio all'elemento .

ChildRemoved

Generato ogni volta che un elemento figlio viene rimosso dall'elemento .

DescendantAdded

Generato ogni volta che un elemento figlio viene aggiunto al sottoalbero dell'elemento.

DescendantRemoved

Generato ogni volta che un elemento figlio viene rimosso dal sottoalbero degli elementi.

HandlerChanged

Generato ogni volta che il gestore dell'elemento è stato modificato.

HandlerChanging

Generato ogni volta che il gestore dell'elemento inizia a cambiare.

ParentChanged

Generato ogni volta che l'elemento padre dell'elemento viene modificato.

ParentChanging

Generato ogni volta che l'elemento inizia a cambiare.

PropertyChanged

Si verifica quando un valore della proprietà viene modificato.

(Ereditato da BindableObject)
PropertyChanging

Si verifica quando il valore di una proprietà cambia.

(Ereditato da BindableObject)

Implementazioni dell'interfaccia esplicita

IContextFlyoutElement.ContextFlyout

Ottiene l'oggetto ContextFlyout per la visualizzazione. I riquadri a comparsa del menu, gli elementi secondari del riquadro a comparsa del menu e i separatori a comparsa del menu possono essere aggiunti al riquadro a comparsa del contesto.

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

(Ereditato da BindableObject)
IEffectControlProvider.RegisterEffect(Effect)

Registra l'oggetto specificato effect in questo elemento.

IElement.Parent

Ottiene l'elemento padre dell'elemento.

IElementController.Descendants()

Per l'uso interno da parte di .NET MAUI.

IElementController.LogicalChildren

Per l'uso interno da parte di .NET MAUI.

IElementController.SetValueFromRenderer(BindableProperty, Object)

Per l'uso interno da parte di .NET MAUI.

INameScope.RegisterName(String, Object)

Per l'uso interno da parte di .NET MAUI.

INameScope.UnregisterName(String)

Per l'uso interno da parte di .NET MAUI.

IToolTipElement.ToolTip

Rappresenta una piccola finestra popup rettangolare che visualizza una breve descrizione dello scopo di una visualizzazione quando l'utente posiziona il puntatore sulla visualizzazione.

IVisualTreeElement.GetVisualChildren()

Ottiene un elenco di sola lettura degli elementi figlio visivi dell'elemento.

IVisualTreeElement.GetVisualParent()

Ottiene l'elemento padre dell'elemento visivo.

Metodi di estensione

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

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

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

Crea un'associazione e la applica a una proprietà.

FindByName<T>(Element, String)

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

ToHandler(IElement, IMauiContext)

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

ToPlatform(IElement, IMauiContext)

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessari per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.

GetVisualElementWindow(IVisualTreeElement)

Ottiene la finestra contenente l'elemento struttura ad albero visuale, se l'elemento è contenuto all'interno di uno.

GetVisualTreeDescendants(IVisualTreeElement)

Ottiene l'intera gerarchia dei discendenti come elenco di elementi figlio per un determinato elemento albero visuale.

GetVisualTreeElements(IVisualTreeElement, Point)

Ottiene l'elenco degli elementi figlio di un elemento struttura ad albero visuale in base a un determinato punto.

GetVisualTreeElements(IVisualTreeElement, Rect)

Ottiene un elenco di elementi figlio della struttura ad albero visuale basati su un rettangolo.

GetVisualTreeElements(IVisualTreeElement, Double, Double)

Ottiene un elenco di elementi figlio della struttura ad albero visuale in base a un determinato punto x, y.

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

Ottiene l'elenco di elementi figlio della struttura ad albero visuale basati su un rettangolo definito dalle relative coordinate specificate in unità di piattaforma, non in pixel.

Si applica a