Xamarin.Forms Modos de exibição

Artigo
07/09/2020

Xamarin.Forms As visualizações são os blocos de construção das interfaces de usuário móveis de plataforma cruzada.

Modos de exibição são 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 de programação gráfica. As exibições suportadas por Xamarin.Forms todos derivam da View classe. Eles podem ser divididos em várias categorias:

Exibições para apresentação

Tipo	Descrição	Aparência
`BoxView`	`BoxView` exibe um retângulo sólido colorido `Color` pela propriedade. `BoxView` tem uma solicitação de tamanho padrão de 40x40. Para outros tamanhos, atribua as `WidthRequest` propriedades e `HeightRequest` . Guia de documentação da / API	Código C# para esta página / Página XAML
`Ellipse`	`Ellipse` Exibe uma elipse ou círculo de tamanho `WidthRequest` x `HeightRequest`. Para pintar o interior da elipse, defina sua `Fill` propriedade como um `Color`arquivo . Para dar à elipse um contorno, defina sua `Stroke` propriedade como um `Color`arquivo . Guia de documentação da / API	Código C# para esta página / Página XAML
`Label`	`Label` Exibe cadeias de texto de linha única ou blocos de texto de várias linhas, com formatação constante ou variável. Defina a `Text` propriedade como uma cadeia de caracteres para formatação constante ou defina a `FormattedText` propriedade como um `FormattedString` objeto para formatação de variável. Guia de documentação da / API	Código C# para esta página / Página XAML
`Line`	`Line` Exibe uma linha de um ponto inicial a um ponto final. O ponto inicial é representado pelas `X1` propriedades e `Y1` , enquanto o ponto final é representado pelas `X2` propriedades e `Y2` . Para colorir a linha, defina sua `Stroke` propriedade como um `Color`arquivo . Guia de documentação da / API	Código C# para esta página / Página XAML
`Image`	`Image` exibe um bitmap. Os bitmaps podem ser baixados pela Web, incorporados como recursos no projeto comum ou projetos de plataforma, ou criados usando um objeto .NET `Stream` . Guia de documentação da / API	Código C# para esta página / Página XAML
`Map`	`Map` exibe um mapa. O Xamarin.Forms. O pacote NuGet do Google Maps deve estar instalado. O Android e a Plataforma Universal do Windows exigem uma chave de autorização de mapa. Guia de documentação da / API	Código C# para esta página / Página XAML
`OpenGLView`	`OpenGLView` exibe gráficos OpenGL em projetos iOS e Android. Não há suporte para a Plataforma Universal do Windows. Os projetos iOS e Android exigem uma referência ao assembly OpenTK-1.0 ou ao assembly OpenTK versão 1.0.0.0. `OpenGLView` é mais fácil de usar em um projeto compartilhado; se usado em uma biblioteca do .NET Standard, um Serviço de Dependência também será necessário (conforme mostrado no código de exemplo). Esse é o único recurso gráfico integrado Xamarin.Formsao , mas um Xamarin.Forms aplicativo também pode renderizar elementos gráficos usando `SkiaSharp`, ou `UrhoSharp`. Documentação da API	Código C# para esta página / Página XAML com code-behind
`Path`	`Path` exibe curvas e formas complexas. A `Data` propriedade especifica a forma a ser desenhada. Para colorir a forma, defina sua `Stroke` propriedade como um `Color`arquivo . Guia de documentação da / API	Código C# para esta página / Página XAML
`Polygon`	`Polygon` exibe um polígono. A `Points` propriedade especifica os pontos de vértice do polígono, enquanto a `FillRule` propriedade especifica como o preenchimento interno do polígono é determinado. Para pintar o interior do polígono, defina sua `Fill` propriedade como um `Color`arquivo . Para dar ao polígono um contorno, defina sua `Stroke` propriedade como um `Color`arquivo . Guia de documentação da / API	Código C# para esta página / Página XAML
`Polyline`	`Polyline` exibe uma série de linhas retas conectadas. A `Points` propriedade especifica os pontos de vértice da polilinha, enquanto a `FillRule` propriedade especifica como o preenchimento interno da polilinha é determinado. Para pintar o interior da polilinha, defina sua `Fill` propriedade como um `Color`arquivo . Para dar à polilinha um contorno, defina sua `Stroke` propriedade como um `Color`arquivo . Guia de documentação da / API	Código C# para esta página / Página XAML
`Rectangle`	`Rectangle` Exibe um retângulo ou quadrado. Para pintar o interior do retângulo, defina sua `Fill` propriedade como um `Color`arquivo . Para dar ao retângulo um contorno, defina sua `Stroke` propriedade como um `Color`arquivo . Guia de documentação da / API	Código C# para esta página / Página XAML
`WebView`	`WebView` exibe páginas da Web ou conteúdo HTML, com base em se a `Source` propriedade está definida como um `UriWebViewSource` ou um `HtmlWebViewSource` objeto. Guia de documentação da / API	Código C# para esta página / Página XAML

