InitialRotationPreference (Windows 8.1)

[アーティクル]
07/20/2023

最適なユーザーエクスペリエンスのためにアプリを表示する方向について説明します。タブレットなど、回転できるデバイスでは、ここで指定されていない向きに対してアプリが再描画されません。たとえば、アプリが横向きと横向きのみを指定し、デバイスが縦向きに回転する場合、アプリは回転されません。

回転できないデバイスでは、そのデバイスの既定の向きにアプリが表示され、アプリの優先方向は無視される可能性があります。ただし、ローテーションロックがアクティブになっているデバイスでは、アプリの優先ローテーションは引き続き受け入れらされます。

これらの向きの優先設定の選択は、アプリの新しいセッションが起動するときに、スプラッシュスクリーンとアプリ UI の両方に適用されます。ユーザー設定は、 実行時に AutoRotationPreferences プロパティを使用して変更 できます。

要素の階層

<VisualElements>: <InitialRotationPreference>

構文

<InitialRotationPreference>

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

</InitialRotationPreference>

キー

{} 特定の出現範囲

属性および要素

属性

なし。

子要素

子要素	説明
回転	アプリを表示する単一の回転方向を指定します。

親要素

Parent 要素	説明
VisualElements	UWP アプリの視覚的な側面 (既定のタイル、ロゴ画像、テキストと背景色、初期画面の向き、スプラッシュスクリーン、ロック画面のタイルの外観) について説明します。

注釈

この要素は、アプリマニフェストファイル (package.appxmanifest) の一部です。マニフェストエディター Microsoft Visual Studio、この設定は [アプリケーション UI] タブの [サポートされている初期ローテーション] として表示されます。既定では、どのオプションも選択されません。つまり、すべての回転方向がサポートされています。回転を選択しないか、すべての回転を選択すると、同じ結果が得られます。

アプリはデスクトップ PC、タブレット、ノート PC、スマートフォンなど、さまざまなデバイスの種類で実行できます。アプリの起動時のデバイスの向きに関する事前の知識や、アプリがアクティブな間にデバイスが回転しないという保証はありません。そのため、任意の向きに表示できるアプリを開発することをお勧めします。しかし、アプリでは、この要素を使用して、アプリWindowsの表示を理想的な回転に制限する必要があります。ただし、Windows要求を常に受け入れすることはできません。すべてのデバイスを回転したり回転を検出したりできるとは限らないので、回転の優先設定は常にデバイスのWindows。たとえば、アプリを縦向きに表示する必要があるが、アプリが標準の横向きデスクトップモニターまたはテレビで実行されている場合、アプリを横に表示するとユーザーエクスペリエンスが低下するので、設定は無視されます。このため、デバイスのローテーションに関係なくアプリが良好に表示されるように、すべての向きをサポートする必要があります。

メモ現時点では、デスクトップ PC とノートブックは、アプリが実行される可能性が高い統計的に主要なデバイスのままであり、それらのデバイスのほとんどすべてが横向きに固定され、回転を検出しないので、アプリが少なくとも横向きの回転をサポートする必要があります。ただし、サポートされている必要がある一方で、優先ローテーションとしてランドスケープを宣言する必要はありません。

この要素には最大 4 つの Rotation 要素が含まれています。各要素は、アプリを表示する方向を指定します。 Rotation 要素を含 めない 場合は、4 つすべての要素を含めるのと同じ効果があります。

次の例は、横長と横向きに表示されるアプリを示していますが、縦または縦に保持されているデバイスの向きは変更されません。

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

アプリが最初に起動すると、Windows設定を受け取ります。これらの基本設定は、そのアプリが終了するまでそのまま残ります。ただし、1 つの重要な例外として、アプリの呼び出しが行Windows。これらの基本設定を変更する Graphics.Display.DisplayInformation.autoRotationPreferences。この API は、アプリWindowsの変更をユーザーに通知するために使用され、いつでも呼び出されます。この API 呼び出しは、アプリのマニフェストファイル内の InitialRotationPreference 要素の内容には影響しません。これは、マニフェストエディターで設定したままです。そのため、アプリを再起動するたびに、アプリのマニフェストで最初に指定したローテーション設定が使用されます。

たとえば、ランドスケープで最も表示されているが、縦に読み取り可能なマップを表示する特定のページがあるゲームアプリを考えます。回転をサポートするデバイスでは、次の一連のイベントが発生する可能性があります。ここでは、アプリライフサイクルの用語に関する理解が役立ちます。

開発者は、マニフェストエディターでアプリの横向きまたは横向き (あるいはその一方) の回転設定を指定します。
ゲームがインストールされ、起動されます。マニフェストエディターで指定された基本設定が適用され、ゲームは縦に回転されません。
ゲームは、ユーザーがマップにアクセスしているのを検出します。 AutoRotationPreferences を呼び出して、Windows にアプリの回転の基本設定を Portrait や PortraitFlipped に変更します。
Windowsアプリを新しい優先方向に回転させます。
ユーザーは別のアプリに切り替え、メールを確認します。
ユーザーはゲームアプリに切り替え、離れ離れした場所を続行します。 Windowsアプリの最後に指定された設定が縦向きだったことを知り、アプリをその向きに画面に表示します。現在のセッションがまだアクティブなので 、InitialRotationPreference 設定を参照しなかった点に注意してください。
ゲームは、ユーザーがマップページを閉じるのを検出します。 AutoRotationPreferences を呼び出して、回転の基本設定を元の横向き設定に戻してゲームを続行します。
ユーザーがゲームを終了すると、ユーザーがしばらくの間移動した後、アプリが中断されます。
ユーザーはアプリを再開して別のゲームをプレイします。アプリが再起動されていないので、 AutoRotationPreferences API によって宣言された最後の基本設定が引き続き適用されます。
ゲームが閉じられました (終了)。
ゲームが再起動されます。これは最初の起動から再び開始されるので、 InitialRotationPreference 設定が再度適用されます。

重要な点は、 AutoRotationPreferences を呼び出した後、ゲームが終了するまで (単に中断されるのではなく) その API を介して回転の基本設定を処理する必要がある点です。

アプリが回転すると、Windows回転します。アプリを [縦] で閉じると、スタート画面縦に表示されます。デバイスが現在表示している回転とは異なる回転の設定をアプリが示している場合、アプリのスプラッシュスクリーンが表示されている間にシステムの回転が発生します。メインアプリの UI は、その背後でシステムのローテーションが完了するまで表示されません。

要件

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

次の方法で共有

InitialRotationPreference (Windows 8.1)

要素の階層

構文

キー

属性および要素

属性

子要素

親要素

注釈

関連項目

要件

フィードバック

その他のリソース