Material de mica

Mica é um material opaco e dinâmico que incorpora tema e papel de parede da área de trabalho para pintar o fundo de janelas de longa duração, como aplicativos e configurações. Você pode aplicar o Mica ao pano de fundo do seu aplicativo para encantar os usuários e criar hierarquia visual, ajudando na produtividade, aumentando a clareza sobre qual janela está em foco. O Mica foi projetado especificamente para o desempenho do aplicativo, pois ele só mostra o papel de parede da área de trabalho uma vez para criar sua visualização. O Mica está disponível para aplicativos UWP que usam WinUI 2 e aplicativos que usam o Windows App SDK 1.1 ou posterior, durante a execução no Windows 11 versão 22000 ou posterior.

Mica Alt é uma variante do Mica, com uma tonalidade mais forte da cor de fundo do ambiente de trabalho do utilizador. Você pode aplicar o Mica Alt ao pano de fundo do seu aplicativo para fornecer uma hierarquia visual mais profunda do que o Mica, especialmente ao criar um aplicativo com uma barra de título com guias. O Mica Alt está disponível para aplicações que utilizam o Windows App SDK 1.1 ou posterior, em execução no Windows 11 versão 22000 ou posterior.

Estas imagens mostram a diferença entre Mica e Mica Alt numa barra de título com abas. A primeira imagem usa Mica e a segunda imagem usa Mica Alt.

Quando usar Mica ou Mica Alt

Mica e Mica Alt são materiais que aparecem no pano de fundo do seu aplicativo — por trás de todos os outros conteúdos. Cada material é opaco e incorpora o tema do usuário e o papel de parede da área de trabalho para criar sua aparência altamente personalizada. À medida que o usuário move a janela pela tela, o material Mica se adapta dinamicamente para criar uma visualização rica usando o papel de parede abaixo do aplicativo. Além disso, o material ajuda os usuários a se concentrarem na tarefa atual, caindo de volta para uma cor neutra quando o aplicativo está inativo.

Recomendamos que você aplique Mica ou Mica Alt como a camada base do seu aplicativo e priorize a visibilidade na área da barra de título. Para obter orientações mais específicas sobre camadas, consulte a seção Camadas e Elevação e a seção Camadas de Aplicativos com Mica deste artigo.

Usabilidade e adaptabilidade

Os materiais Mica adaptam automaticamente a sua aparência para uma grande variedade de dispositivos e contextos. Eles são projetados para desempenho, pois capturam o papel de parede de fundo apenas uma vez para criar suas visualizações.

No modo de Alto Contraste, os utilizadores continuam a ver a cor de fundo familiar da sua escolha no lugar de Mica ou Mica Alt. Além disso, os materiais Mica aparecerão como uma cor sólida alternativa (SolidBackgroundFillColorBase para Mica, SolidBackgroundFillColorBaseAlt para Mica Alt) quando:

• O utilizador desativa a transparência em Definições > Personalização > Cor.
• O modo de economia de bateria está ativado.
• O aplicativo é executado em hardware low-end.
• Uma janela de aplicativo na área de trabalho é desativada.
• O aplicativo do Windows está sendo executado no Xbox ou HoloLens.
• A versão para Windows está abaixo de 22000.

Camadas de aplicativos com o Mica

O Mica é ideal como uma camada de base na hierarquia do seu aplicativo devido aos seus estados inativos e ativos e à personalização sutil. Para aderir ao sistema de Dupla Camada e Elevação, recomendamos que aplique Mica como a camada base na sua aplicação e adicione uma camada de conteúdo adicional sobre a camada base. A camada de conteúdo deve captar o material por trás dela, Mica, usando o LayerFillColorDefaultBrush, uma cor sólida de baixa opacidade, como fundo. Nossos padrões de camada de conteúdo recomendados são:

• Padrão padrão: Um fundo contíguo para grandes áreas que precisam de uma diferenciação hierárquica distinta da camada base. O LayerFillColorDefaultBrush deve ser aplicado aos planos de fundo dos containers das superfícies do seu aplicativo WinUI (por exemplo, Grids, StackPanels, Frames, etc.).
• Padrão de cartão: cartões segmentados para aplicativos projetados com vários componentes de interface do usuário seccionados e descontínuos. Para obter a definição da interface do usuário do cartão usando o LayerFillColorDefaultBrush, consulte a orientação sobre Camadas e Elevação em .

Para dar à janela do seu aplicativo uma aparência perfeita, o Mica deve estar visível na barra de título se você optar por aplicar o material ao seu aplicativo. Você pode mostrar o Mica na barra de título estendendo seu aplicativo para a área não cliente e criando uma barra de título personalizada transparente. Para obter mais informações, consulte barra de título.

Os exemplos a seguir mostram implementações comuns da estratégia de camadas com NavigationView onde o Mica é visível na área da barra de título.

• Padrão padrão em Left NavigationView.
• Padrão padrão em Top NavigationView.
• Formato de cartão no NavigationView à esquerda.

