Controlli

Esplorare l'esempio

L'interfaccia utente di un'app .NET multipiattaforma (.NET MAUI) viene creata da oggetti che eseguono il mapping ai controlli nativi di ogni piattaforma di destinazione.

I gruppi di controllo principali usati per creare l'interfaccia utente di un'app MAUI .NET sono pagine, layout e visualizzazioni. Una pagina MAUI .NET occupa in genere lo schermo intero o la finestra. La pagina contiene in genere un layout, che contiene visualizzazioni ed eventualmente altri layout. Le pagine, i layout e le visualizzazioni derivano dalla VisualElement classe . Questa classe fornisce un'ampia gamma di proprietà, metodi ed eventi utili nelle classi derivate.

Nota

ListView e TableView supportano anche l'uso di celle. Le celle sono elementi specializzati utilizzati per gli elementi di una tabella, che descrivono come eseguire il rendering di ogni elemento.

Pagine

Le app MAUI .NET sono costituite da una o più pagine. Una pagina occupa in genere tutto lo schermo o la finestra e ogni pagina contiene in genere almeno un layout.

.NET MAUI contiene le pagine seguenti:

Pagina	Descrizione
ContentPage	ContentPage visualizza una singola visualizzazione ed è il tipo di pagina più comune. Per altre informazioni, vedere ContentPage.
FlyoutPage	FlyoutPage è una pagina che gestisce due pagine correlate di informazioni, ovvero una pagina a comparsa che presenta elementi e una pagina di dettaglio che presenta dettagli sugli elementi nella pagina a comparsa. Per altre informazioni, vedere FlyoutPage.
NavigationPage	NavigationPage offre un'esperienza di spostamento gerarchica in cui è possibile spostarsi tra pagine, avanti e indietro, come desiderato. Per altre informazioni, vedere NavigationPage.
TabbedPage	TabbedPage è costituito da una serie di pagine navigabili in base alle schede nella parte superiore o inferiore della pagina, con ogni scheda che carica il contenuto della pagina. Per altre informazioni, vedere TabbedPage.

Layout

I layout MAUI .NET vengono usati per comporre controlli dell'interfaccia utente in strutture visive e ogni layout contiene in genere più visualizzazioni. Le classi di layout in genere contengono logica per impostare la posizione e le dimensioni degli elementi figlio.

.NET MAUI contiene i layout seguenti:

Layout	Descrizione
AbsoluteLayout	AbsoluteLayout posiziona gli elementi figlio in posizioni specifiche rispetto al relativo elemento padre. Per altre informazioni, vedere AbsoluteLayout.
BindableLayout	BindableLayout consente a qualsiasi classe di layout di generare il contenuto associandolo a una raccolta di elementi, con l'opzione per impostare l'aspetto di ogni elemento. Per altre informazioni, vedere BindableLayout.
FlexLayout	FlexLayout consente agli elementi figlio di essere impilati o avvolti con opzioni di allineamento e orientamento diverse. FlexLayout si basa su CSS Flexible Box Layout Module, noto come flex layout o flex-box. Per altre informazioni, vedere FlexLayout.
Grid	Grid posiziona i relativi elementi figlio in una griglia di righe e colonne. Per altre informazioni, vedere Grid.
HorizontalStackLayout	HorizontalStackLayout posiziona gli elementi figlio in uno stack orizzontale. Per altre informazioni, vedere HorizontalStackLayout.
StackLayout	StackLayout posiziona gli elementi figlio in uno stack verticale o orizzontale. Per altre informazioni, vedere StackLayout.
VerticalStackLayout	VerticalStackLayout posiziona gli elementi figlio in uno stack verticale. Per altre informazioni, vedere VerticalStackLayout.

Visualizzazioni

Le visualizzazioni MAUI .NET sono gli oggetti dell'interfaccia utente, ad esempio etichette, pulsanti e dispositivi di scorrimento comunemente noti come controlli o widget in altri ambienti.

.NET MAUI contiene le visualizzazioni seguenti:

