Controles

Procurar no exemplo

A interface do usuário de um aplicativo .NET MULTI-platform App UI (.NET MAUI) é construída de objetos que são mapeados 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 exibições. Uma página do .NET MAUI geralmente ocupa a tela inteira ou a janela. A página geralmente contém um layout, que contém exibições e possivelmente outros layouts. Páginas, layouts e exibições derivam da classe VisualElement. 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 dão suporte ao 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.

Pages (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.

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

Página	Descrição
ContentPage	ContentPage exibe uma única visualização e é o tipo de página mais comum. Para obter mais informações, confira ContentPage.
FlyoutPage	FlyoutPage é uma página que gerencia duas páginas de informações relacionadas — uma página mestra que apresenta itens e uma página de detalhes que apresenta detalhes sobre os itens na página mestra. Para obter mais informações, consulte FlyoutPage.
NavigationPage	NavigationPage oferece uma experiência de navegação hierárquica em que o usuário é capaz de 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 podem ser navegadas 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árias exibições. As classes de layout normalmente contêm lógica para definir a posição e o tamanho dos elementos derivados.

O .NET MAUI contém os seguintes layouts:

Layout	Descrição
AbsoluteLayout	AbsoluteLayout posiciona elementos derivados em locais específicos em relação ao principal. Para obter mais informações, consulte AbsoluteLayout.
BindableLayout	BindableLayout permite que as classes de layout gerem seu conteúdo associando-se 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 embrulhados com diferentes opções de alinhamento e orientação. FlexLayout é baseado no módulo de layout de caixa flexível CSS, conhecido como layout flexível ou flex-box. Para obter mais informações, consulte FlexLayout.
Grid	Grid posiciona seus elementos derivados em uma grade de linhas e colunas. Para obter mais informações, consulte Grade.
HorizontalStackLayout	HorizontalStackLayout posiciona elementos derivados em uma pilha horizontal. Para obter mais informações, consulte HorizontalStackLayout.
StackLayout	StackLayout posiciona elementos derivados em uma pilha vertical ou horizontal. Para obter mais informações, consulte StackLayout.
VerticalStackLayout	VerticalStackLayout posiciona elementos derivados em uma pilha vertical. Para obter mais informações, consulte VerticalStackLayout.

Exibições

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

O .NET MAUI contém as seguintes exibições:

Visualizar	Descrição
ActivityIndicator	ActivityIndicator usa uma animação para mostrar que o aplicativo está envolvido em uma atividade longa, sem dar nenhuma indicação de progresso. Para obter mais informações, consulte ActivityIndicator.
BlazorWebView	BlazorWebView permite hospedar um aplicativo Web Blazor no 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, ao redor de outro controle. Para obter mais informações, consulte Borda.
BoxView	BoxView desenha um retângulo ou quadrado, de 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 realizar 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 selecionar um valor booleano usando um tipo de botão que pode ser marcado ou vazio. Para obter mais informações, consulte Caixa de seleção.
CollectionView	CollectionView exibe uma lista rolável de itens de dados selecionáveis, usando diferentes especificações de layout. 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 selecionar 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 um 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 é utilizado para encapsular uma exibição ou layout com uma borda que pode ser configurada com cores, sombras 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 namespace Microsoft.Maui.Graphics. Para obter mais informações, consulte GraphicsView.
Image	Image exibe uma imagem que pode ser carregada a partir de um arquivo local, um URI, um recurso inserido 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 a execução de uma tarefa. Para obter mais informações, consulte ImageButton.
IndicatorView	IndicatorView exibe indicadores que representam o número de itens em um CarouselView. 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 Etiqueta.
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	Map exibe um mapa e requer que o pacote NuGet Microsoft.Maui.Controls.Maps seja instalado em seu aplicativo.
Path	Path exibe 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 Seletor.
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 Polilinha.
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 uma funcionalidade de deslizar para baixo para atualizar para o conteúdo rolável. Para obter mais informações, consulte RegreshView.
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 double de um intervalo contínuo. Para obter mais informações, consulte Controle deslizante.
Stepper	Stepper permite selecionar um valor double de um intervalo de valores incrementais. Para obter mais informações, consulte Passador.
SwipeView	SwipeView é um controle de contêiner que envolve um item de conteúdo e fornece itens de menu de contexto que são exibidos por um gesto de deslizar o dedo. Para obter mais informações, consulte SwipeView.
Switch	Switch permite selecionar 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 selecionar um horário com o seletor de tempo da plataforma. Para obter mais informações, consulte TimePicker.
TwoPaneView	TwoPaneView representa um contêiner com duas exibições que dimensionam e posicionam o 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, confira WebView.