共用方式為

適用于 Windows 8) 的 InitialRotationPreference (套件架構

  • 發行項

描述應用程式偏好顯示的方向，以獲得最佳使用者體驗。 在可以旋轉的裝置上（例如平板電腦），將不會針對此處未指定的方向重新繪製應用程式。 例如，如果應用程式只指定橫向和 LandscapeFlipped 方向，而裝置旋轉為直向，應用程式將不會旋轉。

請注意，在無法旋轉的裝置上，應用程式可能會以該裝置的預設方向顯示，而應用程式的慣用方向將會被忽略。 不過，在啟用旋轉鎖定的裝置上，仍會接受您應用程式的慣用旋轉。

當您的應用程式啟動新的會話時，這些方向喜好設定選項會套用至 啟動顯示畫面 和應用程式 UI。 您可以透過 displayproperties.autorotationpreferences 屬性，在執行時間變更喜好設定。

元素階層

<套件>
<應用程式>
<應用>
<VisualElements>
<InitialRotationPreference>

語法

<InitialRotationPreference>

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

</InitialRotationPreference>

答案

{} 出現的特定範圍

屬性和項目

屬性

無。

子元素

子元素 描述
旋轉

指定應用程式將顯示的單一旋轉方向。

 

父項目

Parent 項目 描述
VisualElements

描述 UWP 應用程式的視覺層面：其預設磚、標誌影像、文字和背景色彩、初始螢幕方向、啟動顯示畫面，以及鎖定畫面磚外觀。

 

備註

此元素是您的應用程式資訊清單檔 (package.appxmanifest) 的一部分。 在 Microsoft Visual Studio 資訊清單編輯器中，此設定位於 [應用程式 UI ] 索引標籤的 [支援的初始輪替] 下。 依預設，不會選取任何選項。 這表示支援所有的旋轉方向。 選取沒有任何旋轉或所有旋轉都會產生相同的結果。

因為您的應用程式可以在不同的裝置類型（桌上型電腦、平板電腦、膝上型電腦或手機）上執行，所以您無法在應用程式啟動時事先掌握裝置方向的知識，也不會在應用程式啟用時輪替裝置。 因此，我們建議您開發應用程式，使其能夠以任何方向顯示。 話雖如此，您的應用程式可以使用此元素要求 Windows 將應用程式的顯示限制為其理想的旋轉。 不過，Windows 不能一律接受要求。 因為並非所有裝置都可以旋轉或偵測旋轉，所以 Windows 不一定會接受方向喜好設定。 比方說，如果您的應用程式應該以直向顯示，但應用程式是在標準的橫向桌面監視器或電視上執行，則會忽略喜好設定，因為在其端顯示應用程式是不佳的使用者體驗。 基於這個理由，您應該考慮支援所有方向，讓您的應用程式看起來很不錯，不論裝置是否有旋轉。

注意 因為在這段時間，桌上型電腦和筆記本仍會維持您的應用程式可能執行所在的統計主流裝置，而且這些裝置幾乎全都以橫向方式固定，且不會偵測到旋轉，因此應用程式必須至少支援橫向旋轉。 不過，雖然必須支援，但您不需要將橫向宣告為慣用的旋轉。

 

此元素包含最多4個 旋轉 元素，其中每個專案都會指定要查看應用程式的方向。 如果您未包含任何 旋轉 元素，則其效果與全部包含四個相同。

下列範例顯示的應用程式將會顯示在橫向和 LandscapeFlipped，但不會變更直向或 PortraitFlipped 的裝置方向。

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

當您的應用程式一開始啟動時，Windows 會收到其旋轉喜好設定。 在該應用程式終止之前，這些喜好設定會維持不變，但有一個重要的例外狀況：如果呼叫Windows。DisplayProperties. Displayproperties.autorotationpreferences以變更這些喜好設定。 該 API 會用來通知 Windows 您應用程式的旋轉喜好設定中的變更，並可在任何時間呼叫。 請注意，此 API 呼叫不會影響應用程式資訊清單檔中 InitialRotationPreference 元素的內容，這會隨著您在資訊清單編輯器中的設定而維持。 因此，每當您重新開機應用程式時，它會採用您原本在應用程式資訊清單中指定的旋轉喜好設定。

例如，請考慮最適合橫向查看的遊戲應用程式，但該應用程式的特定頁面會顯示更能在直向中讀取的地圖。 下列一系列的事件可能會發生在支援輪替的裝置上。 您可以熟悉 應用程式生命週期 的條款，這對您很有説明。

  1. 開發人員會在資訊清單編輯器中指定應用程式的橫向和/或 LandscapeFlipped 旋轉喜好設定。
  2. 遊戲已安裝並啟動。 資訊清單編輯器中指定的喜好設定會套用，而遊戲將不會旋轉為直向。
  3. 遊戲偵測到使用者正在存取地圖。 它會呼叫displayproperties.autorotationpreferences ，告知 Windows 將應用程式的旋轉喜好設定變更為直向和/或 PortraitFlipped。
  4. Windows 將應用程式旋轉為新的慣用方向。
  5. 使用者切換至另一個應用程式來檢查其電子郵件。
  6. 使用者切換回游戲應用程式，以繼續離開的位置。 Windows 知道應用程式的上次陳述喜好設定是針對直向，並讓應用程式進入該方向。 請注意，它並未參考 InitialRotationPreference 設定，因為目前的會話仍在使用中。
  7. 遊戲偵測到使用者正在關閉 [地圖] 頁面。 它會呼叫 displayproperties.autorotationpreferences ，將其旋轉喜好設定改回原始的橫向設定，以繼續玩遊戲。
  8. 使用者完成遊戲之後，應用程式會在使用者離開一段時間後暫停。
  9. 使用者繼續應用程式來播放另一個遊戲。 因為尚未 relaunched 應用程式，所以 Displayproperties.autorotationpreferences API 所宣告的最後一個喜好設定仍適用。
  10. 遊戲已關閉 (終止) 。
  11. 遊戲已重新開機。 因為它會再次從初始啟動啟動，所以 InitialRotationPreference 設定同樣適用。

要注意的重點是，一旦您呼叫 displayproperties.autorotationpreferences之後，您就必須負責透過該 API 處理旋轉喜好設定，直到遊戲終止為止 (而不只是暫停) 。

當應用程式輪替時，Windows 使用它來旋轉。 如果您以直向方式關閉應用程式，則開始畫面會以直向顯示。 如果應用程式所述的旋轉喜好設定與裝置目前顯示的不同，則會在顯示應用程式的啟動顯示畫面時，進行系統的輪替。 主要應用程式 UI 在系統輪替完成後才會顯示。

另請參閱

VisualElements

快速入門：使用 Visual Studio 資訊清單編輯器建立預設磚

Windows。Graphics. DisplayProperties. Displayproperties.autorotationpreferences

需求

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