Partager via


Contrôles

Parcourez l’exemple. Parcourir l'exemple

L’interface utilisateur d’une application .NET Multi-platform App UI (.NET MAUI) est composée d’objets mappés aux contrôles natifs de chaque plateforme cible.

Les principaux groupes de contrôle utilisés pour créer l’interface utilisateur d’une application .NET MAUI sont les pages, les dispositions et les vues. Une page .NET MAUI occupe généralement tout l’écran ou toute la fenêtre. La page contient généralement une disposition, qui contient des vues et éventuellement d’autres dispositions. Les pages, les dispositions et les vues dérivent de la classe VisualElement. Cette classe fournit un éventail de propriétés, de méthodes et d’événements qui sont utiles dans les classes dérivées.

Remarque

ListView et TableView prennent également en charge l’utilisation de cellules. Les cellules sont des éléments spécialisés utilisés pour les éléments d’un tableau, qui décrivent comment chaque élément doit être rendu.

Pages

Les applications .NET MAUI sont composées d’une ou de plusieurs pages. Une page occupe généralement l’ensemble de l’écran ou de la fenêtre, et chaque page contient généralement au moins une disposition.

.NET MAUI contient les pages suivantes :

Page Description
ContentPage La ContentPage affiche une vue unique et est le type de page le plus courant. Pour plus d’informations, consultez ContentPage.
FlyoutPage La FlyoutPage est une page qui gère deux pages d’informations connexes : une page volante qui affiche des éléments et une page de détails qui affiche les détails relatifs aux éléments de la page volante. Pour plus d’informations, consultez FlyoutPage.
NavigationPage La NavigationPage fournit une expérience de navigation hiérarchique vous permettant de parcourir les pages dans le sens que vous voulez. Pour plus d’informations, consultez NavigationPage.
TabbedPage La TabbedPage est constituée d’une série de pages qui sont navigables via des onglets en haut ou en bas de la page, chaque onglet chargeant le contenu de la page. Pour plus d’informations, consultez TabbedPage.

Dispositions

Les dispositions .NET MAUI sont utilisées pour organiser les contrôles de l’interface utilisateur dans des structures visuelles, et chaque disposition contient généralement plusieurs vues. Les classes de disposition contiennent généralement une logique pour définir la position et la taille des éléments enfants.

.NET MAUI contient les dispositions suivantes :

Disposition Description
AbsoluteLayout AbsoluteLayout positionne les éléments enfants à des emplacements spécifiques par rapport à leurs parents. Pour plus d’informations, consultez AbsoluteLayout.
BindableLayout BindableLayout permet aux classes de disposition de générer leur contenu en se liant à un ensemble d’éléments, avec une option permettant de définir l’apparence de chaque élément. Pour plus d’informations, consultez BindableLayout.
FlexLayout FlexLayout permet à ses enfants d’être empilés ou encapsulés avec différentes options d’alignement et d’orientation. FlexLayout est basé sur le module de disposition CSS de boîte flexible, appelé disposition flex ou flex-box. Pour plus d’informations, consultez FlexLayout.
Grid Grid positionne ses éléments enfants dans une grille de lignes et de colonnes. Pour plus d’informations, consultez Grid.
HorizontalStackLayout HorizontalStackLayout positionne les éléments enfants dans une pile horizontale. Pour plus d’informations, consultez HorizontalStackLayout.
StackLayout StackLayout positionne les éléments enfants dans une pile verticale ou horizontale. Pour obtenir plus d’informations, consultez StackLayout.
VerticalStackLayout VerticalStackLayout positionne les éléments enfants dans une pile verticale. Pour plus d’informations, consultez VerticalStackLayout.

Vues

Les vues .NET MAUI sont les objets de l’interface utilisateur tels que les libellés, les boutons et les curseurs, communément appelés contrôles ou widgets dans d’autres environnements.

.NET MAUI contient les vues suivantes :