Padrão padrão no painel de navegação à esquerda

Por padrão, o NavigationView no modo à esquerda inclui a camada de conteúdo na sua área de conteúdo. Este exemplo estende o Mica para a área da barra de título e cria uma barra de título personalizada.

Padrão padrão no Top NavigationView

Por padrão, o modo NavigationView in Top inclui a camada de conteúdo em sua área de conteúdo. Este exemplo estende o Mica para a área da barra de título e cria uma barra de título personalizada.

Padrão de cartão na vista de navegação à esquerda

Para seguir o padrão de cartão usando um NavigationView, você precisará remover a camada de conteúdo padrão substituindo os recursos do tema de plano de fundo e borda. Em seguida, você pode criar os cartões na área de conteúdo do controle. Este exemplo cria vários cartões, estende o Mica para a área da barra de título e cria uma barra de título personalizada. Para obter mais informações sobre a interface do usuário do cartão, consulte Layering and Elevation guidance.

Camadas de aplicações com Mica Alt

O Mica Alt é uma alternativa ao Mica como uma camada de base na hierarquia do seu aplicativo com os mesmos recursos, como estados inativos e ativos e personalização sutil. Recomendamos que você aplique o Mica Alt como a camada base do seu aplicativo quando precisar de contraste entre os elementos da barra de título e as áreas de comando do seu aplicativo (por exemplo, navegação, menus).

Um cenário comum para usar o Mica Alt é ao criar uma aplicação com uma barra de título com separadores. Para seguir as orientações de de Camadas e Elevação, recomendamos que você aplique o Mica Alt como a camada base do seu aplicativo, adicione uma camada de comando que fique na parte superior da camada base e, finalmente, adicione uma camada de conteúdo adicional que fica na parte superior da camada de comando. A camada de comando deverá capturar o material atrás dela, Mica Alt, usando o LayerOnMicaBaseAltFillColorDefaultBrush, uma cor sólida de baixa opacidade, como fundo. A camada de conteúdo deve pegar as camadas abaixo dela, usando o LayerFillColorDefaultBrush, outra cor sólida de baixa opacidade. O sistema de camadas é o seguinte:

• Mica Alt: A camada de base.
• Camada de comando: Requer diferenciação hierárquica distinta da camada base. O LayerOnMicaBaseAltFillColorDefaultBrush deve ser aplicado às áreas de comando das superfícies do aplicativo WinUI (por exemplo, MenuBar, estrutura de navegação, etc.)
• Camada de conteúdo: Um plano de fundo contíguo para grandes áreas que precisam de uma diferenciação hierárquica distinta da camada de comando. O LayerFillColorDefaultBrush deve ser aplicado aos planos de fundo dos containers das superfícies do seu aplicativo WinUI (por exemplo, Grids, StackPanels, Frames, etc.).

Para dar à janela do seu aplicativo uma aparência perfeita, o Mica Alt deve estar visível na barra de título se você optar por aplicar o material ao seu aplicativo. Você pode mostrar Mica Alt na barra de título estendendo seu aplicativo para a área não cliente e criando uma barra de título personalizada transparente.

Recomendações

• defina o plano de fundo para transparente para todas as camadas onde você deseja ver o Mica para que o Mica apareça.
• Não aplique material de pano de fundo mais de uma vez em um aplicativo.
• Não aplique material de pano de fundo a um elemento da interface do usuário. O material de pano de fundo não aparecerá no elemento em si. Ele só aparecerá se todas as camadas entre o elemento da interface do usuário e a janela estiverem definidas como transparentes.

Exemplos

O aplicativo WinUI 3 Gallery inclui exemplos interativos da maioria dos controles, recursos e funcionalidades do WinUI 3. Obtenha o aplicativo no da Microsoft Store ou obtenha o código-fonte em do GitHub

Como usar Mica

Você pode usar o Mica em aplicativos UWP que usam WinUI 2 ou em aplicativos que usam o Windows App SDK 1.1 ou posterior. Você pode usar o Mica Alt em aplicativos que usam o Windows App SDK 1.1 ou posterior.

Usar o Mica com o Windows App SDK

Para usar Mica numa aplicação XAML WinUI 3, consulte Aplicar materiais Mica ou Acrylic em aplicações de ambiente de trabalho para Windows 11.

Para utilizar o Mica numa aplicação Win32, consulte Aplicar o Mica em aplicações de ambiente de trabalho Win32 para Windows 11.

Usar Mica com WinUI 2 para UWP

Para usar o Mica em um aplicativo UWP com WinUI 2, consulte Aplicar Mica com WinUI 2 para UWP.

Artigos relacionados

• Materiais
• Camadas e Elevação
• Aplicar materiais Mica ou Acrílico em aplicações de ambiente de trabalho para Windows 11
• aplicar o Mica em aplicativos de área de trabalho Win32 para Windows 11
• VistaDeNavegação