Controles

Navegue pelo exemplo

A interface do usuário de um aplicativo .NET Multi-Platform App UI (.NET MAUI) é construída de objetos que mapeiam para os controles nativos de cada plataforma de destino.

Os principais grupos de controle usados para criar a interface do usuário de um aplicativo .NET MAUI são páginas, layouts e modos de exibição. Uma página .NET Maui geralmente ocupa a tela inteira ou janela. A página geralmente contém um layout, que contém exibições e possivelmente outros layouts. Páginas, layouts e modos de exibição derivam da VisualElement classe. Essa classe fornece uma variedade de propriedades, métodos e eventos que são úteis em classes derivadas.

Observação

ListView e TableView também apoiar o uso de células. As células são elementos especializados usados para itens em uma tabela, que descrevem como cada item deve ser renderizado.

Páginas

Os aplicativos .NET MAUI consistem em uma ou mais páginas. Uma página geralmente ocupa toda a tela, ou janela, e cada página normalmente contém pelo menos um layout.

.NET MAUI contém as seguintes páginas:

Página	Descrição
ContentPage	ContentPage exibe um único modo de exibição e é o tipo de página mais comum. Para obter mais informações, consulte ContentPage.
FlyoutPage	FlyoutPage é uma página que gerencia duas páginas relacionadas de informações – uma página de submenu que apresenta itens e uma página de detalhes que apresenta detalhes sobre itens na página de submenu. Para obter mais informações, consulte FlyoutPage.
NavigationPage	NavigationPage fornece uma experiência de navegação hierárquica onde você pode navegar pelas páginas, para frente e para trás, conforme desejado. Para obter mais informações, consulte NavigationPage.
TabbedPage	TabbedPage consiste em uma série de páginas que são navegáveis por guias na parte superior ou inferior da página, com cada guia carregando o conteúdo da página. Para obter mais informações, consulte TabbedPage.

Layouts

Os layouts do .NET MAUI são usados para compor controles de interface do usuário em estruturas visuais, e cada layout normalmente contém vários modos de exibição. As classes de layout normalmente contêm lógica para definir a posição e o tamanho dos elementos filho.

.NET MAUI contém os seguintes layouts:

Layout	Descrição
AbsoluteLayout	AbsoluteLayout posiciona elementos filho em locais específicos em relação ao pai. Para obter mais informações, consulte AbsoluteLayout.
BindableLayout	BindableLayout Permite que qualquer classe de layout gere seu conteúdo vinculando a uma coleção de itens, com a opção de definir a aparência de cada item. Para obter mais informações, consulte BindableLayout.
FlexLayout	FlexLayout permite que seus filhos sejam empilhados ou envolvidos com diferentes opções de alinhamento e orientação. FlexLayouté baseado no CSS Flexible Box Layout Module, conhecido como layout flex ou flex-box. Para obter mais informações, consulte FlexLayout.
Grid	Grid Posiciona seus elementos filho em uma grade de linhas e colunas. Para obter mais informações, consulte Grade.
HorizontalStackLayout	HorizontalStackLayout posiciona elementos filho em uma pilha horizontal. Para obter mais informações, consulte HorizontalStackLayout.
StackLayout	StackLayout posiciona elementos filho em uma pilha vertical ou horizontal. Para obter mais informações, consulte StackLayout.
VerticalStackLayout	VerticalStackLayout Posiciona elementos filho em uma pilha vertical. Para obter mais informações, consulte VerticalStackLayout.

Exibições

Os modos de exibição MAUI do .NET são os objetos da interface do usuário, como rótulos, botões e controles deslizantes, que são comumente conhecidos como controles ou widgets em outros ambientes.

.NET MAUI contém os seguintes modos de exibição:

