Controles para aplicativos Windows

Os controles são os elementos de interface do usuário que compõem seu aplicativo Windows– botões, campos de texto, listas, seletores e muito mais. Um controle exibe conteúdo ou permite que os usuários interajam com seu aplicativo. Um padrão combina vários controles em uma receita reutilizável para cenários comuns, como formulários ou layouts de detalhes de lista.

Windows fornece mais de 45 controles prontos para uso, todos baseados no Fluent Design System. De alternâncias simples a exibições de dados avançadas, como grade e lista, esses controles ajudam você a criar interfaces visualmente polidas, acessíveis e responsivas entre dispositivos.

Navegue pelos artigos desta seção para obter diretrizes de design, exemplos de código e práticas recomendadas para cada controle e padrão.

Introdução

Para saber como adicionar controles ao seu aplicativo e conectar manipuladores de eventos, consulte Adicionar controles e manipular eventos. Para personalizar a aparência do controle com estilos XAML reutilizáveis, consulte controles de estilo.

Controles

A tabela a seguir lista os controles de aplicativo Windows disponíveis no WinUI, com links para sua documentação.

Entrada básica

Imagem	Controle	Descrição
	Botões	Um controle que responde à interação do usuário e gera um evento Clique. Inclui botão, botão suspenso, botão dividido, botão alternável e muito mais.
	caixas de seleção	Um controle que um usuário pode selecionar ou limpar.
	Caixas de combinação	Uma lista suspensa de itens que um usuário pode selecionar.
	Hyperlinks	Um botão que aparece como texto de hiperlink e pode navegar para uma URI ou manipular um evento de clique.
	botões de opção	Um controle que permite que um usuário selecione uma única opção de um grupo de opções.
	Controle de classificação	Classifique algo de 1 a 5 estrelas.
	Controles deslizantes	Um controle que permite que o usuário selecione entre um intervalo de valores movendo um controle Thumb ao longo de uma faixa.
	Alternar comutadores	Um comutador que pode ser alternado entre dois estados.

Collections

Imagem	Controle	Descrição
	Exibição de itens	Um controle que apresenta uma coleção de itens usando vários layouts.
	Exibição em lista e exibição em grade	Controles que apresentam uma coleção de itens em uma lista vertical ou em linhas e colunas.
	Modo de exibição invertido	Apresenta uma coleção de itens que o usuário pode folhear, um item de cada vez.
	Pips pager	Um controle para permitir que o usuário navegue por uma coleção paginada quando os números de página não precisarem ser visualmente conhecidos.
	Modo de exibição de árvore	Um padrão de lista hierárquica com nós que se expandem e se contraem, contendo itens que são aninhados.
	Repetidor de itens	Um controle primitivo flexível para layouts controlados por dados.
	Deslizar	Gesto de toque para ações de menu rápidas em itens.
	Deslizar para atualizar	Fornece a capacidade de arrastar uma lista/grade de itens para atualizar o conteúdo da coleção.

Caixas de diálogo e submenus

Imagem	Controle	Descrição
	Dialogs	Uma caixa de diálogo que pode ser personalizada para conter qualquer conteúdo XAML.
	Janelas Flutuantes	Mostra informações contextuais e habilita a interação do usuário.
	Dica de ensino	Um flyout rico em conteúdo para ajudar a guiar os usuários e promover oportunidades de ensino.

Formulários

Mídia, elementos gráficos e formas

Imagem	Controle	Descrição
	Ícones	Represente controles de ícone que usam diferentes tipos de imagem como conteúdo.
	Ícones animados	Um elemento que exibe e controla um ícone que anima quando o usuário interage com o controle.
	Imagens e pincéis de imagem	Um controle para exibir o conteúdo da imagem.
	Tinta	Controles para escrita à tinta digital, incluindo tela de tinta e barra de ferramentas de tinta.
	Reprodução de mídia	Um controle para exibir o conteúdo de vídeo e imagem.
	Formas	Desenhar formas como elipses, retângulos e polígonos.

Menus e barras de ferramentas

Imagem	Controle	Descrição
	Menus e menus de contexto	Mostra uma lista contextual de comandos ou opções simples.
	Barra de comandos	Uma barra de ferramentas para exibir comandos específicos do aplicativo que manipula o layout e o redimensionamento de seu conteúdo.
	Submenu da barra de comandos	Uma barra de ferramentas mini exibindo comandos proativos e um menu de comandos opcional.
	Menu suspenso e barra de menus	Um menu clássico, permitindo a exibição de MenuItems que contêm MenuFlyoutItems.