Affichage Description
ActivityIndicator ActivityIndicator utilise une animation pour montrer que l’application est engagée dans une activité de longue durée, sans fournir aucune indication de progression. Pour plus d’informations, consultez ActivityIndicator.
BlazorWebView BlazorWebView vous permet d’héberger une application Web Blazor dans votre application .NET MAUI. Pour plus d’informations, consultez BlazorWebView.
Border Border est un contrôle conteneur qui trace une bordure, un arrière-plan, ou les deux, autour d’un autre contrôle. Pour en savoir plus, consultez Border.
BoxView BoxView dessine un rectangle ou un carré, d’une largeur, d’une hauteur et d’une couleur spécifiées. Pour plus d’informations, consultez BoxView.
Button Button affiche du texte et répond à un appui ou à un clic qui ordonne à une application d’effectuer une tâche. Pour plus d’informations, consultez Button.
CarouselView CarouselView affiche une liste avec défilement contenant des éléments de données, dans laquelle les utilisateurs se déplacent à l’aide d’un mouvement de balayage. Pour plus d’informations, consultez CarouselView.
CheckBox CheckBox vous permet de sélectionner une valeur booléenne à l’aide d’un type de bouton qui peut être soit coché, soit laissé vide. Pour plus d’informations, consultez CheckBox.
CollectionView CollectionView affiche une liste avec défilement contenant des éléments de données sélectionnables, à l’aide de différentes caractéristiques de disposition. Pour plus d’informations, consultez CollectionView.
ContentView ContentView est un contrôle qui permet de créer des contrôles personnalisés et réutilisables. Pour plus d’informations, consultez ContentView.
DatePicker DatePicker vous permet de sélectionner une date avec le sélecteur de dates de la plateforme. Pour plus d’informations, consultez DatePicker.
Editor Editor vous permet de saisir et de modifier plusieurs lignes de texte. Pour plus d’informations, consultez Editor.
Ellipse Ellipse affiche une ellipse ou un cercle. Pour plus d’informations, consultez Ellipse.
Entry Entry vous permet de saisir et de modifier une seule ligne de texte. Pour plus d’informations, consultez Entry.
Frame Frame est utilisé pour encapsuler une vue ou une disposition dans une bordure dont vous pouvez configurer la couleur, l’ombre, ainsi que d’autres options. Pour plus d’informations, consultez Frame.
GraphicsView GraphicsView est un canevas graphique dans lequel des images en 2D peuvent être dessinées à l’aide de types provenant de l’espace de noms Microsoft.Maui.Graphics. Pour plus d’informations, consultez GraphicsView.
Image Image affiche une image qui peut être chargée à partir d’un fichier local, d’un URI, d’une ressource incorporée ou d’un flux. Pour plus d’informations, consultez Image.
ImageButton ImageButton affiche une image et réagit à un appui ou à un clic qui ordonne à une application d’effectuer une tâche. Pour plus d’informations, consultez ImageButton.
IndicatorView IndicatorView affiche des indicateurs qui représentent le nombre d’éléments d’un CarouselView. Pour plus d’informations, consultez IndicatorView.
Label Label affiche du texte sur une seule ligne et sur plusieurs lignes. Pour plus d’informations, consultez Label.
Line Line affiche une ligne d’un point de départ jusqu’à un point d’arrivée. Pour plus d’informations, consultez Line.
ListView ListView affiche une liste avec défilement contenant des éléments de données sélectionnables. Pour plus d’informations, consultez ListView.
Map Map affiche une carte et nécessite l’installation du package NuGet Microsoft.Maui.Controls.Maps dans votre application.
Path Path affiche des courbes et des formes complexes. Pour plus d’informations, consultez Path.
Picker Picker affiche une courte liste d’éléments, dans laquelle un élément peut être sélectionné. Pour plus d’informations, consultez Picker.
Polygon Polygon affiche un polygone. Pour plus d’informations, consultez Polygon.
Polyline Polyline affiche une série de lignes droites connectées. Pour plus d’informations, consultez Polyline.
ProgressBar ProgressBar utilise une animation pour montrer que l’application progresse dans une activité de longue durée. Pour plus d’informations, consultez ProgressBar.
RadioButton RadioButton est un type de bouton qui permet de sélectionner une option dans un ensemble. Pour plus d’informations, consultez RadioButton.
Rectangle Rectangle affiche un rectangle ou un carré. Pour plus d’informations, consultez Rectangle.
RefreshView RefreshView est un contrôle conteneur qui fournit une fonctionnalité « balayer pour actualiser » pour du contenu avec défilement. Pour plus d’informations, consultez RefreshView.
RoundRectangle RoundRectangle affiche un rectangle ou un carré avec des angles arrondis. Pour plus d’informations, consultez Rectangle.
ScrollView ScrollView fournit un défilement pour son contenu, qui est généralement une disposition. Pour plus d’informations, consultez ScrollView.
SearchBar SearchBar est un contrôle d’entrée utilisateur utilisé pour lancer une recherche. Pour plus d’informations, consultez SearchBar.
Slider Slider vous permet de sélectionner une valeur double dans une plage continue. Pour plus d’informations, consultez Slider.
Stepper Stepper vous permet de sélectionner une valeur double dans une plage de valeurs incrémentielles. Pour plus d’informations, consultez Stepper.
SwipeView SwipeView est un contrôle conteneur qui encapsule un élément de contenu et fournit des éléments de menu contextuel qui se révèlent avec un mouvement de balayage. Pour plus d’informations, consultez SwipeView.
Switch Switch vous permet de sélectionner une valeur booléenne à l’aide d’un type de bouton qui peut être activé ou désactivé. Pour plus d’informations, consultez Switch.
TableView TableView affiche un tableau d’éléments avec défilement que vous pouvez regrouper en sections. Pour plus d’informations, consultez TableView.
TimePicker TimePicker vous permet de sélectionner une heure avec le sélecteur d’horaires de la plateforme. Pour plus d’informations, consultez TimePicker.
TwoPaneView TwoPaneView représente un conteneur avec deux vues qui ajustent la dimension et la position de leur contenu dans l’espace disponible, soit côte à côte, soit de haut en bas. Pour plus d’informations, consultez TwoPaneView.
WebView WebView affiche des pages web ou du contenu HTML local. Pour plus d’informations, consultez WebView.
Affichage Description
ActivityIndicator ActivityIndicator utilise une animation pour montrer que l’application est engagée dans une activité de longue durée, sans fournir aucune indication de progression. Pour plus d’informations, consultez ActivityIndicator.
BlazorWebView BlazorWebView vous permet d’héberger une application Web Blazor dans votre application .NET MAUI. Pour plus d’informations, consultez BlazorWebView.
Border Border est un contrôle conteneur qui trace une bordure, un arrière-plan, ou les deux, autour d’un autre contrôle. Pour en savoir plus, consultez Border.
BoxView BoxView dessine un rectangle ou un carré, d’une largeur, d’une hauteur et d’une couleur spécifiées. Pour plus d’informations, consultez BoxView.
Button Button affiche du texte et répond à un appui ou à un clic qui ordonne à une application d’effectuer une tâche. Pour plus d’informations, consultez Button.
CarouselView CarouselView affiche une liste avec défilement contenant des éléments de données, dans laquelle les utilisateurs se déplacent à l’aide d’un mouvement de balayage. Pour plus d’informations, consultez CarouselView.
CheckBox CheckBox vous permet de sélectionner une valeur booléenne à l’aide d’un type de bouton qui peut être soit coché, soit laissé vide. Pour plus d’informations, consultez CheckBox.
CollectionView CollectionView affiche une liste avec défilement contenant des éléments de données sélectionnables, à l’aide de différentes caractéristiques de disposition. Pour plus d’informations, consultez CollectionView.
ContentView ContentView est un contrôle qui permet de créer des contrôles personnalisés et réutilisables. Pour plus d’informations, consultez ContentView.
DatePicker DatePicker vous permet de sélectionner une date avec le sélecteur de dates de la plateforme. Pour plus d’informations, consultez DatePicker.
Editor Editor vous permet de saisir et de modifier plusieurs lignes de texte. Pour plus d’informations, consultez Editor.
Ellipse Ellipse affiche une ellipse ou un cercle. Pour plus d’informations, consultez Ellipse.
Entry Entry vous permet de saisir et de modifier une seule ligne de texte. Pour plus d’informations, consultez Entry.
Frame Frame est utilisé pour encapsuler une vue ou une disposition dans une bordure dont vous pouvez configurer la couleur, l’ombre, ainsi que d’autres options. Pour plus d’informations, consultez Frame.
GraphicsView GraphicsView est un canevas graphique dans lequel des images en 2D peuvent être dessinées à l’aide de types provenant de l’espace de noms Microsoft.Maui.Graphics. Pour plus d’informations, consultez GraphicsView.
HybridWebView HybridWebView vous permet d’héberger du contenu HTML/JS/CSS arbitraire dans une vue web et permet une communication entre le code de la vue web (JavaScript) et le code qui héberge la vue web (C#/.NET). Pour plus d’informations, consultez HybridWebView.
Image Image affiche une image qui peut être chargée à partir d’un fichier local, d’un URI, d’une ressource incorporée ou d’un flux. Pour plus d’informations, consultez Image.
ImageButton ImageButton affiche une image et réagit à un appui ou à un clic qui ordonne à une application d’effectuer une tâche. Pour plus d’informations, consultez ImageButton.
IndicatorView IndicatorView affiche des indicateurs qui représentent le nombre d’éléments d’un CarouselView. Pour plus d’informations, consultez IndicatorView.
Label Label affiche du texte sur une seule ligne et sur plusieurs lignes. Pour plus d’informations, consultez Label.
Line Line affiche une ligne d’un point de départ jusqu’à un point d’arrivée. Pour plus d’informations, consultez Line.
ListView ListView affiche une liste avec défilement contenant des éléments de données sélectionnables. Pour plus d’informations, consultez ListView.
Map Map affiche une carte et nécessite l’installation du package NuGet Microsoft.Maui.Controls.Maps dans votre application.
Path Path affiche des courbes et des formes complexes. Pour plus d’informations, consultez Path.
Picker Picker affiche une courte liste d’éléments, dans laquelle un élément peut être sélectionné. Pour plus d’informations, consultez Picker.
Polygon Polygon affiche un polygone. Pour plus d’informations, consultez Polygon.
Polyline Polyline affiche une série de lignes droites connectées. Pour plus d’informations, consultez Polyline.
ProgressBar ProgressBar utilise une animation pour montrer que l’application progresse dans une activité de longue durée. Pour plus d’informations, consultez ProgressBar.
RadioButton RadioButton est un type de bouton qui permet de sélectionner une option dans un ensemble. Pour plus d’informations, consultez RadioButton.
Rectangle Rectangle affiche un rectangle ou un carré. Pour plus d’informations, consultez Rectangle.
RefreshView RefreshView est un contrôle conteneur qui fournit une fonctionnalité « balayer pour actualiser » pour du contenu avec défilement. Pour plus d’informations, consultez RefreshView.
RoundRectangle RoundRectangle affiche un rectangle ou un carré avec des angles arrondis. Pour plus d’informations, consultez Rectangle.
ScrollView ScrollView fournit un défilement pour son contenu, qui est généralement une disposition. Pour plus d’informations, consultez ScrollView.
SearchBar SearchBar est un contrôle d’entrée utilisateur utilisé pour lancer une recherche. Pour plus d’informations, consultez SearchBar.
Slider Slider vous permet de sélectionner une valeur double dans une plage continue. Pour plus d’informations, consultez Slider.
Stepper Stepper vous permet de sélectionner une valeur double dans une plage de valeurs incrémentielles. Pour plus d’informations, consultez Stepper.
SwipeView SwipeView est un contrôle conteneur qui encapsule un élément de contenu et fournit des éléments de menu contextuel qui se révèlent avec un mouvement de balayage. Pour plus d’informations, consultez SwipeView.
Switch Switch vous permet de sélectionner une valeur booléenne à l’aide d’un type de bouton qui peut être activé ou désactivé. Pour plus d’informations, consultez Switch.
TableView TableView affiche un tableau d’éléments avec défilement que vous pouvez regrouper en sections. Pour plus d’informations, consultez TableView.
TimePicker TimePicker vous permet de sélectionner une heure avec le sélecteur d’horaires de la plateforme. Pour plus d’informations, consultez TimePicker.
TwoPaneView TwoPaneView représente un conteneur avec deux vues qui ajustent la dimension et la position de leur contenu dans l’espace disponible, soit côte à côte, soit de haut en bas. Pour plus d’informations, consultez TwoPaneView.
WebView WebView affiche des pages web ou du contenu HTML local. Pour plus d’informations, consultez WebView.