Exibições que iniciam comandos

Tipo	Descrição	Aparência
`Button`	`Button` é um objeto retangular que exibe texto e que dispara um `Clicked` evento quando ele é pressionado. Guia de documentação da / API	Código C# para esta página / Página XAML com code-behind
`ImageButton`	`ImageButton` é um objeto retangular que exibe uma imagem e que dispara um `Clicked` evento quando ele é pressionado. Guia de documentação da / API	Código C# para esta página / Página XAML com code-behind
`RadioButton`	`RadioButton` permite a seleção de uma opção de um conjunto e dispara um `CheckedChanged` evento quando a seleção ocorre. Guia de documentação da / API	Código C# para esta página / Página XAML com code-behind
`RefreshView`	`RefreshView` é um controle de contêiner que fornece funcionalidade pull-to-refresh para conteúdo rolável. O `ICommand` definido pela `Command` propriedade é executado quando uma atualização é acionada e a `IsRefreshing` propriedade indica o estado atual do controle. Guia de documentação da / API	Código C# para esta página / Página XAML com code-behind
`SearchBar`	`SearchBar` Exibe uma área para o usuário digitar uma cadeia de caracteres de texto e um botão (ou uma tecla de teclado) que sinaliza o aplicativo para executar uma pesquisa. A `Text` propriedade fornece acesso ao texto e o `SearchButtonPressed` evento indica que o botão foi pressionado. Guia de documentação da / API	Código C# para esta página / Página XAML com code-behind
`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. Cada item de menu é representado por um `SwipeItem`, que tem uma `Command` propriedade que executa um `ICommand` quando o item é tocado. Guia de documentação da / API	Código C# para esta página / Página XAML com code-behind

Exibições para definir valores

Tipo	Descrição	Aparência
`CheckBox`	`CheckBox` permite que o usuário selecione um valor booleano usando um tipo de botão que pode ser marcado ou vazio. A `IsChecked` propriedade é o estado do `CheckBox`, e o `CheckedChanged` evento é acionado quando o estado é alterado. Guia de documentação da / API	Código C# para esta página / Página XAML
`Slider`	`Slider` Permite que o usuário selecione um `double` valor de um intervalo contínuo especificado com as `Minimum` propriedades e `Maximum` . Guia de documentação da / API	Código C# para esta página / Página XAML
`Stepper`	`Stepper` Permite que o usuário selecione um `double` valor de um intervalo de valores incrementais especificados com as `Minimum`propriedades , `Maximum`e `Increment` . Guia de documentação da / API	Código C# para esta página / Página XAML
`Switch`	`Switch` assume a forma de um interruptor liga/desliga para permitir que o usuário selecione um valor booleano. A `IsToggled` propriedade é o estado da opção e o `Toggled` evento é acionado quando o estado é alterado. Guia de documentação da / API	Código C# para esta página / Página XAML
`DatePicker`	`DatePicker` Permite que o usuário selecione uma data com o seletor de data da plataforma. Defina um intervalo de datas permitidas com as `MinimumDate` propriedades e `MaximumDate` . A `Date` propriedade é a data selecionada e o `DateSelected` evento é acionado quando essa propriedade é alterada. Guia de documentação da / API	Código C# para esta página / Página XAML
`TimePicker`	`TimePicker` Permite que o usuário selecione um horário com o seletor de tempo da plataforma. A `Time` propriedade é a hora selecionada. Um aplicativo pode monitorar alterações na `Time` propriedade instalando um manipulador para o `PropertyChanged` evento. Guia de documentação da / API	Código C# para esta página / Página XAML

Exibições para edição de texto

Essas duas classes derivam da InputView classe, que define a Keyboard propriedade:

Tipo	Descrição	Aparência
`Entry`	`Entry` Permite que o usuário insira e edite uma única linha de texto. O texto está disponível como a `Text` propriedade, e os `TextChanged` eventos e `Completed` são disparados quando o texto é alterado ou o usuário sinaliza a conclusão tocando na tecla enter. Use um `Editor` para inserir e editar várias linhas de texto. Guia de documentação da / API	Código C# para esta página / Página XAML
`Editor`	`Editor` Permite que o usuário insira e edite várias linhas de texto. O texto está disponível como a `Text` propriedade e os `TextChanged` eventos e `Completed` são disparados quando o texto é alterado ou o usuário sinaliza conclusão. Use um `Entry` modo de exibição para inserir e editar uma única linha de texto. Guia de documentação da / API	Código C# para esta página / Página XAML

Exibições para indicar atividade

Tipo	Descrição	Aparência
`ActivityIndicator`	`ActivityIndicator` usa uma animação para mostrar que o aplicativo está envolvido em uma atividade longa sem dar qualquer indicação de progresso. A `IsRunning` propriedade controla a animação. Se o progresso da atividade for conhecido, use um `ProgressBar` em vez disso. Guia de documentação da / API	Código C# para esta página / Página XAML
`ProgressBar`	`ProgressBar` Usa uma animação para mostrar que o aplicativo está progredindo por uma atividade longa. Defina a `Progress` propriedade como valores entre 0 e 1 para indicar o progresso. Se o progresso da atividade não for conhecido, use um `ActivityIndicator` em vez disso. Guia de documentação da / API	Código C# para esta página / Página XAML com code-behind

Exibições que mostram coleções

Tipo	Descrição	Aparência
`CarouselView`	`CarouselView` Exibe uma lista rolável de itens de dados. Defina a `ItemsSource` propriedade como uma coleção de objetos e defina a `ItemTemplate` propriedade como um `DataTemplate` objeto que descreve como os itens devem ser formatados. O `CurrentItemChanged` evento sinaliza que o item exibido no momento foi alterado, que está disponível como a `CurrentItem` propriedade. Guia	Código C# para esta página / Página XAML
`CollectionView`	`CollectionView` Exibe uma lista rolável de itens de dados selecionáveis, usando especificações de layout diferentes. O objetivo é fornecer uma alternativa mais flexível e eficiente ao `ListView`. Defina a `ItemsSource` propriedade como uma coleção de objetos e defina a `ItemTemplate` propriedade como um `DataTemplate` objeto que descreve como os itens devem ser formatados. O `SelectionChanged` evento sinaliza que uma seleção foi feita, que está disponível como a `SelectedItem` propriedade. Guia	Código C# para esta página / Página XAML
`IndicatorView`	`IndicatorView` Exibe indicadores que representam o número de itens em um `CarouselView`arquivo . Defina a `CarouselView.IndicatorView` propriedade para o `IndicatorView` objeto para exibir indicadores para o `CarouselView`. Guia de documentação da / API	Código C# para esta página / Página XAML
`ListView`	`ListView` deriva de `ItemsView` e exibe uma lista rolável de itens de dados selecionáveis. Defina a `ItemsSource` propriedade como uma coleção de objetos e defina a `ItemTemplate` propriedade como um `DataTemplate` objeto que descreve como os itens devem ser formatados. O `ItemSelected` evento sinaliza que uma seleção foi feita, que está disponível como a `SelectedItem` propriedade. Guia de documentação da / API	Código C# para esta página / Página XAML
`Picker`	`Picker` Exibe um item selecionado de uma lista de cadeias de caracteres de texto e permite selecionar esse item quando o modo de exibição é tocado. Defina a `Items` propriedade como uma lista de cadeias de caracteres ou a `ItemsSource` propriedade como uma coleção de objetos. O `SelectedIndexChanged` evento é acionado quando um item é selecionado. O `Picker` exibe a lista de itens somente quando ele é selecionado. Use um `ListView` ou `TableView` para uma lista rolável que permanece na página. Guia de documentação da / API	Código C# para esta página / Página XAML com code-behind
`TableView`	`TableView` Exibe uma lista de linhas do tipo `Cell` com cabeçalhos e subcabeçalhos opcionais. Defina a `Root` propriedade como um objeto do tipo `TableRoot`e adicione `TableSection` objetos a esse `TableRoot`. Cada `TableSection` um é uma coleção de `Cell` objetos. Guia de documentação da / API	Código C# para esta página / Página XAML