Висуалелементс (схема расширений для Windows 8.1)
Описание визуальных аспектов приложения 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 | Задает цвет фона плитки приложения. Имена цветов см. в разделе "Примечания". Обратите внимание, что цвет фона, указанный здесь, также применяется к следующим элементам:
применяется к 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>
См. также раздел
Снимки экрана и изображения приложения
краткое руководство. создание плитки по умолчанию с помощью редактора манифестов Visual Studio
Требования
| Значение | |
|---|---|
| Пространство имен | http://schemas.microsoft.com/appx/2010/manifest |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по