Navigation

Imagem	Controle	Descrição
	Barra de navegação	Mostra a trilha de navegação até o local atual.
	Lista/detalhes	Um padrão que exibe uma lista de itens junto com os detalhes do item selecionado no momento.
	Modo de exibição de navegação	Layout vertical comum para áreas de nível superior do seu aplicativo por meio de um menu de navegação recolhível.
	Pivô	Apresenta informações de diferentes fontes em um modo de exibição com guias.
	Barra de seletores	Apresenta informações de um pequeno conjunto de fontes diferentes. O usuário pode escolher um deles.
	Exibição em abas	Um controle que exibe uma coleção de abas que podem ser usadas para exibir vários documentos.

People

Imagem	Controle	Descrição
	Imagem da pessoa	Exibe a imagem de uma pessoa/contato.

Pickers

Imagem	Controle	Descrição
	Seletor de cores	Um controle que exibe um espectro de cores selecionável.
	Seletor de data do calendário	Um controle que permite que os usuários escolham um valor de data usando um calendário.
	Exibição de calendário	Um controle que apresenta um calendário para um usuário escolher uma data.
	Seletor de data	Um controle que permite que um usuário escolha um valor de data.
	Seletor de tempo	Um controle configurável que permite que um usuário escolha um valor de hora.

Rolagem e layout

Imagem	Controle	Descrição
	Expansor	Um contêiner com um cabeçalho que pode ser expandido para mostrar um corpo com mais conteúdo.
	Controles de rolagem e movimento panorâmico	Um controle de contêiner que permite que o usuário realize panorâmica e ampliação de seu conteúdo.
	Barra de rolagem anotada	Um controle que estende a funcionalidade de uma barra de rolagem vertical regular para facilitar a navegação por meio de grandes coleções.
	Zoom semântico	Permite que o usuário amplie entre duas exibições diferentes de uma coleção, facilitando a navegação por grandes coleções de itens.
	Visão dividida	Um contêiner que tem 2 áreas de conteúdo, com várias opções de exibição para o painel.
	Exibição de dois painéis	Um controle com duas áreas de conteúdo que abrangem o espaço disponível, lado a lado ou de cima para baixo.

Status e as informações

Imagem	Controle	Descrição
	Progress	Mostra o progresso do aplicativo em uma tarefa usando uma barra de progresso ou um anel de progresso.
	Dica de ferramenta	Exibe informações de um elemento em uma janela pop-up.
	Barra de informações	Uma mensagem embutida para exibir informações de alteração de status em todo o aplicativo.
	Selo de informações	Uma interface do usuário não intrusiva para exibir notificações ou colocar o foco em uma área.

Texto

Imagem	Controle	Descrição
	Caixa de sugestão automática	Um controle para fornecer sugestões enquanto o usuário digita.
	Bloco de texto	Um controle leve para exibir pequenas quantidades de texto.
	Bloco de texto rico	Um controle que exibe texto formatado, hiperlinks, imagens embutidas e outros conteúdos avançados.
	Caixa de texto	Um campo de texto sem formatação de linha única ou de várias linhas.
	Caixa de edição avançada	Um controle de edição de rich text que dá suporte a texto formatado, hiperlinks e outros conteúdos avançados.
	Caixa de senha	Um controle para inserir senhas.
	Caixa de número	Um controle de texto usado para entrada numérica e avaliação de equações algébricas.
	Rótulos	Diretrizes para adicionar rótulos acessíveis aos controles de entrada.

Barra de título

Imagem	Controle	Descrição
	Barra de título	Personalize a barra de título da janela do aplicativo.

Galeria do WinUI 3

O aplicativo WinUI 3 Gallery é a melhor maneira de explorar esses controles interativamente. Ele fornece demonstrações interativas da maioria dos controles, recursos e padrões do Fluent Design do WinUI, tornando-o um complemento ideal para esta documentação. Instale-o para experimentar controles em tempo real e vincular diretamente de páginas de controle individuais.

Controles e recursos adicionais

O Windows Community Toolkit é uma coleção de auxiliares, extensões e controles de interface do usuário adicionais que complementam os controles internos do WinUI. Ele é controlado pela comunidade e mantido pela Microsoft, abrangendo cenários comuns, como layouts avançados, conversores e animações.

Para obter acesso antecipado a controles experimentais e recursos, confira Windows Community Toolkit Labs, em que novos componentes são desenvolvidos e testados antes de se formarem no kit de ferramentas principal.