VisualElements (схема пакета для Windows 8)
Описание визуальных аспектов приложения 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 | Задает цвет фона плитки приложения. Сведения о цветах см. в разделе "Примечания". Обратите внимание, что указанный здесь цвет фона также применяется к следующим элементам:
|
Шестнадцатеричное число с тремя байтами, предшествующим "#" или именованному цвету. | Да | |
| Описание | Описание приложения. Эта строка локализуема; Дополнительные сведения см. в разделе "Примечания". |
Строка длиной от 1 до 2048 символов, которая не может содержать такие символы, как табуляции, возврат каретки и веб-каналы строк. | Да | |
| Отображаемое имя | Понятное имя приложения, которое может отображаться для пользователей. Эта строка локализуема; Дополнительные сведения см. в разделе "Примечания". Существует два явно зарезервированных слова, которые не могут использоваться в качестве displayName для приложений, отправленных в Microsoft Store: NoUIEntryPoints и NoUIEntryPoints-DesignMode. Эти идентификаторы зарезервированы для использования средствами разработки и наборами тестов. |
Строка длиной от 1 до 256 символов. | Да | |
| ForegroundText | Задает цвет переднего плана плитки приложения.
|
Этот атрибут может иметь одно из следующих значений:
|
Да | |
| Логотип | Изображение, используемое в качестве квадратной плитки приложения. Дополнительные сведения об указании изображения в этом атрибуте см. в разделе "Примечания". |
Строка длиной от 1 до 256 символов, заканчивающаяся символами ".jpg", ".png" или ".jpeg", которые не могут содержать следующие символы: <, : , >:, %, ", |, ?или *. В этой строке символы / и \ не могут быть первыми или последними символами. Кроме того, строка может содержать /или \, но не оба. | Да | |
| SmallLogo | Небольшое изображение, показанное в углу плитки для идентификации приложения. Дополнительные сведения об указании изображения в этом атрибуте см. в разделе "Примечания".
|
Строка длиной от 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>
См. также раздел
Снимки экрана и изображения приложения
Краткое руководство. Создание плитки по умолчанию с помощью редактора манифеста Visual Studio
Требования
| Значение | |
|---|---|
| Пространство имен | http://schemas.microsoft.com/appx/2010/manifest |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по