InitialRotationPreference (schema del pacchetto per Windows 8)

Articolo
07/20/2023

Descrive gli orientamenti in cui l'app preferisce essere visualizzata per la migliore esperienza utente. In un dispositivo che può essere ruotato, ad esempio un tablet, l'app non verrà ridisegnata per gli orientamenti non specificati qui. Ad esempio, se l'app specifica solo gli orientamenti Landscape e LandscapeFlipped e il dispositivo viene ruotato con orientamento Verticale, l'app non verrà ruotata.

Si noti che nei dispositivi che non possono essere ruotati, un'app potrebbe essere visualizzata con l'orientamento predefinito del dispositivo e l'orientamento preferito dell'app verrà ignorato. Tuttavia, in un dispositivo con un blocco di rotazione attivato, la rotazione preferita dell'app verrà comunque rispettata.

Queste scelte di preferenza di orientamento si applicano sia alla schermata iniziale che all'interfaccia utente dell'app quando viene avviata una nuova sessione per l'app. Le preferenze possono essere modificate in fase di esecuzione tramite la proprietà AutoRotationPreferences .

Gerarchia degli elementi

<Pacchetto>

<Applicazioni>

<Applicazione>

<VisualElements>: <InitialRotationPreference>

Sintassi

<InitialRotationPreference>

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

</InitialRotationPreference>

Chiave

{} intervallo specifico di occorrenze

Attributi ed elementi

Attributi

Nessuno.

Elementi figlio

Elemento figlio	Descrizione
Rotazione	Specifica un singolo orientamento di rotazione in cui verrà visualizzata un'app.

Elementi padre

Elemento padre	Descrizione
VisualElements	Descrive gli aspetti visivi dell'app UWP: riquadro predefinito, immagini del logo, colori di testo e sfondo, orientamento iniziale dello schermo, schermata iniziale e aspetto del riquadro della schermata di blocco.

Commenti

Questo elemento fa parte del file manifesto dell'app (package.appxmanifest). Nell'editor Microsoft Visual Studio manifesto questa impostazione si trova nella scheda Interfaccia utente applicazione come "Rotazioni iniziali supportate". Per impostazione predefinita, nessuna delle opzioni è selezionata. Ciò significa che sono supportati tutti gli orientamenti di rotazione. La selezione di nessuna delle rotazioni o di tutte le rotazioni restituisce lo stesso risultato.

Poiché l'app può essere eseguita in diversi tipi di dispositivo, ovvero PC desktop, tablet, portatili o telefoni, non è possibile avere una conoscenza avanzata dell'orientamento del dispositivo al momento dell'avvio dell'app né che il dispositivo non verrà ruotato mentre l'app è attiva. È pertanto consigliabile sviluppare l'app con la possibilità di essere visualizzata in qualsiasi orientamento. Detto questo, l'app può usare questo elemento per Windows limitare la visualizzazione dell'app alle rotazioni ideali. Tuttavia, Windows non può sempre rispettare la richiesta. Poiché non tutti i dispositivi possono essere ruotati o rilevati, le preferenze di orientamento non possono sempre essere rispettate Windows. Ad esempio, se si indica che l'app deve essere visualizzata in verticale, ma l'app viene eseguita su un monitor desktop orientato al panorama standard o su una tv, la preferenza verrà ignorata perché la visualizzazione dell'app sul lato sarebbe un'esperienza utente scadente. Per questo motivo, è consigliabile prendere in considerazione il supporto di tutti gli orientamenti in modo che l'app sia buona indipendentemente dalla rotazione del dispositivo.

Nota Poiché in questo momento i PC desktop e i notebook rimangono i dispositivi statisticamente predominanti su cui è probabile che l'app sia in esecuzione e poiché questi dispositivi sono quasi tutti fissi con orientamento orizzontale e non rilevano la rotazione, è necessario che un'app supporti almeno la rotazione Orizzontale. Tuttavia, anche se deve essere supportato, non è necessario dichiarare Landscape come rotazione preferita.

