Element Classe

Définition

Espace de noms:

Microsoft.Maui.Controls

Assembly:

Microsoft.Maui.Controls.dll

Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie 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

Héritage

Object

BindableObject

Element

Dérivé

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

Implémente

IEffectControlProvider IElementController INameScope IContextFlyoutElement IElement IToolTipElement IVisualTreeElement

Remarques

Les catégories importantes d’éléments visuels sont indiquées dans le tableau suivant :

Classe	Description
VisualElement	qui Element occupe une zone à l’écran, a une apparence visuelle et peut obtenir une entrée tactile.
Cell	Les cellules sont des éléments destinés à être ajoutés à ListView ou TableView.
Page	VisualElement qui occupe la plupart ou la totalité de l’écran et contient un seul enfant.
Layout	Layoutavoir un seul enfant de type View , tandis que les sous-classes de Layout ont une collection de plusieurs vues enfants, y compris d’autres dispositions.
Contrôles et spécialisés View	La partie inférieure du diagramme montre les classes Microsoft.Maui.Controls pour les contrôles universellement disponibles, tels que Button et TableView.

Constructeurs

Element()

Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls.

Champs

AutomationIdProperty	Propriété bindable pour AutomationId.
ClassIdProperty	Propriété bindable pour ClassId.
ControlsElementMapper	Obsolète. Mappe les informations de l’interface utilisateur à des implémentations spécifiques à la plateforme pour les services d’accessibilité

Propriétés

AutomationId	Obtient ou définit une valeur qui permet au framework d’automatisation de rechercher cet élément et d’interagir avec celui-ci.
BindingContext	Obtient ou définit un objet qui contient les propriétés qui seront ciblées par les propriétés liées qui appartiennent à ce BindableObject. Il s’agit d’une propriété pouvant être liée. (Hérité de BindableObject)
ClassId	Obtient ou définit une valeur utilisée pour identifier une collection d’éléments sémantiquement similaires.
Dispatcher	Obtient le répartiteur qui était disponible lors de la création de cet objet pouvant être lié, sinon, tente de trouver le répartiteur disponible le plus proche (probablement celui de la fenêtre/de l’application). (Hérité de BindableObject)
EffectControlProvider	Pour une utilisation interne par .NET MAUI.
Effects	Obtient ou définit les styles et les propriétés qui seront appliqués à l’élément pendant l’exécution.
Handler	Obtient ou définit le gestionnaire associé pour cet élément.
Id	Obtient une valeur qui peut être utilisée pour identifier de manière unique un élément tout au long de l’exécution de votre application.
LogicalChildren	Obsolète. Pour une utilisation interne par la plateforme Microsoft.Maui.Controls.
Parent	Obtient ou définit le parent Element de cet élément.
RealParent	Pour une utilisation interne par .NET MAUI.
StyleId	Obtient ou définit une valeur définie par l’utilisateur permettant d’identifier de façon unique l’élément.

Méthodes

AddLogicalChild(Element)	Ajoute un Element aux enfants logiques.
ApplyBindings()	Applique toutes les liaisons actuelles à BindingContext. (Hérité de BindableObject)
ClearLogicalChildren()	Supprime tous les enfants Element.
ClearValue(BindableProperty)	Efface toute valeur précédemment définie pour une propriété pouvant être liée. (Hérité de BindableObject)
ClearValue(BindablePropertyKey)	Efface toute valeur précédemment définie pour une propriété pouvant être liée, identifiée par sa clé. (Hérité de BindableObject)
CoerceValue(BindableProperty)	Force la valeur de la propriété pouvant être liée spécifiée. Pour ce faire, appelez BindableProperty.CoerceValueDelegate la propriété pouvant être liée spécifiée. (Hérité de BindableObject)
CoerceValue(BindablePropertyKey)	Force la valeur de la propriété pouvant être liée spécifiée. Pour ce faire, appelez BindableProperty.CoerceValueDelegate la propriété pouvant être liée spécifiée. (Hérité de BindableObject)
EffectIsAttached(String)	Pour une utilisation interne par .NET MAUI.
FindByName(String)	Retourne l'élément ayant le nom spécifié.
GetValue(BindableProperty)	Retourne la valeur contenue dans la propriété pouvant être liée donnée. (Hérité de BindableObject)
InsertLogicalChild(Int32, Element)	Insère un Element dans les enfants logiques à l’index spécifié.
IsSet(BindableProperty)	Détermine s’il existe ou non une propriété pouvant être liée et a une valeur définie. (Hérité de BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)	Mappe la propriété abstraite ExcludedWithChildrenProperty aux implémentations spécifiques de la plateforme.
MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)	Mappe la propriété abstraite IsInAccessibleTreeProperty aux implémentations spécifiques de la plateforme.
OnBindingContextChanged()	Appelée chaque fois que le contexte de liaison de l’élément change. Implémentez cette méthode pour ajouter la gestion de classes pour cet événement.
OnChildAdded(Element)	Déclenche l’événement ChildAdded. Implémentez cette méthode pour ajouter la gestion de classes pour cet événement.
OnChildRemoved(Element, Int32)	Déclenche l’événement ChildRemoved. Implémenter cette méthode pour ajouter la gestion des classes pour cet événement
OnHandlerChanged()	En cas de substitution dans une classe dérivée, doit déclencher l’événement HandlerChanged .
OnHandlerChanging(HandlerChangingEventArgs)	En cas de substitution dans une classe dérivée, doit déclencher l’événement HandlerChanging .
OnParentChanged()	En cas de substitution dans une classe dérivée, doit déclencher l’événement ParentChanged .
OnParentChanging(ParentChangingEventArgs)	En cas de substitution dans une classe dérivée, doit déclencher l’événement ParentChanging .
OnParentSet()	Déclenche l’événement (interne). ParentSet Implémentez cette méthode pour ajouter un comportement quand l’élément est ajouté à un parent.
OnPropertyChanged(String)	Méthode appelée en cas de changement d’une propriété liée.
OnPropertyChanging(String)	Déclenche l’événement PropertyChanging. (Hérité de BindableObject)
RemoveBinding(BindableProperty)	Supprime une liaison précédemment définie d’une propriété pouvant être liée. (Hérité de BindableObject)
RemoveDynamicResource(BindableProperty)	Supprime une ressource dynamique précédemment définie.
RemoveLogicalChild(Element)	Supprime la première occurrence d’un spécifique Element des enfants logiques.
SetBinding(BindableProperty, BindingBase)	Affecte une liaison à une propriété pouvant être liée. (Hérité de BindableObject)
SetDynamicResource(BindableProperty, String)	Définit la BindableProperty propriété de cet élément à mettre à jour via DynamicResource avec la clé fournie.
SetValue(BindableProperty, Object)	Définit la valeur de la propriété pouvant être liée spécifiée. (Hérité de BindableObject)
SetValue(BindablePropertyKey, Object)	Définit la valeur de la propriété pouvant être liée spécifiée. (Hérité de BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)	Pour une utilisation interne par la plateforme Microsoft.Maui.Controls. (Hérité de BindableObject)
SetValueFromRenderer(BindableProperty, Object)	Pour une utilisation interne par .NET MAUI.
SetValueFromRenderer(BindablePropertyKey, Object)	Pour une utilisation interne par .NET MAUI.
UnapplyBindings()	Supprime toutes les liaisons actuelles du contexte actuel. (Hérité de BindableObject)

