Xamarin.Forms Affichage

Télécharger l’exemple Télécharger l’exemple

Xamarin.Forms les vues sont les blocs de construction des interfaces utilisateur mobiles multiplateformes.

Les vues sont des objets d’interface utilisateur tels que des étiquettes, des boutons et des curseurs qui sont communément appelés contrôles ou widgets dans d’autres environnements de programmation graphique. Les vues prises en charge par Xamarin.Forms tous dérivent de la View classe . Ils peuvent être divisés en plusieurs catégories :

Affichages pour la présentation

Type Description Apparence
BoxView BoxView affiche un rectangle unie coloré par la Color propriété . BoxView a une demande de taille par défaut de 40 x 40. Pour les autres tailles, affectez les WidthRequest propriétés et HeightRequest .

Documentation sur l’API / Guide / Échantillon 1, 2, 3, 4, 5 et 6
BoxView Example
Code C# pour cette page / Page XAML
Ellipse Ellipse affiche une ellipse ou un cercle de taille WidthRequest x HeightRequest. Pour peindre l’intérieur de l’ellipse, définissez sa Fill propriété sur .Color Pour donner un contour à l’ellipse, définissez sa Stroke propriété sur un Color.

Documentation sur l’API / Guide / Échantillon
Ellipse Exemple
Code C# pour cette page / Page XAML
Label Label affiche des chaînes de texte sur une seule ligne ou des blocs de texte sur plusieurs lignes, avec une mise en forme constante ou variable. Définissez la propriété sur Text une chaîne pour la mise en forme constante, ou définissez la FormattedText propriété sur un FormattedString objet pour la mise en forme des variables.

Documentation sur l’API / Guide / Échantillon
d’étiquette Exemple d’étiquette Exemple
Code C# pour cette page / Page XAML
Line Line affiche une ligne d’un point de départ à un point d’extrémité. Le point de départ est représenté par les X1 propriétés et Y1 , tandis que le point de terminaison est représenté par les X2 propriétés et Y2 . Pour colorer la ligne, définissez sa Stroke propriété sur .Color

Documentation sur l’API / Guide / Échantillon
ligne Exemple de ligne Exemple
Code C# pour cette page / Page XAML
Image Image affiche une bitmap. Les bitmaps peuvent être téléchargées sur le Web, incorporées en tant que ressources dans les projets de plateforme ou de projet communs, ou créées à l’aide d’un objet .NET Stream .

Documentation sur l’API / Guide / Échantillon
d’image Exemple
Code C# pour cette page / Page XAML
Map Map affiche une carte. .Xamarin.Forms Le package NuGet Maps doit être installé. Android et plateforme Windows universelle nécessitent une clé d’autorisation de carte.

Documentation sur l’API / Guide / Échantillon
carte Exemple de carte Exemple
Code C# pour cette page / Page XAML
OpenGLView OpenGLView affiche des graphiques OpenGL dans les projets iOS et Android. La plateforme Windows universelle n’est pas prise en charge. Les projets iOS et Android nécessitent une référence à l’assembly OpenTK-1.0 ou à l’assembly OpenTK version 1.0.0.0. OpenGLView est plus facile à utiliser dans un projet partagé ; s’il est utilisé dans une bibliothèque .NET Standard, un service de dépendances est également requis (comme indiqué dans l’exemple de code).

Il s’agit de la seule fonctionnalité graphique intégrée à Xamarin.Forms, mais une Xamarin.Forms application peut également afficher des graphiques à l’aide de SkiaSharp, ou UrhoSharp.

Documentation de l’API

OpenGLView Exemple
Code C# pour cette page / Page XAML avec code-behind
Path Path affiche des courbes et des formes complexes. La Data propriété spécifie la forme à dessiner. Pour colorer la forme, définissez sa Stroke propriété sur .Color

Documentation sur l’API / Guide / Échantillon
chemin d’accès Exemple
Code C# pour cette page / Page XAML
Polygon Polygon affiche un polygone. La Points propriété spécifie les points de vertex du polygone, tandis que la FillRule propriété spécifie comment le remplissage intérieur du polygone est déterminé. Pour peindre l’intérieur du polygone, définissez sa Fill propriété sur .Color Pour donner au polygone un plan, définissez sa Stroke propriété sur .Color

Documentation sur l’API / Guide / Échantillon
polygone Exemple de polygone Exemple
Code C# pour cette page / Page XAML
Polyline Polyline affiche une série de lignes droites connectées. La Points propriété spécifie les points de vertex de la polyligne, tandis que la FillRule propriété spécifie comment le remplissage intérieur de la polyligne est déterminé. Pour peindre l’intérieur de la polyligne, définissez sa Fill propriété sur .Color Pour donner au polyligne un contour, définissez sa Stroke propriété sur .Color

Documentation sur l’API / Guide / Échantillon
Exemple polyligne
Code C# pour cette page / Page XAML
Rectangle Rectangle affiche un rectangle ou un carré. Pour peindre l’intérieur du rectangle, définissez sa Fill propriété sur .Color Pour donner au rectangle un plan, définissez sa Stroke propriété sur un Color.

