Element Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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::IVisualTreeElementpublic 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.IVisualTreeElementtype Element = class
inherit BindableObject
interface INameScope
interface IElementController
interface IVisualTreeElement
interface IElement
interface IEffectControlProvider
interface IToolTipElement
interface IContextFlyoutElementPublic 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 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à |
| transientNamescope |
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. |
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). |
| 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 |
| 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à. |
| SetBinding<TSource,TProperty>(BindableObject, BindableProperty, Func<TSource,TProperty>, BindingMode, IValueConverter, Object, String, Object, Object, Object) |
Crea un'associazione tra una proprietà nell'oggetto di origine e una proprietà nell'oggetto di destinazione. |
| 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. |