Événements

BindingContextChanged	Se produit quand la valeur de la propriété BindingContext change. (Hérité de BindableObject)
ChildAdded	Déclenché chaque fois qu’un élément enfant est ajouté à l’élément .
ChildRemoved	Déclenché chaque fois qu’un élément enfant est supprimé de l’élément .
DescendantAdded	Déclenché chaque fois qu’un élément enfant est ajouté à la sous-arborescence de l’élément.
DescendantRemoved	Déclenché chaque fois qu’un élément enfant est supprimé de la sous-arborescence des éléments.
HandlerChanged	Déclenché chaque fois que le gestionnaire de l’élément a changé.
HandlerChanging	Déclenché chaque fois que le gestionnaire de l’élément commence à changer.
ParentChanged	Déclenché chaque fois que le parent de l’élément a changé.
ParentChanging	Déclenché chaque fois que l’élément commence à changer.
PropertyChanged	Se produit en cas de modification d'une valeur de propriété. (Hérité de BindableObject)
PropertyChanging	Se produit lorsqu'une valeur de propriété change. (Hérité de BindableObject)

Implémentations d’interfaces explicites

IContextFlyoutElement.ContextFlyout	Obtient le ContextFlyout pour la vue. Des menus volants, des sous-éléments de menu volant et des séparateurs de menu volant de menu peuvent être ajoutés au menu volant contextuel.
IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)	Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls. (Hérité de BindableObject)
IEffectControlProvider.RegisterEffect(Effect)	Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls.
IElement.Parent	Obtient le parent de l’élément.
IElementController.Descendants()	Pour une utilisation interne par .NET MAUI.
IElementController.LogicalChildren	Pour une utilisation interne par .NET MAUI.
IElementController.SetValueFromRenderer(BindableProperty, Object)	Pour une utilisation interne par .NET MAUI.
INameScope.RegisterName(String, Object)	Pour une utilisation interne par .NET MAUI.
INameScope.UnregisterName(String)	Pour une utilisation interne par .NET MAUI.
IToolTipElement.ToolTip	Représente une petite fenêtre contextuelle rectangulaire qui affiche une brève description de l’objectif d’une vue lorsque l’utilisateur place le pointeur sur la vue.
IVisualTreeElement.GetVisualChildren()	Obtient une liste en lecture seule des enfants visuels de l’élément.
IVisualTreeElement.GetVisualParent()	Obtient le parent visuel de l’élément.

Méthodes d’extension

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)	Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls.
SetAppTheme<T>(BindableObject, BindableProperty, T, T)	Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls.
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)	Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls.
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)	Crée et applique une liaison à une propriété.
FindByName<T>(Element, String)	Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls.
ToHandler(IElement, IMauiContext)	Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls.
ToPlatform(IElement, IMauiContext)	Fournit la classe de base pour tous les éléments hiérarchiques Microsoft.Maui.Controls. Cette classe contient toutes les méthodes et propriétés requises pour représenter un élément dans la hiérarchie Microsoft.Maui.Controls.
GetVisualElementWindow(IVisualTreeElement)	Obtient la fenêtre contenant l’élément Visual Tree, si l’élément est contenu dans un seul élément.
GetVisualTreeDescendants(IVisualTreeElement)	Obtient l’ensemble de la hiérarchie des descendants sous la forme d’une liste d’enfants pour un élément d’arbre visuel donné.
GetVisualTreeElements(IVisualTreeElement, Point)	Obtient la liste des enfants d’un élément d’arborescence visuelle en fonction d’un point donné.
GetVisualTreeElements(IVisualTreeElement, Rect)	Obtient la liste d’un enfant d’éléments d’arborescence visuelle en fonction d’un rectangle.
GetVisualTreeElements(IVisualTreeElement, Double, Double)	Obtient la liste d’un enfant d’éléments d’arborescence visuelle en fonction d’un point x, y donné.
GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)	Obtient la liste des enfants d’un élément d’arborescence visuelle en fonction d’un rectangle défini par ses coordonnées qui sont spécifiées en unités de plateforme, et non en pixels.