uap:VisualElements (Windows 10)

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

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

<Пакет>

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

         <Развертывание>

              <uap:VisualElements>

Синтаксис

<uap:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    Square44x44Logo = 'A string between 1 and 256 characters in length that ends with ".jpg", ".png", or ".jpeg" that cannot contain these characters: <, >, :, ", |, ?, or *. In this string, the / and \ characters cannot be the first or last characters. Also, the string can contain / or \ but not both.'
    AppListEntry = 'An optional string that can have one of the following values: "default" or "none".' >

  <!-- Child elements -->
  uap:DefaultTile?
  & uap:LockScreen?
  & uap:SplashScreen?
  & uap:InitialRotationPreference?

</uap:VisualElements>

Клавиши

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

Элементы и атрибуты

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Отображаемое имя Понятное имя приложения, которое может отображаться для пользователей. Эта строка локализуема; Дополнительные сведения см. в примечаниях . Строка со значением от 1 до 256 символов. Эта строка может быть локализована. Да
Описание Описание приложения. Эта строка локализуема; Дополнительные сведения см. в примечаниях . Строка от 1 до 2048 символов. Да
BackgroundColor Задает цвет фона плитки приложения. См. раздел "Примечания" для цветовых имен. Да
Square150x150Logo Изображение, используемое в качестве средней плитки начального экрана приложения и на переключателе задач. Дополнительные сведения об указании изображения в этом атрибуте см. в примечаниях. Строка длиной от 1 до 256 символов, заканчивающаяся .jpg.pngсимволами , или .jpeg не может содержать следующие символы: <, , , >, ":|или ?*. В этой строке / символы и \ символы не могут быть первыми или последними символами. Кроме того, строка может содержать / или \ не оба. Да
Square44x44Logo Изображение, используемое в качестве небольшой плитки начального экрана приложения и в списке всех приложений. Дополнительные сведения об указании изображения в этом атрибуте см. в примечаниях. Строка длиной от 1 до 256 символов, заканчивающаяся .jpg.pngсимволами , или .jpeg не может содержать следующие символы: <, , , >, ":|или ?*. В этой строке / символы и \ символы не могут быть первыми или последними символами. Кроме того, строка может содержать / или \ не оба. Да
AppListEntry Запись в списке всех приложений. Необязательная строка, которая может иметь одно из следующих значений: default или none. Нет default

Примечание

Указанный здесь цвет фона также применяется к следующим элементам:

  • Цвет кнопки в диалоговых окнах, принадлежащих любому приложению
  • Страница описания приложения в Магазине

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

Дочерний элемент Описание
uap:DefaultTile Плитка по умолчанию, представляющая приложение на начальном экране. Эта плитка отображается при первой установке приложения до получения уведомлений об обновлении. Если плитка не отображает уведомления, плитка возвращается к этому значению по умолчанию.
uap:InitialRotationPreference Описывает ориентацию, в которой приложение предпочитает отображаться для оптимального взаимодействия с пользователем. На устройстве, которое можно повернуть, например планшет, приложение не будет перерисовано для ориентации, которые здесь не указаны. Например, если приложение указывает только Landscape и LandscapeFlipped ориентацию, а устройство поворачивается на Portrait ориентацию, приложение не будет поворачиваться.
uap:LockScreen Определяет эмблему и уведомления, представляющие приложение на экране блокировки, которое отображается при блокировке системы.
uap:SplashScreen Определяет внешний вид экрана-заставки, отображаемого приложением во время запуска.

Примечание

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

Эти параметры ориентации применяются как к экрану-заставке , так и к пользовательскому интерфейсу приложения при запуске нового сеанса для приложения. Параметры можно изменить во время выполнения с помощью свойства AutoRotationPreferences .

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

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

Комментарии

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

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

Приложения, приложения, расширения/ расширение/FileTypeAssociation/Логотип приложений/Application/Extensions/Extensions/Protocol/Logo

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

Атрибут Image Масштабирование (размер изображения в пикселях)
Applications/Application/VisualElements/@Square150x150Logo 100 (150x150)
250 (375x375)
Applications/Application/VisualElements/@Square44x44Logo 100 (44x44)
250 (110x110)
Applications/Application/VisualElements/@Tall150x310Logo 100 (150x310)
250 (375x775)

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

AliceBlue
антикварныйwhite
Бирюзовый
Аквамариновый
azure
Бежевый
Светло-коричневый
black
бланшированныеAlmond
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
зеленый Yellow
Медовый
hotPink
indianRed
Индиго
Слоновая кость
Хаки
Бледный розовато-лиловый
ЛавандерБлуш
лужайка
lemonChiffon
lightBlue
lightCoral
lightCyan
lightGoldenrodYellow
lightGray
lightGreen
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">
        <uap:VisualElements 
            DisplayName="ApplicationDataSample"
            Description="Application data sample"
            BackgroundColor="#FFFFFF"               
            Square150x150Logo="images\squareTile-sdk.png" 
            Square44x44Logo="images\smallTile-sdk.png" 
            AppListEntry="default">
            <uap:DefaultTile
                ShowName="allLogos" />
            <uap:LockScreen
                Notification="badge"
                BadgeLogo="images\badgeLogo.png" />
            <uap:SplashScreen
                BackgroundColor="white"
                Image="images\splash-sdk.png" />
            <uap:InitialRotationPreference> 
                <uap:Rotation
                    Preference="portrait" />
            </uap:InitialRotationPreference>            
        </uap:VisualElements>
    </Application>
</Applications>                             

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

Требования

Элемент Значение
Пространство имен http://schemas.microsoft.com/appx/manifest/uap/windows10