mobile:Extension (Windows 10)

Статья
10/30/2023

Объявляет точку расширяемости для приложения.

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

Синтаксис

<mobile:Extension
    Category = 'A string that can have one of the following values: "windows.aowApp", "windows.mobileMultiScreenProperties", "windows.communicationBlockingProvider", or "windows.phoneCallOriginProvider".'
    Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
    EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
    RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
    ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
    StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.' >

  <!-- Child elements -->
  mobile:AowApp
  mobile:MobileMultiScreenProperties?

</mobile:Extension>

Ключ

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

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

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
Категория	Тип точки расширяемости приложения.	Строка, которая может иметь одно из следующих значений: windows.aowApp, windows.mobileMultiScreenProperties, windows.communicationBlockingProvider или windows.phoneCallOriginProvider.	Да
Исполняемый объект	Исполняемый файл запуска по умолчанию.	Необязательная строка со значением от 1 до 256 символов, которая должна заканчиваться `.exe` и не может содержать следующие символы: `<`, `>`, `:`, `"\|`, , `?`или `*`. Он задает исполняемый файл по умолчанию для расширения. Если он не указан, используется исполняемый файл, определенный для приложения. Если этот параметр указан, также используется свойство EntryPoint. Если это свойство EntryPoint не указано, используется элемент EntryPoint, определенный для приложения.	Нет
EntryPoint	Идентификатор активируемых классов.	Необязательная строка со значением от 1 до 256 символов в длину, представляющая задачу, обрабатывающую расширение. Как правило, соответствует полному имени пространства имен типа среды выполнения Windows. Если EntryPoint не указан, вместо него используется точка EntryPoint, определенная для приложения.	Нет
Тип среды выполнения	Поставщик среды выполнения. Этот атрибут обычно используется при наличии в приложении смешанных платформ.	Необязательная строка со значением от 1 до 255 символов, которая не может начинаться или заканчиваться точкой или содержать следующие символы: `<`, `>`, `:`, `"/`, `\`, `\|`, `?`или `*`.	Нет
ResourceGroup	Тег, который можно использовать для группировки активаций расширений в целях управления ресурсами (например, ЦП и память). Значение ResourceGroup можно задать в свободной форме и является гибким. См . Application@ResourceGroup.	Необязательная буквенно-цифровая строка со значением от 1 до 255 символов. Должен начинаться с буквы.	Нет
StartPage	Веб-страница, обрабатывающая точку расширения.	Необязательная строка со значением от 1 до 256 символов в длину, которая не может содержать следующие символы: `<`, `>`, `:`, `"`, `\|?`или `*`.	Нет

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

Дочерний элемент	Описание
mobile:AowApp	Объявляет точку расширяемости приложения типа windows.aowApp.
mobile:MobileMultiScreenProperties	Объявляет точку расширяемости приложения типа windows. Свойства MobileMultiScreen.

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

Родительский элемент	Описание
Расширения (тип: CT_ApplicationExtensions)	Определяет одну или несколько точек расширяемости для приложения.

Примеры

В следующем примере показано, как заблокировать отображение мобильного приложения на подключенном дисплее. Эта разметка приведет к отключению плитки приложения в меню "Пуск" подключенного дисплея.

<Package
    xmlns:mobile="http://schemas.microsoft.com/appx/manifest/mobile/windows10"
    IgnorableNamespaces="... mobile">
    <Applications>
        <Application>
            <Extensions>
                <mobile:Extension
                    Category="windows.mobileMultiScreenProperties">
                    <mobile:MobileMultiScreenProperties
                        RestrictToInternalScreen="true"/>
                </mobile:Extension>
            </Extensions>
        </Application>
    </Applications>
</Package>

Требования

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