InitialRotationPreference (Paketschema für Windows 8)

Artikel
07/20/2023

Beschreibt die Ausrichtungen, in denen die App für eine optimale Benutzererfahrung angezeigt werden soll. Auf einem Gerät, das gedreht werden kann, z. B. einem Tablet, wird die App nicht für Ausrichtungen neu gezeichnet, die hier nicht angegeben sind. Wenn die App beispielsweise nur Querformat- und Querformatausrichtung angibt und das Gerät in hochformatierte Ausrichtung gedreht wird, wird die App nicht gedreht.

Beachten Sie, dass eine App auf Geräten, die nicht gedreht werden können, möglicherweise in der Standardausrichtung des Geräts angezeigt wird und die bevorzugte Ausrichtung der App ignoriert wird. Auf einem Gerät, auf dem eine Rotationssperre aktiviert ist, wird die bevorzugte Drehung Ihrer App jedoch weiterhin berücksichtigt.

Diese Ausrichtungseinstellungen gelten sowohl für den Begrüßungsbildschirm als auch für die App-Benutzeroberfläche, wenn eine neue Sitzung für Ihre App gestartet wird. Die Einstellungen können während der Laufzeit über die AutoRotationPreferences-Eigenschaft geändert werden.

Elementhierarchie

<Paket>

<Anwendungen>

<Anwendung>

<VisualElements>: <InitialRotationPreference>

Syntax

<InitialRotationPreference>

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

</InitialRotationPreference>

Schlüssel

{} bestimmter Bereich von Vorkommen

Attribute und Elemente

Attribute

Keine

Untergeordnete Elemente

Untergeordnetes Element	BESCHREIBUNG
Drehung	Gibt eine einzelne Drehungsausrichtung an, in der eine App angezeigt wird.

Übergeordnete Elemente

Übergeordnetes Element	BESCHREIBUNG
VisualElements	Beschreibt die visuellen Aspekte der UWP-App: Standardkachel, Logobilder, Text- und Hintergrundfarben, Anfangsbildschirmausrichtung, Begrüßungsbildschirm und Darstellung der Sperrbildschirmkachel.

Hinweise

Dieses Element ist Teil Ihrer App-Manifestdatei (package.appxmanifest). Im Microsoft Visual Studio Manifest-Editor befindet sich diese Einstellung auf der Registerkarte Anwendungsbenutzeroberfläche als "Unterstützte anfängliche Rotationen". Standardmäßig ist keine der Optionen ausgewählt. Dies bedeutet, dass alle Drehausrichtungen unterstützt werden. Wenn Sie entweder keine der Drehungen oder alle Drehungen auswählen, wird das gleiche Ergebnis erzielt.

Da Ihre App auf verschiedenen Gerätetypen (Desktop-PCs, Tablets, Laptops oder Smartphones) ausgeführt werden kann, ist es nicht möglich, dass Sie im Voraus wissen, welche Ausrichtung das Gerät zum Zeitpunkt des Starts Ihrer App hat, und dass das Gerät nicht gedreht wird, während die App aktiv ist. Aus diesem Grund wird empfohlen, dass Sie Ihre App mit der Möglichkeit entwickeln, in beliebiger Ausrichtung angezeigt zu werden. Allerdings kann Ihre App dieses Element verwenden, um Windows aufzufordern, die Anzeige Ihrer App auf die idealen Drehungen zu beschränken. Allerdings können Windows die Anforderung nicht immer einhalten. Da nicht alle Geräte gedreht oder drehbar sind, können Ausrichtungseinstellungen nicht immer von Windows berücksichtigt werden. Wenn Sie beispielsweise sagen, dass Ihre App im Hochformat angezeigt werden soll, die App jedoch auf einem standardmäßigen querformatorientierten Desktopmonitor oder auf einem Fernsehgerät ausgeführt wird, wird die Einstellung ignoriert, da die Anzeige der App auf ihrer Seite eine schlechte Benutzererfahrung wäre. Aus diesem Grund sollten Sie erwägen, alle Ausrichtungen zu unterstützen, damit Ihre App unabhängig von der Geräterotation gut aussieht.

Hinweis Da Desktop-PCs und Notebooks zu diesem Zeitpunkt die statistisch vorherrschenden Geräte bleiben, auf denen Ihre App wahrscheinlich ausgeführt wird, und da diese Geräte fast alle in Querformat ausgerichtet sind und keine Drehung erkennen, ist es erforderlich, dass eine App mindestens die Querformatrotation unterstützt. Obwohl dies unterstützt werden muss, müssen Sie Landscape nicht als bevorzugte Drehung deklarieren.

