desktop2:Extension (в пакете или приложениях)
Объявляет точку расширяемости для приложения.
Иерархия элементов
> пакета<
<desktop2:Extension>
Синтаксис
<desktop2:Extension
Category = 'A string that can have one of the following values: "windows.appPrinter", "windows.searchFilterHandler", "windows.searchPropertyHandler", or "windows.mailProvider".'
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 *.'
StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
uap10:TrustLevel = 'An optional string that can be one of the following values: "appContainer" or "mediumIL".'
uap10:RuntimeBehavior = 'An optional string that can be one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
uap10:HostId = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
uap11:SupportsMultipleInstances = 'An optional boolean value.'
uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".'>
<!-- Child elements -->
desktop2:AppPrinter?
desktop2:SearchFilterHandler?
desktop2:SearchPropertyHandler?
desktop2:DesktopEventLogging?
desktop2:FirewallRules?
</desktop2:Extension>
Ключ
? необязательный (ноль или один)
Атрибуты и элементы
Атрибуты
| Атрибут | Описание | Тип данных | Обязательно | Значение по умолчанию |
|---|---|---|---|---|
| категории | Категория расширения. | Строка, которая может иметь одно из следующих значений: windows.appPrinter, windows.searchFilterHandler, windows.searchPropertyHandlerили windows.mailProvider. | Да | |
| исполняемых | Исполняемый файл по умолчанию. | Необязательная строка со значением от 1 до 256 символов длиной, которая должна заканчиваться .exe и не может содержать следующие символы: <, >, :, ", |, ?или *. Он задает исполняемый файл по умолчанию для расширения. Если это не указано, используется исполняемый файл, определенный для приложения. При указании также используется свойство EntryPoint. Если это свойство EntryPoint не указано, используется запись, определенная для приложения. |
Нет | |
| EntryPoint | Идентификатор активируемого класса. | Необязательная строка со значением от 1 до 256 символов длиной, представляющая задачу, обрабатывающую расширение. Обычно это полное имя пространства имен типа среды выполнения Windows. Если Запись не указана, вместо этого используется точка входа, определенная для приложения. | Нет | |
| RuntimeType | Поставщик среды выполнения. Этот атрибут обычно используется при наличии смешанных платформ в приложении. | Необязательная строка со значением от 1 до 255 символов длиной, которая не может начинаться или заканчиваться периодом или содержать следующие символы: <, >, :, ", /, \, |, ?или *. |
Нет | |
| StartPage | Веб-страница, обрабатывающая точку расширяемости. | Необязательная строка со значением от 1 до 256 символов длиной, которая не может содержать следующие символы: <, >, :, ", |, ?или *. |
Нет | |
| uap10:TrustLevel | Указывает уровень доверия расширения. | Необязательная строка, которая может быть одним из следующих значений: appContainer или mediumIL. | Нет | |
| uap10:RuntimeBehavior | Указывает поведение времени выполнения расширения. | Необязательная строка, которая может быть одним из следующих значений: windowsApp, packagedClassicAppили win32App. | Нет | |
| uap10:HostId | Указывает идентификатор среды выполнения узла для расширения. | Необязательная буквенно-цифровые строки со значением от 1 до 255 символов длиной. Должно начинаться с буквы. | Нет | |
| uap10:Parameters | Содержит параметры командной строки для передачи в расширение. Поддерживается только для классических приложений, имеющих удостоверение пакета. | Необязательная строка со значением от 1 до 32767 символов длиной с символом без пробелов в начале и конце. | Нет | |
| uap11:Id | Идентификатор расширения. Идентификатор должен быть уникальным для всех расширений в пакете. | Необязательная строка со значением от 1 до 255 символов длиной с символом без пробелов в начале и конце. | Нет | |
| uap11:Подсистема | Подсистема, предназначенная расширением. | Необязательная строка, которая может иметь одно из следующих значений: консоли или окнах. | Нет | |
| uap11:SupportsMultipleInstances | Указывает, должны ли экземпляры выполняться в разных процессах. Значение по умолчанию — false. | Необязательное логическое значение. | Нет | |
| uap11:ResourceGroup | Тег, который можно использовать для группирования активаций расширений вместе для целей управления ресурсами (например, ЦП и памяти). Значение, которое можно задать ResourceGroup, является свободным и гибким. См. Application@ResourceGroup. | Необязательная буквенно-цифровые строки со значением от 1 до 255 символов длиной. Должно начинаться с буквы. | Нет | |
| uap11:CurrentDirectoryPath | Указывает начальный каталог при запуске процесса приложения. Этот атрибут поддерживает макросы. Дополнительные сведения см. в разделе Макросы в схеме манифеста пакета. | Необязательная строка, которая не может содержать эти символы: <, >, |, ?или *. > |
Нет | |
| uap11:Parameters | Подсистема, предназначенная расширением. Этот атрибут поддерживает макросы. Дополнительные сведения см. в разделе Макросы в схеме манифеста пакета. | Необязательная строка со значением от 1 до 32767 символов длиной с символом без пробелов в начале и конце. | Нет | |
| desktop7:CompatMode | Указывает, регистрируются ли сведения этого расширения в Windows классическими способами (например, распакованные типы приложений регистрируются с помощью COM через реестр) или новыми более расширенными способами. Значение по умолчанию — "современный". Для compatMode="classic" требуется возможность Microsoft.classicAppCompat_8wekyb3d8bbwe. | Необязательная строка может иметь одно из следующих значений: классических или современных. | Нет | |
| desktop7:Scope | Указывает, отображаются ли регистрации только для других приложений, работающих как пользователь, у которого зарегистрирован этот пакет (пользователь), или отображается ли они всем пользователям и службам на компьютере (компьютере). Значение по умолчанию — user. Scope="machine" требует возможности Microsoft.classicAppCompatElevated_8wekyb3d8bbwe. | Необязательная строка, которая может иметь одно из следующих значений: компьютера или пользователя. | Нет |
Дочерние элементы
| Дочерний элемент | Описание |
|---|---|
| AppPrinter | Позволяет устанавливать принтеры файлов программного обеспечения в приложениях моста для классических приложений Windows. |
| SearchFilterHandler | Позволяет приложениям моста для классических приложений Windows регистрировать IFilters для извлечения свойств файлов для поиска. |
| SearchPropertyHandler | Позволяет приложениям моста windows для классических приложений устанавливать обработчики свойств в системе. |
| DesktopEventLogging | Позволяет приложениям моста для настольных компьютеров Windows регистрироваться для ведения журнала событий Windows. |
| FirewallRules | Задает правила исключения брандмауэра, используемые приложениями моста для классических приложений Windows. |
Родительские элементы
| Родительский элемент | Описание |
|---|---|
| расширений | Определяет одну или несколько точек расширяемости для приложения. |
Замечания
windows.mailProvider — это пустое объявление расширения, которое является точкой входа для почтовых приложений, чтобы правильно .dll обрабатывать запросы API почты. Это необходимо использовать в приложении с полным доверием.
Требования
| Пункт | Ценность |
|---|---|
| Пространство имен | http://schemas.microsoft.com/appx/manifest/desktop/windows10/2 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| минимальная версия ОС | Windows 10 версии 1703 (сборка 15063) |