Element Classe

Definizione

Spazio dei nomi:

Microsoft.Maui.Controls

Assembly:

Microsoft.Maui.Controls.dll

Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessarie 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

Le categorie importanti di elementi visivi sono indicate nella tabella seguente:

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 figlio.
Layout	Layoutavere 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 universalmente disponibili, 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à necessarie 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 utilizzato per identificare in modo univoco un elemento durante l'esecuzione dell'applicazione.
LogicalChildren	Obsoleti. Per l'uso interno della piattaforma 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 Element oggetto 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 precedentemente impostato per una proprietà associabile. (Ereditato da BindableObject)
ClearValue(BindablePropertyKey)	Cancella qualsiasi valore precedentemente impostato per una proprietà associabile, identificata dalla relativa chiave. (Ereditato da BindableObject)
CoerceValue(BindableProperty)	Imposta il valore della proprietà associabile specificata. Questa operazione viene eseguita richiamando BindableProperty.CoerceValueDelegate la proprietà associabile specificata. (Ereditato da BindableObject)
CoerceValue(BindablePropertyKey)	Imposta 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 oggetto 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)
SetValueCore(BindableProperty, Object, SetValueFlags)	Per l'uso interno della piattaforma Microsoft.Maui.Controls. (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 un elemento figlio viene aggiunto 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 viene 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	Generato quando il valore di una proprietà cambia. (Ereditato da BindableObject)
PropertyChanging	Si verifica quando il valore di una proprietà è in corso di modifica. (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 menu a comparsa e i separatori a comparsa del menu possono essere aggiunti al riquadro a comparsa di scelta rapida.
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à necessarie per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls. (Ereditato da BindableObject)
IEffectControlProvider.RegisterEffect(Effect)	Fornisce la classe di base per tutti gli elementi gerarchiali Microsoft.Maui.Controls. Questa classe contiene tutti i metodi e le proprietà necessarie per rappresentare un elemento nella gerarchia Microsoft.Maui.Controls.
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 nella visualizzazione.
IVisualTreeElement.GetVisualChildren()	Ottiene un elenco di sola lettura degli elementi figlio visivi dell'elemento.
IVisualTreeElement.GetVisualParent()	Ottiene l'elemento padre visivo dell'elemento.

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à necessarie 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à necessarie 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à necessarie 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à necessarie 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à necessarie 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à necessarie 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 dei figli di un elemento albero visivo in base a un determinato punto.
GetVisualTreeElements(IVisualTreeElement, Rect)	Ottiene l'elenco di elementi dell'albero visivo figlio basati su un rettangolo.
GetVisualTreeElements(IVisualTreeElement, Double, Double)	Ottiene l'elenco di elementi dell'albero visivo figlio basati su un determinato punto x, y.
GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)	Ottiene l'elenco di elementi dell'albero visivo figlio basati su un rettangolo definito dalle coordinate specificate nelle unità di piattaforma, non nei pixel.