Visualizza	Descrizione
ActivityIndicator	ActivityIndicator usa un'animazione per mostrare che l'app è impegnata in un'attività lunga, senza fornire alcuna indicazione dello stato di avanzamento. Per altre informazioni, vedere ActivityIndicator.
BlazorWebView	BlazorWebView consente di ospitare un'app Web Blazor nell'app MAUI .NET. Per altre informazioni, vedere BlazorWebView.
Border	Border è un controllo contenitore che disegna un bordo, uno sfondo o entrambi intorno a un altro controllo. Per altre informazioni, vedere Border.
BoxView	BoxView disegna un rettangolo o un quadrato, di una larghezza, un'altezza e un colore specificati. Per altre informazioni, vedere BoxView.
Button	Button visualizza testo e risponde a un tocco o a un clic che indirizza un'app a eseguire un'attività. Per altre informazioni, vedere Pulsante.
CarouselView	CarouselView visualizza un elenco scorrevole di elementi di dati, in cui gli utenti scorrono rapidamente per spostarsi nella raccolta. Per altre informazioni, vedere CarouselView.
CheckBox	CheckBox consente di selezionare un valore booleano usando un tipo di pulsante che può essere selezionato o vuoto. Per altre informazioni, vedere CheckBox.
CollectionView	CollectionView visualizza un elenco scorrevole di elementi di dati selezionabili, usando specifiche di layout diverse. Per altre informazioni, vedere CollectionView.
ContentView	ContentView è un controllo che consente la creazione di controlli personalizzati riutilizzabili. Per altre informazioni, vedere ContentView.
DatePicker	DatePicker consente di selezionare una data con la selezione data della piattaforma. Per altre informazioni, vedere DatePicker.
Editor	Editor consente di immettere e modificare più righe di testo. Per altre informazioni, vedere Editor.
Ellipse	Ellipse visualizza un'ellisse o un cerchio. Per altre informazioni, vedere Ellipse.
Entry	Entry consente di immettere e modificare una singola riga di testo. Per altre informazioni, vedere Voce.
Frame	Frame viene utilizzato per eseguire il wrapping di una visualizzazione o di un layout con un bordo che può essere configurato con colore, ombreggiatura e altre opzioni. Per altre informazioni, vedere Frame.
GraphicsView	GraphicsView è un'area di disegno grafica in cui è possibile disegnare grafica 2D usando i tipi dello spazio dei Microsoft.Maui.Graphics nomi. Per altre informazioni, vedere GraphicsView.
Image	Image visualizza un'immagine che può essere caricata da un file locale, un URI, una risorsa incorporata o un flusso. Per altre informazioni, vedere Immagine.
ImageButton	ImageButton visualizza un'immagine e risponde a un tocco o a un clic che indirizza un'app per eseguire un'attività. Per altre informazioni, vedere ImageButton.
IndicatorView	IndicatorView visualizza gli indicatori che rappresentano il numero di elementi in un oggetto CarouselView. Per altre informazioni, vedere IndicatorView.
Label	Label visualizza testo a riga singola e a più righe. Per altre informazioni, vedere Etichetta.
Line	Line visualizza una linea da un punto iniziale a un punto finale. Per altre informazioni, vedere Line.
ListView	ListView visualizza un elenco scorrevole di elementi di dati selezionabili. Per altre informazioni, vedere ListView.
Map	Map visualizza una mappa e richiede l'installazione del pacchetto NuGet Microsoft.Maui.Controls.Maps nell'app.
Path	Path curve di visualizzazione e forme complesse. Per altre informazioni, vedere Percorso.
Picker	Picker visualizza un breve elenco di elementi, da cui è possibile selezionare un elemento. Per altre informazioni, vedere Selezione.
Polygon	Polygon visualizza un poligono. Per altre informazioni, vedere Polygon.
Polyline	Polyline visualizza una serie di linee rette collegate. Per altre informazioni, vedere Polyline.
ProgressBar	ProgressBar usa un'animazione per mostrare che l'app sta procedendo attraverso un'attività lunga. Per altre informazioni, vedere ProgressBar.
RadioButton	RadioButton è un tipo di pulsante che consente la selezione di un'opzione da un set. Per altre informazioni, vedere RadioButton.
Rectangle	Rectangle visualizza un rettangolo o un quadrato. Per altre informazioni, vedere Rectangle.
RefreshView	RefreshView è un controllo contenitore che fornisce funzionalità di aggiornamento pull-to-refresh per il contenuto scorrevole. Per altre informazioni, vedere RefreshView.
RoundRectangle	RoundRectangle visualizza un rettangolo o un quadrato con angoli arrotondati. Per altre informazioni, vedere Rectangle.
ScrollView	ScrollView fornisce lo scorrimento del contenuto, che in genere è un layout. Per altre informazioni, vedere ScrollView.
SearchBar	SearchBar è un controllo di input utente usato per avviare una ricerca. Per altre informazioni, vedere SearchBar.
Slider	Slider consente di selezionare un double valore da un intervallo continuo. Per altre informazioni, vedere Slider.
Stepper	Stepper consente di selezionare un double valore da un intervallo di valori incrementali. Per altre informazioni, vedere Stepper.
SwipeView	SwipeView è un controllo contenitore che esegue il wrapping di un elemento del contenuto e fornisce voci di menu di scelta rapida rivelate da un movimento di scorrimento rapido. Per altre informazioni, vedere SwipeView.
Switch	Switch consente di selezionare un valore booleano usando un tipo di pulsante che può essere attivato o disattivato. Per altre informazioni, vedere switch.
TableView	TableView visualizza una tabella di elementi scorrevoli che possono essere raggruppati in sezioni. Per altre informazioni, vedere TableView.
TimePicker	TimePicker consente di selezionare un'ora con la selezione ora della piattaforma. Per altre informazioni, vedere TimePicker.
TwoPaneView	TwoPaneView rappresenta un contenitore con due visualizzazioni che ridimensionano e posizionano il contenuto nello spazio disponibile, affiancato o dall'alto verso il basso. Per altre informazioni, vedere TwoPaneView.
WebView	WebView visualizza le pagine Web o il contenuto HTML locale. Per altre informazioni, vedere WebView.