Инитиалротатионпреференце (схема расширений для Windows 8.1)

Статья
07/20/2023

Описывает ориентацию, в которой приложение предпочитается для наилучшего взаимодействия с пользователем. На устройстве, которое можно поворачивать, например планшете, приложение не будет перерисовано для ориентации, не указанных здесь. Например, если в приложении заданы только альбомные и Ландскапефлиппедные ориентации, а устройство поворачивается в книжную ориентацию, приложение не будет вращаться.

Обратите внимание, что на устройствах, которые невозможно поворачивать, приложение может отображаться на ориентации этого устройства по умолчанию, а предпочтительная ориентация приложения будет пропущена. Однако на устройстве, на котором активирована блокировка вращения, предпочтительное вращение вашего приложения по-прежнему будет учитываться.

Эти параметры ориентации применяются как к экрану-заставке , так и к пользовательскому интерфейсу приложения при запуске нового сеанса для приложения. Во время выполнения эти настройки можно изменить с помощью свойства AutoRotationPreferences .

Иерархия элементов

<VisualElements>: <InitialRotationPreference>

Синтаксис

<InitialRotationPreference>

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

</InitialRotationPreference>

Ключ

{} конкретный диапазон вхождений

Атрибуты и элементы

Атрибуты

Отсутствует.

Дочерние элементы

Дочерний элемент	Описание
Поворот	Задает одну ориентацию ротации, в которой будет отображаться приложение.

Родительские элементы

Родительский элемент	Описание
VisualElements	Описание визуальных аспектов приложения UWP: его плитки по умолчанию, изображения логотипа, цвета текста и фона, начальная ориентация экрана, экран-заставка и внешний вид плитки экрана блокировки.

Remarks

Этот элемент является частью файла манифеста приложения (Package. appxmanifest). в редакторе манифестов Microsoft Visual Studio этот параметр находится на вкладке пользовательского интерфейса приложения как "поддерживаемые начальные повороты". По умолчанию ни один из параметров не выбран. Это означает, что поддерживаются все ориентации вращения. Выбор любого из поворотов или всех поворотов дает тот же результат.

Так как ваше приложение можно запускать на различных типах устройств — настольных ПК, планшетах, ноутбуках или телефонах, вы не можете заранее получить знания о ориентации устройства на момент запуска приложения, а также о том, что устройство не будет повернуто при активном приложении. Поэтому рекомендуется разрабатывать приложение с возможностью отображения в любой ориентации. с другой стороны, приложение может использовать этот элемент, чтобы попросить Windows ограничить отображение приложения идеальными поворотами. однако Windows не всегда принимает запрос. Так как не все устройства могут быть повернуты или обнаружены повороты, предпочтения ориентации не всегда должны учитываться Windows. Например, если вы хотите, чтобы приложение отображалось в книжной ориентации, но приложение запущено на стандартном альбомном мониторе рабочего стола или на телевизоре, предпочтение будет проигнорировано, так как отображение приложения на его стороне будет плохим пользовательским интерфейсом. По этой причине следует рассмотреть поддержку всех ориентаций, чтобы ваше приложение хорошо выглядело независимо от смены устройства.

Примечание . Так как в настоящее время настольные компьютеры и записные книжки остаются статистически выглавными устройствами, на которых приложение, скорее всего, будет работать, и так как эти устройства почти полностью исправлены в альбомной ориентации и не обнаруживают поворот, приложение должно поддерживать по крайней мере альбомный поворот. Однако, хотя это и должно поддерживаться, вам не нужно объявлять альбомную ориентацию как предпочтительный поворот.

Этот элемент содержит до 4 элементов вращения , каждый из которых указывает ориентацию, в которой приложение предпочитает просмотр. Если элементы вращения не включены, то они будут иметь тот же результат, что и все четыре.

В следующем примере показано приложение, которое будет отображаться в альбомной и Ландскапефлиппед, но не изменит его ориентацию для устройства, хранящегося в книжной или Портраитфлиппед.

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

при первоначальном запуске приложения Windows получает параметры поворота. Эти настройки остаются на месте до завершения работы приложения с одним важным исключением: при обращении к Windows. Graphics. дисплея. DisplayInformation. autoRotationPreferences для изменения этих настроек. этот API используется для информирования Windows изменения в настройках ротации приложения и может быть вызван в любое время. Обратите внимание, что этот вызов API не влияет на содержимое элемента инитиалротатионпреференце в файле манифеста приложения, который остается в том виде, в каком они заданы в редакторе манифеста. Поэтому при каждом перезапуске приложения он принимает параметры вращения, изначально указанные в манифесте приложения.

Например, рассмотрим игровое приложение, которое лучше просматривается в альбомной ориентации, но на нем имеется определенная страница, на которой отображается схема, которая более удобочитаема в книжной ориентации. На устройстве, которое поддерживает вращение, может выполняться следующая последовательность событий. Вам будет удобно ознакомиться с условиями жизненного цикла приложения .

Разработчик задает альбомные и/или Ландскапефлиппед параметры вращения для приложения в редакторе манифеста.
Игра установлена и запускается. Параметры, указанные в редакторе манифеста, применяются, и игра не будет повернута в книжную ориентацию.
Игра обнаруживает, что пользователь обращается к карте. он вызывает AutoRotationPreferences , чтобы сообщить Windows изменить параметры ротации приложения на книжную или портраитфлиппед.
Windows поворачивает приложение на новую предпочитаемую ориентацию.
Пользователь переключается на другое приложение для проверки своей почты.
Пользователь переключается в игровое приложение, чтобы продолжить с того места, на котором они остановились. Windows известно, что последний заданный параметр приложения был для книжной ориентации, и приложение наводится на экран с этой ориентацией. Обратите внимание, что он не ссылается на параметры инитиалротатионпреференце , так как текущий сеанс все еще активен.
Игра обнаруживает, что пользователь закрывает страницу Map. Он вызывает AutoRotationPreferences для изменения настроек ротации до исходных параметров, чтобы продолжить игру.
Пользователь завершает игру и приложение приостанавливается, когда пользователь выходит за пределы определенного периода времени.
Пользователь возобновляет приложение для воспроизведения другой игры. Поскольку приложение не было перезапущено, последние параметры, объявленные с помощью API AutoRotationPreferences , по-прежнему применяются.
Игра закрыта (завершается).
Игра перезапускается. Так как он снова запускается после первоначального запуска, параметры инитиалротатионпреференце снова применяются.

Обратите внимание, что после того, как вы назвали AutoRotationPreferences, вы обязаны управлять параметрами ротации через этот API до тех пор, пока игра не будет завершена (а не просто приостановлена).

когда приложение поворачивается, Windows поворачивается с ним. Если закрыть приложение в книжной ориентации, начальный экран будет отображаться в книжной ориентации. Если приложение запустило режим вращения для другого вращения, чем устройство в данный момент отображается, то при отображении экрана-заставки приложения происходит вращение системы. Основной пользовательский интерфейс приложения не будет отображаться, пока не завершится вращение системы.

См. также раздел

VisualElements

краткое руководство. создание плитки по умолчанию с помощью редактора манифестов Visual Studio

Windows. Graphics. дисплея. DisplayInformation. AutoRotationPreferences

Требования

	Значение
Пространство имен	`http://schemas.microsoft.com/appx/2010/manifest`