VisualElements (схема пакета для Windows 8)

Статья
07/20/2023

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

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

<Пакет>

<Приложений>

<Приложение>: <VisualElements>

Синтаксис

<VisualElements DisplayName     = A string between 1 and 256 characters in length.
                Logo            = 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.
                SmallLogo       = 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.
                Description     = A string between 1 and 2048 characters in length that cannot include characters such as tabs, carriage returns, and line feeds.
                ForegroundText  = "light" | "dark"
                BackgroundColor = A three-byte hexadecimal number preceded by "#" or a named color.
                ToastCapable?   = boolean >

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

</VisualElements>

Ключ

? необязательный (ноль или один)

& соединитель с чередой (может происходить в любом порядке)

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

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
BackgroundColor	Задает цвет фона плитки приложения. Сведения о цветах см. в разделе "Примечания". Обратите внимание, что указанный здесь цвет фона также применяется к следующим элементам: Цвет кнопки в диалоговых окнах, принадлежащих приложению Страница "Описание приложения" в Microsoft Store Применяется к Windows Phone: выбор "прозрачный" приводит к использованию цвета элементов системы.	Шестнадцатеричное число с тремя байтами, предшествующим "#" или именованному цвету.	Да
Описание	Описание приложения. Эта строка локализуема; Дополнительные сведения см. в разделе "Примечания".	Строка длиной от 1 до 2048 символов, которая не может содержать такие символы, как табуляции, возврат каретки и веб-каналы строк.	Да
Отображаемое имя	Понятное имя приложения, которое может отображаться для пользователей. Эта строка локализуема; Дополнительные сведения см. в разделе "Примечания". Существует два явно зарезервированных слова, которые не могут использоваться в качестве displayName для приложений, отправленных в Microsoft Store: NoUIEntryPoints и NoUIEntryPoints-DesignMode. Эти идентификаторы зарезервированы для использования средствами разработки и наборами тестов.	Строка длиной от 1 до 256 символов.	Да
ForegroundText	Задает цвет переднего плана плитки приложения. Применяется к Windows Phone: это значение игнорируется. Все плитки используют светлый цвет текста.	Этот атрибут может иметь одно из следующих значений: свет Темно	Да
Логотип	Изображение, используемое в качестве квадратной плитки приложения. Дополнительные сведения об указании изображения в этом атрибуте см. в разделе "Примечания".	Строка длиной от 1 до 256 символов, заканчивающаяся символами ".jpg", ".png" или ".jpeg", которые не могут содержать следующие символы: <, : , >:, %, ", \|, ?или *. В этой строке символы / и \ не могут быть первыми или последними символами. Кроме того, строка может содержать /или \, но не оба.	Да
SmallLogo	Небольшое изображение, показанное в углу плитки для идентификации приложения. Дополнительные сведения об указании изображения в этом атрибуте см. в разделе "Примечания". Применяется к Windows Phone: Windows Phone не отображает небольшой логотип на плитке. Он используется только в списке приложений.	Строка длиной от 1 до 256 символов, заканчивающаяся символами ".jpg", ".png" или ".jpeg", которые не могут содержать следующие символы: <, : , >:, %, ", \|, ?или *. В этой строке символы / и \ не могут быть первыми или последними символами. Кроме того, строка может содержать /или \, но не оба.	Да
ToastCapable	Значение true указывает, что приложению разрешено предоставлять всплывающие уведомления. Значение по умолчанию — false. Если вы не хотите отображать всплывающие уведомления, не указывайте значение этого атрибута. Обратите внимание, что приложения не должны принимать решения о том, следует ли отправлять всплывающие уведомления на основе этого значения.	Логическое	Нет

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

Дочерний элемент	Описание
DefaultTile	Плитка по умолчанию, представляющая приложение на начальном экране. Эта плитка отображается при первой установке приложения перед получением уведомлений об обновлении. Если на плитке нет уведомлений для отображения, плитка возвращается к этому значению по умолчанию.
InitialRotationPreference	Описывает ориентации, в которых приложение предпочитает отображаться для оптимального взаимодействия с пользователем. На устройстве, которое можно повернуть, например планшет, приложение не будет перерисовано для ориентации, которые здесь не указаны. Например, если приложение задает только ориентацию альбомной и альбомной ориентации, а устройство поворачивается в книжную ориентацию, приложение не будет поворачиваться. Обратите внимание, что на устройствах, которые нельзя повернуть, приложение может отображаться в ориентации этого устройства по умолчанию, и предпочтительная ориентация приложения будет игнорироваться. Однако на устройстве с активированной блокировкой поворота предпочтительный поворот приложения по-прежнему будет учитываться. Эти параметры ориентации применяются как к [экрану-заставке](element-splashscreen.md), так и к пользовательскому интерфейсу приложения при запуске нового сеанса для приложения. Настройки можно изменить во время выполнения с помощью [AutoRotationPreferences](/uwp/api/Windows. Свойство Graphics.Display.DisplayProperties).
LockScreen	Определяет эмблему и уведомления, представляющие приложение на экране блокировки, которое отображается при блокировке системы.
SplashScreen	Определяет внешний вид экрана-заставки, который отображается приложением во время запуска.

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

