InitialRotationPreference (esquema de pacote para Windows 8)

Descreve as orientações nas quais o aplicativo prefere ser mostrado para a melhor experiência do usuário. Em um dispositivo que pode ser girado, como um Tablet, o aplicativo não será redesenhado para orientações não especificadas aqui. Por exemplo, se o aplicativo especificar apenas orientações de paisagem e LandscapeFlipped e o dispositivo for girado para uma orientação retrato, o aplicativo não será girado.

Observe que em dispositivos que não podem ser girados, um aplicativo pode ser mostrado na orientação padrão do dispositivo e a orientação preferida do aplicativo será ignorada. No entanto, em um dispositivo com um bloqueio de rotação ativado, a rotação preferida do seu aplicativo ainda será respeitada.

Essas opções de preferência de orientação se aplicam à tela inicial e à interface do usuário do aplicativo quando uma nova sessão é iniciada para seu aplicativo. As preferências podem ser alteradas durante o tempo de execução por meio da propriedade AutoRotationPreferences .

Hierarquia de elementos

<Agrupa>

<Aplicativos>

<Aplicativo>

<VisualElements>

<InitialRotationPreference>

Syntax

<InitialRotationPreference>

  <!-- Child elements -->
  Rotation{1,4}

</InitialRotationPreference>

Chave

{} intervalo específico de ocorrências

Atributos e elementos

Atributos

Nenhum.

Elementos filho

Elemento filho	Descrição
Rotação	Especifica uma única orientação rotacional na qual um aplicativo será exibido.

 

Elementos pai

Elemento pai	Descrição
VisualElements	Descreve os aspectos visuais do aplicativo UWP: seu bloco padrão, imagens de logotipo, cores de texto e de plano de fundo, a orientação inicial da tela, a tela inicial e a aparência do bloco da tela de bloqueio.

 

Comentários

Esse elemento faz parte do seu arquivo de manifesto do aplicativo (Package. appxmanifest). no editor de manifesto Microsoft Visual Studio, essa configuração é encontrada na guia interface do usuário do aplicativo como "rotações iniciais com suporte". Por padrão, nenhuma das opções é selecionada. Isso significa que todas as orientações de rotação têm suporte. A seleção de nenhuma das rotações ou de todas as rotações fornece o mesmo resultado.

Como seu aplicativo pode ser executado em diferentes tipos de dispositivo — computadores desktop, tablets, laptops ou telefones — você não poderá garantir o conhecimento antecipado da orientação do dispositivo no momento em que seu aplicativo for iniciado, nem que o dispositivo não seja girado enquanto o aplicativo estiver ativo. Portanto, recomendamos que você desenvolva seu aplicativo com a capacidade de ser exibida em qualquer orientação. dito isso, seu aplicativo pode usar esse elemento para pedir Windows restringir a exibição do seu aplicativo a suas rotações ideais. no entanto, Windows nem sempre pode honrar a solicitação. Como nem todos os dispositivos podem ser girados ou detectar rotação, as preferências de orientação nem sempre são respeitadas pelo Windows. Por exemplo, se você declarar que seu aplicativo deve ser exibido em retrato, mas o aplicativo for executado em um monitor de área de trabalho orientado por paisagem padrão ou em uma televisão, a preferência será ignorada porque mostrar o aplicativo em seu lado seria uma experiência de usuário ruim. Por esse motivo, você deve considerar o suporte a todas as orientações para que seu aplicativo fique bom, independentemente da rotação do dispositivo.

Observação Como, no momento, os PCs desktop e notebooks permanecem como os dispositivos predominantes estatisticamente em que seu aplicativo provavelmente será executado, e como esses dispositivos são quase todos corrigidos em uma orientação paisagem e não detectam rotação, é necessário que um aplicativo dê suporte a pelo menos a rotação paisagem. No entanto, embora ele tenha suporte, não é necessário declarar paisagem como uma rotação preferida.

 

Esse elemento contém até quatro elementos de rotação , cada um deles especifica uma orientação na qual o aplicativo prefere ser exibido. Se você não incluir nenhum elemento de rotação , ele terá o mesmo efeito que incluir todos os quatro.

