Element Classe

Référence

Définition

Espace de noms:: Microsoft.Maui.Controls

Assembly:: Microsoft.Maui.Controls.dll

Source:: Element.cs

Source:: Element.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Plus…

Implémente: IEffectControlProvider IElementController INameScope IContextFlyoutElement IElement IToolTipElement IVisualTreeElement

Remarques

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

Classe	Description
VisualElement	Une Element zone qui 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	Qui VisualElement occupe la plupart ou l’ensemble de l’écran et contient un seul enfant.
Layout	Layout avoir un seul enfant de type View, tandis que les sous-classes d’avoir Layout 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()

Champs

AutomationIdProperty	Propriété pouvant être liée pour AutomationId.
ClassIdProperty	Propriété pouvant être liée pour ClassId.
ControlsElementMapper	Obsolète. Mappe les informations d’interface utilisateur aux implémentations spécifiques à la plateforme pour les services d’accessibilité
transientNamescope	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.

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 à cet objet 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 disponible lorsque cet objet pouvant être lié a été créé, sinon tente de trouver le répartiteur disponible le plus proche (probablement les fenêtres/application). (Hérité de BindableObject)
EffectControlProvider	Pour une utilisation interne par .NET MAUI.
Effects	Obtient ou définit les styles et 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. 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.
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 définie précédemment 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 la propriété pouvant être BindableProperty.CoerceValueDelegate 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 la propriété pouvant être BindableProperty.CoerceValueDelegate 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 aux enfants logiques à l’index spécifié.
IsSet(BindableProperty)	Détermine si une propriété pouvant être liée existe ou non et a un jeu de valeurs. (Hérité de BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)	Mappe la propriété abstraite ExcludedWithChildrenProperty aux implémentations spécifiques à la plateforme.
MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)	Mappe la propriété abstraite IsInAccessibleTreeProperty aux implémentations spécifiques à 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 le 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 définie précédemment d’une propriété pouvant être liée. (Hérité de BindableObject)
RemoveDynamicResource(BindableProperty)	Supprime une ressource dynamique définie précédemment.
RemoveLogicalChild(Element)	Supprime la première occurrence d’un enfant logique spécifique Element .
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)
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 d’é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 lorsqu'une valeur de propriété change. (Hérité de BindableObject)
PropertyChanging	Se produit en cas de modification d’une valeur de propriété. (Hérité de BindableObject)

Implémentations d’interfaces explicites

IContextFlyoutElement.ContextFlyout	Obtient la ContextFlyout vue. Les menu volants de menu, les sous-éléments de menu volant de menu et les 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)	Inscrit le spécifié `effect` à cet élément.
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 repose le pointeur sur l’affichage.
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é.
SetBinding<TSource,TProperty>(BindableObject, BindableProperty, Func<TSource,TProperty>, BindingMode, IValueConverter, Object, String, Object, Object, Object)	Crée une liaison entre une propriété sur l’objet source et une propriété sur l’objet cible.
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 la hiérarchie entière des descendants sous forme de liste d’enfants pour un élément d’arborescence 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 élément d’arborescence visuelle enfants basés sur un rectangle.
GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)	Obtient la liste d’un élément d’arborescence visuelle enfants basés sur un rectangle défini par ses coordonnées qui sont spécifiées dans les unités de plateforme, et non en pixels.
GetVisualTreeElements(IVisualTreeElement, Double, Double)	Obtient la liste d’un élément d’arborescence visuel enfants basés sur un point x, y donné.

S’applique à

Partager via