Висуалелементс (схема расширений для Windows 8.1)

Статья
07/20/2023

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

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

<VisualElements>

Синтаксис

<VisualElements DisplayName     = A string between 1 and 256 characters in length. This string is localizable. 
                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
                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. >

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

</VisualElements>

Ключ

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

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

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

Атрибуты

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

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

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

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

Этот внешний элемент (Document) не может содержаться в каких-либо других элементах.

Remarks

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

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

Приложения/приложения/расширения/расширение/ФилетипеассоЦиатион/логотип приложения/приложение/расширения/расширение/протокол/логотип

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

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

Поддерживаются следующие имена цветов фона:

Имя	Имя	Имя	Имя	Имя	Имя
aliceBlue	антикуевхите	Бирюзовый	Аквамариновый	azure	Бежевый
Светло-коричневый	black	бланчедалмонд	blue	блуевиолет	Коричневый
бурливуд	кадетблуе	Фисташковый	Шоколад	Коралловый	cornflowerBlue
Кремово-лимонный	Алый	Зеленовато-голубой	даркблуе	даркциан	даркголденрод
даркграй	даркгрин	дарккхаки	даркмажента	дарколивегрин	даркоранже
даркорчид	даркред	дарксалмон	дарксеагрин	даркслатеблуе	даркслатеграй
дарктуркуоисе	дарквиолет	диппинк	дипскиблуе	димграй	доджерблуе
Красный кирпич	флоралвхите	форестгрин	Фуксия	Серо-фиолетовый, светлый	гхоствхите
Золотистый	Светлый желто-коричневый	Серый	green	гринеллов	Медовый
хотпинк	индианред	Индиго	Слоновая кость	Хаки	Бледный розовато-лиловый
лавендерблуш	лавнгрин	лемончиффон	lightBlue	лигхткорал	лигхтциан
лигхтголденроделлов	лигхтгрин	lightGray	лигхтпинк	лигхтсалмон	лигхтсеагрин
лигхтскиблуе	лигхтслатеграй	лигхтстилблуе	лигхтеллов	lime	лимегрин
Льняной	Пурпурный	Малиновый	медиумакуамарине	медиумблуе	медиуморчид
медиумпурпле	медиумсеагрин	медиумслатеблуе	медиумспринггрин	медиумтуркуоисе	медиумвиолетред
миднигхтблуе	минткреам	мистиросе	Болотный	наважовхите	Глубокий темно-синий
олдлаце	Оливковый	оливедраб	orange	оранжеред	Лиловый
палеголденрод	paleGreen	палетуркуоисе	палевиолетред	папайавхип	пеачпуфф
Рыжевато-коричневый	pink	Сливовый	повдерблуе	purple	красный
росибровн	ройалблуе	саддлебровн	Оранжево-розовый	сандибровн	сеагрин
Выброшенная	Охра	Светло-серый	скиблуе	слатеблуе	слатеграй
Снежно-белый	спринггрин	стилблуе	tan	Сине-зеленый	Чертополох
Томат	transparent	Бирюзовый	Фиолетовый	Пшеничный	white
вхитесмоке	yellow	елловгрин

Примеры

Следующий пример взят из манифеста пакета образца пакета 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`

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