O exemplo a seguir mostra um aplicativo que será exibido em Landscape e LandscapeFlipped, mas não alterará sua orientação para um dispositivo mantido em retrato ou PortraitFlipped.

                        
<InitialRotationPreference>
    <Rotation Preference="landscape"/>
    <Rotation Preference="landscapeFlipped"/>
</InitialRotationPreference>
                    

quando seu aplicativo é iniciado inicialmente, Windows recebe suas preferências de rotação. Essas preferências permanecem no local até que o aplicativo seja encerrado, com uma exceção importante: se for feita uma chamada para Windows. Graphics. display. DisplayProperties. autoRotationPreferences para alterar essas preferências. essa API é usada para informar Windows de uma alteração nas preferências de rotação do seu aplicativo e pode ser chamada a qualquer momento. Observe que essa chamada à API não afeta o conteúdo do elemento InitialRotationPreference no arquivo de manifesto do aplicativo, que permanece à medida que você os define no editor de manifesto. Portanto, sempre que você reiniciar seu aplicativo, ele usa as preferências de rotação que você especificou originalmente no manifesto do aplicativo.

Por exemplo, considere um aplicativo de jogo que é melhor exibido em paisagem, mas que tem uma determinada página que exibe um mapa mais legível em retrato. A série de eventos a seguir pode ocorrer em um dispositivo que dá suporte à rotação. Uma familiaridade com os termos do ciclo de vida do aplicativo será útil aqui.

1. O desenvolvedor especifica as preferências de rotação paisagem e/ou LandscapeFlipped para o aplicativo no editor de manifesto.
2. O jogo está instalado e iniciado. As preferências especificadas no editor de manifesto se aplicam e o jogo não será girado para retrato.
3. O jogo detecta que o usuário está acessando o mapa. ele chama AutoRotationPreferences para informar Windows alterar as preferências de rotação do aplicativo para retrato e/ou PortraitFlipped.
4. Windows gira o aplicativo para a nova orientação preferida.
5. O usuário alterna para outro aplicativo para verificar seu email.
6. O usuário volta para o aplicativo de jogo para continuar de onde parou. Windows sabe que a última preferência declarada do aplicativo foi para retrato e coloca o aplicativo na tela nessa orientação. Observe que ele não se referiu às configurações de InitialRotationPreference porque a sessão atual ainda está ativa.
7. O jogo detecta que o usuário está fechando a página de mapa. Ele chama AutoRotationPreferences para alterar suas preferências de rotação de volta para suas configurações de paisagem originais para continuar o jogo.
8. O usuário conclui o jogo e o aplicativo é suspenso depois que o usuário sai por um período de tempo.
9. O usuário retoma o aplicativo para reproduzir outro jogo. Como o aplicativo não foi reiniciado, as últimas preferências declaradas pela API AutoRotationPreferences ainda se aplicam.
10. O jogo está fechado (encerrado).
11. O jogo é reiniciado. Como ele é iniciado novamente de uma inicialização inicial, as configurações de InitialRotationPreference mais uma vez se aplicam.

O ponto principal a ser observado é que, uma vez que você tenha chamado AutoRotationPreferences, é sua responsabilidade manipular as preferências de rotação por meio dessa API até que o jogo seja encerrado (não meramente suspenso).

quando um aplicativo gira, Windows gira com ele. Se você fechar o aplicativo em retrato, a tela inicial será mostrada em retrato. Se um aplicativo tiver declarado uma preferência de rotação para uma rotação diferente do dispositivo que está sendo exibido no momento, a rotação do sistema ocorrerá enquanto a tela inicial do aplicativo é exibida. A interface do usuário principal do aplicativo não será exibida até que a rotação do sistema seja concluída por trás dela.

Confira também

VisualElements

início rápido: criando um bloco padrão usando o editor de manifesto Visual Studio

Windows. Graphics. display. DisplayProperties. AutoRotationPreferences

Requisitos

	Valor
Namespace	http://schemas.microsoft.com/appx/2010/manifest