Questo elemento contiene fino a 4 elementi Rotation , ognuno dei quali specifica un orientamento in cui l'app preferisce essere visualizzata. Se non si includono elementi Rotation , ha lo stesso effetto dell'inclusione di tutti e quattro.

L'esempio seguente mostra un'app che verrà visualizzata in Landscape e LandscapeFlipped, ma non ne modifica l'orientamento per un dispositivo con orientamento Verticale o VerticaleFlipped.

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

Quando l'app viene avviata inizialmente, Windows le preferenze di rotazione. Queste preferenze rimangono invariate fino a quando l'app non viene terminata, con un'eccezione importante: se viene effettuata una chiamata a Windows. Graphics.Display.DisplayProperties.autoRotationPreferences per modificare tali preferenze. Tale API viene usata per Windows una modifica nelle preferenze di rotazione dell'app e può essere chiamata in qualsiasi momento. Si noti che questa chiamata API non influisce sul contenuto dell'elemento InitialRotationPreference nel file manifesto dell'app, che rimangono così come vengono impostati nell'editor manifesto. Pertanto, ogni volta che si riavvia l'app, vengono accettate le preferenze di rotazione specificate originariamente nel manifesto dell'app.

Si consideri ad esempio un'app di gioco più visualizzata in Orizzontale, ma con una determinata pagina che visualizza una mappa più leggibile in Verticale. La serie di eventi seguente potrebbe verificarsi in un dispositivo che supporta la rotazione. Una familiarità con i termini del ciclo di vita delle app sarà utile qui.

Lo sviluppatore specifica le preferenze di rotazione Landscape e/o LandscapeFlipped per l'app nell'editor manifesto.
Il gioco viene installato e avviato. Le preferenze specificate nell'editor manifesto si applicano e il gioco non verrà ruotato in verticale.
Il gioco rileva che l'utente accede alla mappa. Chiama AutoRotationPreferences per indicare Windows le preferenze di rotazione dell'app in Verticale e/o VerticalFlipped.
Windows ruota l'app nel nuovo orientamento preferito.
L'utente passa a un'altra app per controllare la posta.
L'utente torna all'app di gioco per continuare dal punto in cui è stato lasciato. Windows che l'ultima preferenza indicata dell'app era verticale e porta l'app sullo schermo con tale orientamento. Si noti che non fa riferimento alle impostazioni InitialRotationPreference perché la sessione corrente è ancora attiva.
Il gioco rileva che l'utente sta chiudendo la pagina della mappa. Chiama AutoRotationPreferences per modificare le preferenze di rotazione nelle impostazioni originali orizzontali per continuare il gioco.
L'utente completa il gioco e l'app viene sospesa dopo che l'utente si è allontanato per un certo periodo di tempo.
L'utente riprende l'app per riprodurre un altro gioco. Poiché l'app non è stata rilasciata, si applicano comunque le ultime preferenze dichiarate dall'API AutoRotationPreferences .
Il gioco è chiuso (terminato).
Il gioco viene riavviato. Poiché inizia di nuovo da un avvio iniziale, vengono applicate nuovamente le impostazioni InitialRotationPreference .

Il punto chiave da notare è che dopo aver chiamato AutoRotationPreferences, è responsabilità dell'utente gestire le preferenze di rotazione tramite tale API fino a quando il gioco non viene terminato (non semplicemente sospeso).

Quando un'app ruota, Windows ruota con essa. Se si chiude l'app in verticale, il schermata Start visualizzato in Verticale. Se un'app ha indicato una preferenza di rotazione per una rotazione diversa da quella attualmente visualizzata dal dispositivo, la rotazione del sistema si verifica mentre viene visualizzata la schermata iniziale dell'app. L'interfaccia utente principale dell'app non verrà visualizzata fino al completamento della rotazione del sistema.

Vedi anche

VisualElements

Guida introduttiva: Creazione di un riquadro predefinito usando l'editor Visual Studio manifesto

Windows. Graphics.Display.DisplayProperties.AutoRotationPreferences

Requisiti

	Valore
Namespace	`http://schemas.microsoft.com/appx/2010/manifest`