VisualElements (Schema für Featureerweiterungen für Windows 8.1)

Artikel
07/20/2023

Beschreibt die visuellen Aspekte der UWP-App: Standardkachel, Logobilder, Text- und Hintergrundfarben, anfängliche Bildschirmausrichtung, Begrüßungsbildschirm und Darstellung der Sperrbildschirmkachel.

Elementhierarchie

<VisualElements>

Syntax

<VisualElements Square150x150Logo = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both.
                Square30x30Logo   = A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that can't contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters can't be the first or last characters. Also, the string can contain / or \ but not both. >

  <!-- Child elements -->
  ( DefaultTile?
  & LockScreen?
  & SplashScreen
  & InitialRotationPreference?
  & ApplicationView?
  )

</VisualElements>

Schlüssel

? optional (null oder eins)

& Verwebungsconnector (kann in beliebiger Reihenfolge auftreten)

Attribute und Elemente

Attributes

Attribut	BESCHREIBUNG	Datentyp	Erforderlich	Standardwert
Square150x150Logo	Ein 150 x 150-Bild, das als quadratische Kachel der App verwendet wird. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter Hinweise.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die mit ".jpg", ".png" oder ".jpeg" endet, die diese Zeichen nicht enthalten kann: <, >, :, ", \|, ? oder *. In dieser Zeichenfolge dürfen die Zeichen / und \ nicht das erste oder letzte Zeichen sein. Außerdem kann die Zeichenfolge / oder \ enthalten, aber nicht beides.	Ja
Square30x30Logo	Ein 30 x 30-Bild, das als quadratische Kachel der App verwendet wird. Weitere Informationen zum Angeben des Bilds in diesem Attribut finden Sie unter Hinweise.	Eine Zeichenfolge zwischen 1 und 256 Zeichen, die mit ".jpg", ".png" oder ".jpeg" endet, die diese Zeichen nicht enthalten kann: <, >, :, ", \|, ? oder *. In dieser Zeichenfolge dürfen die Zeichen / und \ nicht das erste oder letzte Zeichen sein. Außerdem kann die Zeichenfolge / oder \ enthalten, aber nicht beides.	Ja

Untergeordnete Elemente

Untergeordnetes Element	BESCHREIBUNG
ApplicationView	Beschreibt, wie die App auf dem Bildschirm angezeigt wird.
DefaultTile	Die Standardkachel, die die App auf dem Startbildschirm. Diese Kachel wird angezeigt, wenn die App zum ersten Mal installiert wird, bevor sie Updatebenachrichtigungen empfangen hat. Wenn für eine Kachel keine Benachrichtigungen angezeigt werden sollen, wird diese Standardeinstellung wieder aktiviert.
InitialRotationPreference	Beschreibt die Ausrichtungen, in denen die App bevorzugt angezeigt werden soll, um die beste Benutzererfahrung zu bieten. 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 Querformatausrichtungen angibt und das Gerät in hochformatierte Ausrichtung gedreht wird, wird die App nicht gedreht. Beachten Sie, dass auf Geräten, die nicht gedreht werden können, eine App möglicherweise in der Standardausrichtung dieses 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 verwendet. Diese Ausrichtungseinstellungen gelten sowohl für den [Begrüßungsbildschirm](element-splashscreen.md) als auch für die App-Benutzeroberfläche, wenn eine neue Sitzung für Ihre App gestartet wird. Die Einstellungen können zur Laufzeit über [AutoRotationPreferences](/uwp/api/Windows. Graphics.Display.DisplayInformation)-Eigenschaft.
LockScreen	Definiert den Badge und die Benachrichtigungen, die die App auf dem Sperrbildschirm darstellen, der angezeigt wird, wenn das System gesperrt ist.
SplashScreen	Definiert die Darstellung des Begrüßungsbildschirms, der von der App während des Starts angezeigt wird.

Übergeordnete Elemente

Dieses äußerste Element (Dokument) darf nicht in anderen Elementen enthalten sein.

Hinweise

Weitere Informationen zu visuellen Aspekten für Apps finden Sie unter VisualElements.

Das Manifest führt diese semantischen Überprüfungen für VisualElements durch, die im Schema nicht erzwungen werden.

Wenn DefaultTile\Square310x310Logo angegeben ist, muss auch DefaultTile\Wide310x150Logo angegeben werden.
Wenn DefaultTile\DefaultSize oder ShowNameOnTiles einen bestimmten Bildgrößenwert angeben, muss diese Bildgröße im Manifest deklariert worden sein.
Wenn LockScreen\Notification auf badgeAndTileText festgelegt ist, muss DefaultTile\Wide310x150Logo angegeben werden.

Square150x150Logo - und Square30x30Logo-Bilder können entweder als direkter Pfad zu einer Bilddatei oder als Ressource angegeben werden. Mithilfe eines Ressourcenverweises können Sie lokalisierte Bilder für unterschiedliche Sprachen der Benutzeroberfläche liefern. Weitere Informationen finden Sie im Thema Globalisierung .

Anforderungen

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

Freigeben über