Element Classe

Definizione

Spazio dei nomi:

Microsoft.Maui.Controls

Assembly:

Microsoft.Maui.Controls.dll

Origine:

Element.cs

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à

Object

BindableObject

Element

Derivato

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

Implementazioni

IEffectControlProvider IElementController INameScope IContextFlyoutElement IElement IToolTipElement IVisualTreeElement

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 View	La 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. Esegue il mapping delle informazioni dell'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)	Esegue il mapping della proprietà astratta ExcludedWithChildrenProperty alle implementazioni specifiche della piattaforma.
MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)	Esegue il mapping della 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, 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.
GetVisualTreeElements(IVisualTreeElement, Double, Double)	Ottiene un elenco di elementi figlio della struttura ad albero visuale in base a un determinato punto x, y.