Documentation sur l’API / Guide / Échantillon
rectangle Exemple de rectangle Exemple
Code C# pour cette page / Page XAML
WebView WebView affiche des pages web ou du contenu HTML, selon que la Source propriété est définie sur un UriWebViewSource objet ou un HtmlWebViewSource objet .

Documentation sur l’API / Guide / Échantillon 1 et 2
Exemple WebView Exemple
Code C# pour cette page / Page XAML

Affichages lançant des commandes

Type Description Apparence
Button Button est un objet rectangulaire qui affiche du texte et qui déclenche un Clicked événement quand il a été appuyé.

Documentation sur l’API / Guide / Échantillon
de bouton Exemple
Code C# pour cette page / Page XAML avec code-behind
ImageButton ImageButton est un objet rectangulaire qui affiche une image et qui déclenche un Clicked événement lorsqu’il a été appuyé.

Documentation sur l’API / Guide / Échantillon
ImageButton Exemple
Code C# pour cette page / Page XAML avec code-behind
RadioButton RadioButton autorise la sélection d’une option à partir d’un ensemble et déclenche un CheckedChanged événement lorsque la sélection se produit.

Documentation sur l’API / Guide / Échantillon
RadioButton Exemple
Code C# pour cette page / Page XAML avec code-behind
RefreshView RefreshView est un contrôle de conteneur qui fournit une fonctionnalité d’extraction pour actualiser du contenu pouvant faire défiler. Le ICommand défini par la Command propriété est exécuté lorsqu’une actualisation est déclenchée, et la IsRefreshing propriété indique l’état actuel du contrôle.

Documentation sur l’API / Guide / Échantillon
Exemple RefreshView Exemple
Code C# pour cette page / Page XAML avec code-behind
SearchBar SearchBar affiche une zone permettant à l’utilisateur de taper une chaîne de texte et un bouton (ou une touche clavier) qui indique à l’application d’effectuer une recherche. La Text propriété permet d’accéder au texte, et l’événement SearchButtonPressed indique que le bouton a été appuyé.

Documentation sur l’API / Guide / Échantillon
SearchBar Example SearchBar Example
Code C# pour cette page / Page XAML avec code-behind
SwipeView SwipeView est un contrôle de conteneur qui encapsule un élément de contenu et fournit des éléments de menu contextuel qui sont révélés par un mouvement de balayage. Chaque élément de menu est représenté par un SwipeItem, qui a une Command propriété qui exécute un ICommand lorsque l’élément est appuyé.

Documentation sur l’API / Guide / Échantillon
SwipeView Exemple
Code C# pour cette page / Page XAML avec code-behind

Affichages pour les valeurs des paramètres

Type Description Apparence
CheckBox CheckBox permet à l’utilisateur de sélectionner une valeur booléenne à l’aide d’un type de bouton qui peut être activé ou vide. La IsChecked propriété est l’état de , CheckBoxet l’événement CheckedChanged est déclenché lorsque l’état change.

Documentation sur l’API / Guide / Échantillon
CheckBox Exemple CheckBox Exemple
Code C# pour cette page / Page XAML
Slider Slider permet à l’utilisateur de sélectionner une double valeur à partir d’une plage continue spécifiée avec les Minimum propriétés et Maximum .

Documentation sur l’API / Guide / Échantillon
curseur Exemple de curseur Exemple
Code C# pour cette page / Page XAML
Stepper Stepper permet à l’utilisateur de sélectionner une double valeur à partir d’une plage de valeurs incrémentielles spécifiées avec les Minimumpropriétés , Maximumet Increment .

Documentation sur l’API / Guide / Échantillon
de stepper Exemple
Code C# pour cette page / Page XAML
Switch Switch prend la forme d’un commutateur activé/désactivé pour permettre à l’utilisateur de sélectionner une valeur booléenne. La IsToggled propriété est l’état du commutateur, et l’événement Toggled est déclenché lorsque l’état change.

Documentation sur l’API / Guide / Échantillon
commutateur Exemple de
Code C# pour cette page / Page XAML
DatePicker DatePicker permet à l’utilisateur de sélectionner une date avec le sélecteur de dates de plateforme. Définissez une plage de dates autorisées avec les MinimumDate propriétés et MaximumDate . La Date propriété est la date sélectionnée, et l’événement DateSelected est déclenché lorsque cette propriété change.

Documentation sur l’API / Guide / Échantillon
Exemple DatePicker Exemple
Code C# pour cette page / Page XAML
TimePicker TimePicker permet à l’utilisateur de sélectionner une heure avec le sélecteur de temps de plateforme. La Time propriété est l’heure sélectionnée. Une application peut surveiller les modifications apportées à la Time propriété en installant un gestionnaire pour l’événement PropertyChanged .

Documentation sur l’API / Guide / Échantillon
TimePicker Exemple
Code C# pour cette page / Page XAML

