Contrôles
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. |