uap:Protocol (Windows 10)

Статья
10/30/2023

Объявляет точку расширяемости приложения типа windows.protocol. Сопоставление URI указывает, что приложение зарегистрировано для обработки URI с указанной схемой.

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

<uap:Protocol>

Синтаксис

<uap:Protocol
  Name = 'A string with a value between 2 and 39 characters in length that contains numbers, lowercase letters, periods ("."), plus signs ("+"), or dashes ("-"). The string cannot start with a period (".").'
  DesiredView = 'A string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  ReturnResults = 'An optional string that can have one of the following values: "none", "always", "optional".' >

  <!-- Child elements -->
  uap:Logo?
  & uap:DisplayName?
  & desktop7:ProgId
</uap:Protocol>

Ключ

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

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

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
имя;	Имя схемы URI (например `mailto`, ). Это имя должно быть уникальным для пакета.	Строка длиной от 2 до 39 символов, содержащая цифры, строчные буквы, точки (`.`), знаки плюс (`+`) или дефисы (`-`). Строка не может начинаться с точки (`.`).	Да
DesiredView	Требуемый объем экранного пространства, используемого при запуске встречи.	Строка, которая может иметь одно из следующих значений: default, useLess, useHalf, useMore или useMinimum.	Нет
ReturnResults	Указывает, возвращает ли приложение значение при вызове с помощью активации URI.	Необязательная строка, которая может иметь одно из следующих значений: "none" (не возвращает значение), "always" (активация URI всегда возвращает результат), "необязательная" (активация URI возвращает результат, если она активирована для результатов с помощью LaunchUriForResultsAndContinueAsync).	Нет

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

Дочерний элемент	Описание
uap:DisplayName	Понятное имя, которое может отображаться для пользователей.
uap:Logo	Путь к файлу, который содержит изображение.
desktop7:ProgId	Программный идентификатор (ProgID), который можно связать с CLSID.

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

Родительский элемент	Описание
uap:Extension	Объявляет точку расширяемости для приложения.

Примеры

Следующий пример взят из манифеста пакета одного из примеров пакета SDK.

<Applications>
  <Application
    Id="App"
    StartPage="default.html">
    <Extensions>
      <uap:Extension
        Category="windows.protocol">
        <uap:Protocol
          Name="alsdk" />
      </uap:Extension>
    </Extensions>
  </Application>
</Applications>

См. также раздел

Задачипо обработке активации URI

Основные понятияКонтракты и расширения приложений

Требования

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

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