uap3:VisualElements (Windows 10)

Статья
05/03/2024

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

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

<Пакет>

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

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

<uap3:VisualElements>

Синтаксис

<uap3:VisualElements
    DisplayName = 'A string with a value between 1 and 256 characters in length. This string is localizable.' 
    Description = 'A string between 1 and 2048 characters in length.'
    BackgroundColor = 'A three-byte hexadecimal number preceded by "#" or a named color. See Remarks for a list of named colors.'
    Square150x150Logo = 'A string with a value 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 with a value 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".' 
    VisualGroup = 'A string with a value between 1 and 256 characters in length that does not contain backslashes ("\").' />

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

</uap3:VisualElements>

Ключ

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

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

Атрибуты

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

Примечание

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

Цвет кнопки в диалоговых окнах, принадлежащих приложению.
Страница "Описание приложения" в Магазине.

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

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

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

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

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

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

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

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

aliceBlue
antiqueWhite
Бирюзовый
Аквамариновый
azure
Бежевый
Светло-коричневый
black
blanchedAlmond
blue
blueViolet
Коричневый
burlyWood
cadetBlue
Фисташковый
Шоколад
Коралловый
cornflowerBlue
Кремово-лимонный
Алый
Зеленовато-голубой
darkBlue
darkCyan
darkGoldenrod

darkGray
темно-зеленый
darkKhaki
darkMagenta
darkOliveGreen
darkOrange
darkOrchid
darkRed
darkSalmon
darkSeaGreen
darkSlateBlue
darkSlateGray
darkTurquoise
darkViolet
deepPink
deepSkyBlue
dimGray
dodgerBlue
Красный кирпич
floralWhite
forestGreen
Фуксия
Серо-фиолетовый, светлый
ghostWhite

Золотистый
Светлый желто-коричневый
Серый
green
greenYellow
Медовый
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
Лиловый
paleGoldenrod
бледно-зеленый
бледно-бледный
paleVioletRed
papayaWhip
peachPuff
Рыжевато-коричневый
pink
Сливовый
powderBlue
purple
красный
rosyBrown
royalBlue
saddleBrown
Оранжево-розовый

sandyBrown
seaGreen
Раковины
Охра
Светло-серый
skyBlue
slateBlue
slateGray
Снежно-белый
springGreen
steelBlue
tan
Сине-зеленый
Чертополох
Томат
transparent
Бирюзовый
Фиолетовый
Пшеничный
white
Whitesmoke
yellow
yellowGreen

Примеры

В следующем примере создается папка с именем App1 в списке всех приложений и в ней хранится плитка App1.

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"  
    IgnorableNamespaces="... desktop">
    <Applications>
        <Application>
            <uap3:VisualElements
                DisplayName="App1" 
                Square150x150Logo="images/150x150.png" 
                Square44x44Logo="images/44x44.png" 
                Description="App1" 
                BackgroundColor="#777777" 
                AppListEntry="default" 
                VisualGroup="App1">  
                <uap:SplashScreen
                    BackgroundColor="#777777" 
                    Image="images/splash.png"/>  
           </uap3:VisualElements>  
        </Application>
    </Applications>
</Package>

Требования

Элемент	Значение
Пространство имен	`http://schemas.microsoft.com/appx/manifest/uap/windows10/3`
Minimum OS Version	Windows 10 версии 1607 (сборка 14393)

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

uap3:VisualElements (Windows 10)

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

Синтаксис

Ключ

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

Атрибуты

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

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

Комментарии

Примеры

Требования

Обратная связь

Дополнительные ресурсы

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

uap3:VisualElements (Windows 10)

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

Синтаксис

Ключ

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

Атрибуты

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

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

Комментарии

Примеры

Связанные темы

Требования

Обратная связь

Дополнительные ресурсы