Visualizar	Descrição
ActivityIndicator	ActivityIndicator usa uma animação para mostrar que o aplicativo está envolvido em uma atividade longa, sem dar qualquer indicação de progresso. Para obter mais informações, consulte ActivityIndicator.
BlazorWebView	BlazorWebView permite que você hospede um aplicativo Web Blazor em seu aplicativo .NET MAUI. Para obter mais informações, consulte BlazorWebView.
Border	Border é um controle de contêiner que desenha uma borda, plano de fundo, ou ambos, em torno de outro controle. Para obter mais informações, consulte Borda.
BoxView	BoxView desenha um retângulo ou quadrado, de uma largura, altura e cor especificadas. Para obter mais informações, consulte BoxView.
Button	Button exibe texto e responde a um toque ou clique que direciona um aplicativo para executar uma tarefa. Para obter mais informações, consulte Botão.
CarouselView	CarouselView Exibe uma lista rolável de itens de dados, onde os usuários passam o dedo para percorrer a coleção. Para obter mais informações, consulte CarouselView.
CheckBox	CheckBox Permite que você selecione um valor booleano usando um tipo de botão que pode ser marcado ou vazio. Para obter mais informações, consulte CheckBox.
CollectionView	CollectionView Exibe uma lista rolável de itens de dados selecionáveis, usando especificações de layout diferentes. Para obter mais informações, consulte CollectionView.
ContentView	ContentView é um controle que permite a criação de controles personalizados e reutilizáveis. Para obter mais informações, consulte ContentView.
DatePicker	DatePicker Permite que você selecione uma data com o seletor de data da plataforma. Para obter mais informações, consulte DatePicker.
Editor	Editor Permite inserir e editar várias linhas de texto. Para obter mais informações, consulte Editor.
Ellipse	Ellipse exibe uma elipse ou círculo. Para obter mais informações, consulte Elipse.
Entry	Entry Permite inserir e editar uma única linha de texto. Para obter mais informações, consulte Entrada.
Frame	Frame é usado para encapsular um modo de exibição ou layout com uma borda que pode ser configurada com cor, sombra e outras opções. Para obter mais informações, consulte Quadro.
GraphicsView	GraphicsView é uma tela de gráficos na qual gráficos 2D podem ser desenhados usando tipos do Microsoft.Maui.Graphics namespace. Para obter mais informações, consulte GraphicsView.
Image	Image exibe uma imagem que pode ser carregada de um arquivo local, um URI, um recurso incorporado ou um fluxo. Para obter mais informações, consulte Imagem.
ImageButton	ImageButton exibe uma imagem e responde a um toque ou clique que direciona um aplicativo para executar uma tarefa. Para obter mais informações, consulte ImageButton.
IndicatorView	IndicatorView Exibe indicadores que representam o número de itens em um CarouselViewarquivo . Para obter mais informações, consulte IndicatorView.
Label	Label Exibe texto de linha única e de várias linhas. Para obter mais informações, consulte Rótulo.
Line	Line Exibe uma linha de um ponto inicial a um ponto final. Para obter mais informações, consulte Linha.
ListView	ListView Exibe uma lista rolável de itens de dados selecionáveis. Para obter mais informações, consulte ListView.
Map	Mapexibe um mapa e requer que o pacote NuGet Microsoft.Maui.Controls.Maps seja instalado em seu aplicativo.
Path	Path exibir curvas e formas complexas. Para obter mais informações, consulte Caminho.
Picker	Picker Exibe uma pequena lista de itens, a partir da qual um item pode ser selecionado. Para obter mais informações, consulte Selecionador.
Polygon	Polygon exibe um polígono. Para obter mais informações, consulte Polígono.
Polyline	Polyline exibe uma série de linhas retas conectadas. Para obter mais informações, consulte Polyline.
ProgressBar	ProgressBar usa uma animação para mostrar que o aplicativo está progredindo em uma atividade longa. Para obter mais informações, consulte ProgressBar.
RadioButton	RadioButton é um tipo de botão que permite a seleção de uma opção de um conjunto. Para obter mais informações, consulte RadioButton.
Rectangle	Rectangle Exibe um retângulo ou quadrado. Para obter mais informações, consulte Retângulo.
RefreshView	RefreshView é um controle de contêiner que fornece funcionalidade pull-to-refresh para conteúdo rolável. Para obter mais informações, consulte RefreshView.
RoundRectangle	RoundRectangle Exibe um retângulo ou quadrado com cantos arredondados. Para obter mais informações, consulte Retângulo.
ScrollView	ScrollView fornece rolagem de seu conteúdo, que normalmente é um layout. Para obter mais informações, consulte ScrollView.
SearchBar	SearchBar é um controle de entrada do usuário usado para iniciar uma pesquisa. Para obter mais informações, consulte SearchBar.
Slider	Slider Permite selecionar um valor de um double intervalo contínuo. Para obter mais informações, consulte Controle deslizante.
Stepper	Stepper Permite selecionar um valor de um double intervalo de valores incrementais. Para obter mais informações, consulte Stepper.
SwipeView	SwipeView é um controle de contêiner que envolve um item de conteúdo e fornece itens de menu de contexto que são revelados por um gesto de passar o dedo. Para obter mais informações, consulte SwipeView.
Switch	Switch Permite que você selecione um valor booleano usando um tipo de botão que pode estar ativado ou desativado. Para mais informações, confira switch.
TableView	TableView Exibe uma tabela de itens roláveis que podem ser agrupados em seções. Para obter mais informações, consulte TableView.
TimePicker	TimePicker Permite que você selecione um horário com o seletor de tempo da plataforma. Para obter mais informações, consulte TimePicker.
TwoPaneView	TwoPaneView Representa um contêiner com dois modos de exibição que dimensionam e posicionam seu conteúdo no espaço disponível, lado a lado ou de cima para baixo. Para obter mais informações, consulte TwoPaneView.
WebView	WebView exibe páginas da Web ou conteúdo HTML local. Para obter mais informações, consulte WebView.