Affichages pour la modification de texte

Ces deux classes dérivent de la InputView classe , qui définit la Keyboard propriété :

Type Description Apparence
Entry Entry permet à l’utilisateur d’entrer et de modifier une seule ligne de texte. Le texte est disponible en tant que Text propriété, et les TextChanged événements et Completed sont déclenchés lorsque le texte change ou que l’utilisateur signale l’achèvement en appuyant sur la touche Entrée.

Utilisez un Editor pour entrer et modifier plusieurs lignes de texte.

Documentation sur l’API / Guide / Échantillon
d’entrée Exemple d’entrée Exemple
Code C# pour cette page / Page XAML
Editor Editor permet à l’utilisateur d’entrer et de modifier plusieurs lignes de texte. Le texte est disponible en tant que Text propriété, et les TextChanged événements et Completed sont déclenchés lorsque le texte change ou que l’utilisateur signale l’achèvement.

Utilisez une Entry vue pour entrer et modifier une seule ligne de texte.

Documentation sur l’API / Guide / Échantillon
d’éditeur Exemple
Code C# pour cette page / Page XAML

Affichages pour indiquer une activité

Type Description Apparence
ActivityIndicator ActivityIndicator utilise une animation pour montrer que l’application est engagée dans une activité longue sans donner d’indication de progression. La IsRunning propriété contrôle l’animation.

Si la progression de l’activité est connue, utilisez un ProgressBar à la place.

Documentation sur l’API / Guide / Échantillon
ActivityIndicator Example
Code C# pour cette page / Page XAML
ProgressBar ProgressBar utilise une animation pour montrer que l’application progresse dans une activité de longue durée. Définissez la Progress propriété sur des valeurs comprises entre 0 et 1 pour indiquer la progression.

Si la progression de l’activité n’est pas connue, utilisez un ActivityIndicator à la place.

Documentation sur l’API / Guide / Échantillon
Exemple ProgressBar Exemple
Code C# pour cette page / Page XAML avec code-behind

Affichages qui montrent des collections

Type Description Apparence
CarouselView CarouselView affiche une liste défilante d’éléments de données. Définissez la ItemsSource propriété sur une collection d’objets et définissez la ItemTemplate propriété sur un DataTemplate objet décrivant comment les éléments doivent être mis en forme. L’événement CurrentItemChanged indique que l’élément actuellement affiché a changé, qui est disponible en tant que CurrentItem propriété .

Guide / Échantillon
CarouselView Example
Code C# pour cette page / Page XAML
CollectionView CollectionView affiche une liste défilable d’éléments de données sélectionnables, à l’aide de différentes spécifications de disposition. Il vise à fournir une alternative plus flexible et performante à ListView. Définissez la ItemsSource propriété sur une collection d’objets et définissez la ItemTemplate propriété sur un DataTemplate objet décrivant comment les éléments doivent être mis en forme. L’événement SelectionChanged indique qu’une sélection a été effectuée, qui est disponible en tant que SelectedItem propriété .

Guide / Échantillon
de collectionAfficher l’exemple
Code C# pour cette page / Page XAML
IndicatorView IndicatorView affiche des indicateurs qui représentent le nombre d’éléments dans un CarouselView. Définissez la CarouselView.IndicatorView propriété sur l’objet IndicatorView pour afficher les indicateurs pour le CarouselView.

Documentation sur l’API / Guide / Échantillon
IndicatorView Exemple
Code C# pour cette page / Page XAML
ListView ListView dérive de ItemsView et affiche une liste défilante d’éléments de données sélectionnables. Définissez la ItemsSource propriété sur une collection d’objets et définissez la ItemTemplate propriété sur un DataTemplate objet décrivant comment les éléments doivent être mis en forme. L’événement ItemSelected indique qu’une sélection a été effectuée, qui est disponible en tant que SelectedItem propriété.

Documentation sur l’API / Guide / Échantillon
ListView Exemple
Code C# pour cette page / Page XAML
Picker Picker affiche un élément sélectionné à partir d’une liste de chaînes de texte et autorise la sélection de cet élément lorsque l’affichage est appuyé. Définissez la Items propriété sur une liste de chaînes ou la ItemsSource propriété sur une collection d’objets. L’événement SelectedIndexChanged est déclenché lorsqu’un élément est sélectionné.

affiche Picker la liste des éléments uniquement lorsqu’il est sélectionné. Utilisez un ListView ou TableView pour une liste défilante qui reste sur la page.

Documentation sur l’API / Guide
de sélecteur Exemple
Code C# pour cette page / Page XAML avec code-behind
TableView TableView affiche une liste de lignes de type Cell avec des en-têtes et des sous-têtes facultatifs. Définissez la Root propriété sur un objet de type TableRoot, puis ajoutez TableSection des objets à ce .TableRoot Il s’agit TableSection d’une collection d’objets Cell .

Documentation sur l’API / Guide / Échantillon
TableView Example Example
Code C# pour cette page / Page XAML