Dieses Element enthält bis zu 4 Rotationselemente , von denen jedes eine Ausrichtung angibt, in der die App bevorzugt angezeigt wird. Wenn Sie keine Rotationselemente einschließen, hat dies die gleiche Auswirkung wie alle vier Elemente.

Das folgende Beispiel zeigt eine App, die in Querformat und Querformat angezeigt wird, aber die Ausrichtung für ein Gerät in Hochformat oder Hochformat nicht ändert.

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

Wenn Ihre App zum ersten Mal gestartet wird, empfängt Windows ihre Rotationseinstellungen. Diese Einstellungen bleiben so lange bestehen, bis diese App beendet wird, mit einer wichtigen Ausnahme: , wenn ein Aufruf an Windows erfolgt. Graphics.Display.DisplayProperties.autoRotationPreferences zum Ändern dieser Einstellungen. Diese API wird verwendet, um Windows über eine Änderung der Rotationseinstellungen Ihrer App zu informieren und kann jederzeit aufgerufen werden. Beachten Sie, dass sich dieser API-Aufruf nicht auf den Inhalt des InitialRotationPreference-Elements in der Manifestdatei der App auswirkt, die beim Festlegen im Manifest-Editor verbleiben. Wenn Sie Ihre App neu starten, übernimmt sie daher die Rotationseinstellungen, die Sie ursprünglich im Manifest Ihrer App angegeben haben.

Betrachten Sie beispielsweise eine Spiel-App, die am besten in Querformat angezeigt wird, aber über eine bestimmte Seite verfügt, die eine Karte anzeigt, die in Hochformat besser lesbar ist. Die folgende Reihe von Ereignissen kann auf einem Gerät stattfinden, das die Drehung unterstützt. Eine Vertrautheit mit den Begriffen für den App-Lebenszyklus ist hier hilfreich.

Der Entwickler gibt die Einstellungen für die Querformat- und/oder Querformatrotation für die App im Manifest-Editor an.
Das Spiel wird installiert und gestartet. Die im Manifest-Editor angegebenen Einstellungen gelten, und das Spiel wird nicht in Hochformat gedreht.
Das Spiel erkennt, dass der Benutzer auf die Karte zugreift. Er ruft AutoRotationPreferences auf, um Windows an mitzuteilen, dass die Rotationseinstellungen der App in Hochformat und/oder Hochformat geändert werden sollen.
Windows rotiert die App zur neuen bevorzugten Ausrichtung.
Der Benutzer wechselt zu einer anderen App, um seine E-Mails zu überprüfen.
Der Benutzer wechselt zurück zur Spiel-App, um dort fortzufahren, wo er aufgehört hat. Windows weiß, dass die zuletzt angegebene Einstellung der App hochformatiert war und die App in dieser Ausrichtung auf dem Bildschirm angezeigt wird. Beachten Sie, dass nicht auf die InitialRotationPreference-Einstellungen verwiesen wurde, da die aktuelle Sitzung noch aktiv ist.
Das Spiel erkennt, dass der Benutzer die Kartenseite schließt. Er ruft AutoRotationPreferences auf, um seine Rotationseinstellungen wieder in die ursprünglichen Querformateinstellungen zu ändern, um das Spiel fortzusetzen.
Der Benutzer beendet das Spiel, und die App wird angehalten, nachdem der Benutzer für einen bestimmten Zeitraum fort navigiert.
Der Benutzer setzt die App fort, um ein anderes Spiel zu spielen. Da die App nicht neu gestartet wurde, gelten die letzten von der AutoRotationPreferences-API deklarierten Einstellungen weiterhin.
Das Spiel ist geschlossen (beendet).
Das Spiel wird neu gestartet. Da sie wieder von einem ersten Start aus beginnt, gelten die InitialRotationPreference-Einstellungen erneut.

Der wichtigste Punkt ist, dass Sie nach dem Aufruf von AutoRotationPreferences die Rotationseinstellungen über diese API verarbeiten müssen, bis das Spiel beendet (nicht nur angehalten) wird.

Wenn eine App gedreht wird, wird Windows mit ihr gedreht. Wenn Sie die App im Hochformat schließen, wird die Startbildschirm im Hochformat angezeigt. Wenn eine App eine Rotationseinstellung für eine andere Drehung angegeben hat, als das Gerät derzeit angezeigt wird, erfolgt die Drehung des Systems, während der Begrüßungsbildschirm der App angezeigt wird. Die Haupt-App-Benutzeroberfläche wird erst angezeigt, nachdem die Systemrotation abgeschlossen ist.

Siehe auch

VisualElements

Schnellstart: Erstellen einer Standardkachel mit dem Visual Studio Manifest-Editor

Windows. Graphics.Display.DisplayProperties.AutoRotationPreferences

Anforderungen

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