Родительский элемент	Описание
Приложение	Представляет приложение, которое состоит из части или всех функциональных возможностей, предоставляемых в пакете.

Remarks

Дополнительные сведения о требованиях к измерению плиток см. в разделе "Размеры плиток".

Изображения с логотипом и SmallLogo можно указать как прямой путь к файлу изображения или как ресурсу. С помощью ссылок на ресурсы вы можете предоставить изображения различных масштабов, чтобы ОС Windows смогла выбрать оптимальный размер для устройства и разрешения экрана. Кроме того, вы можете предоставить высококонтрастные изображения для обеспечения специальных возможностей и локализованные изображения для различных языков пользовательского интерфейса. Эта функция также позволяет локализовать атрибуты DisplayName и Description . Дополнительные сведения см. в разделе "Глобализация ".

Applications/Application/Extensions/Extension/FileTypeAssociation/Logo Applications/Application/Extensions/Extension/Protocol/Logo

Ниже приведены требования к размеру двух типов изображений логотипов:

Размер изображения в пикселях Application\Application\VisualElements\@Logo 100 150x150 140 210x210 180 270x270 Applications\Application\VisualElements\@SmallLogo 100 30x30 140 42x42 180 54x54

Это поддерживаемые имена цветов фона:

Имя	Имя	Имя	Имя	Имя	Имя
АлисаBlue	антикварныйwhite	Бирюзовый	Аквамариновый	azure	Бежевый
Светло-коричневый	black	blanchedAlmond	blue	blueViolet	Коричневый
burlyWood	cadetBlue	Фисташковый	Шоколад	Коралловый	cornflowerBlue
Кремово-лимонный	Алый	Зеленовато-голубой	darkBlue	darkCyan	darkGoldenrod
darkGray	darkGreen	darkKhaki	darkMagenta	darkOliveGreen	darkOrange
darkOrchid	darkRed	darkSalmon	darkSeaGreen	darkSlateBlue	darkSlateGray
darkTurquoise	darkViolet	deepPink	deepSkyBlue	dimGray	dodgerBlue
Красный кирпич	floralWhite	forestGreen	Фуксия	Серо-фиолетовый, светлый	ghostWhite
Золотистый	Светлый желто-коричневый	Серый	green	greenYellow	Медовый
hotPink	indianRed	Индиго	Слоновая кость	Хаки	Бледный розовато-лиловый
ЛавандерБлуш	lawnGreen	lemonChiffon	lightBlue	lightCoral	lightCyan
lightGoldenrodYellow	lightGreen	lightGray	lightPink	lightSalmon	lightSeaGreen
lightSkyBlue	lightSlateGray	lightSteelBlue	lightYellow	lime	limeGreen
Льняной	Пурпурный	Малиновый	mediumAquamarine	mediumBlue	mediumOrchid
mediumPurple	mediumSeaGreen	mediumSlateBlue	mediumSpringGreen	mediumTurquoise	mediumVioletRed
midnightBlue	mintCream	mistyRose	Болотный	navajoWhite	Глубокий темно-синий
oldLace	Оливковый	oliveDrab	orange	orangeRed	Лиловый
палеГолденрод	paleGreen	палетуркуза	paleVioletRed	папаяWhip	персик
Рыжевато-коричневый	pink	Сливовый	powderBlue	purple	красный
RosyBrown	royalBlue	saddleBrown	Оранжево-розовый	sandyBrown	seaGreen
Раковины	Охра	Светло-серый	skyBlue	slateBlue	slateGray
Снежно-белый	springGreen	steelBlue	tan	Сине-зеленый	Чертополох
Томат	transparent	Бирюзовый	Фиолетовый	Пшеничный	white
Whitesmoke	yellow	yellowGreen

Примеры

Следующий пример взят из манифеста пакета примера пакета SDK.

                    
<Applications>
    <Application Id="App" StartPage="default.html">
        <VisualElements 
            DisplayName="ApplicationDataSample" 
            Logo="images\squareTile-sdk.png" 
            SmallLogo="images\smallTile-sdk.png" 
            Description="Application data sample" 
            ForegroundText="dark" 
            BackgroundColor="#FFFFFF" 
            ToastCapable="false">
            <DefaultTile ShowName="allLogos"/>
            <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
        </VisualElements>
    </Application>
</Applications>

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

Снимки экрана и изображения приложения

Класс Colors

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

Требования

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

Поделиться через