uap:Protocol (Windows 10)

Artigo
10/30/2023

Declara um ponto de extensibilidade do aplicativo do tipo windows.protocol. Uma associação de URI indica que o aplicativo está registrado para manipular URIs com o esquema especificado.

Hierarquia de elementos

<Extensões>

<uap:Extension>

<uap:Protocol>

Syntax

<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>

Chave

? conector de intercalação opcional (zero ou um) & (pode ocorrer em qualquer ordem)

Atributos e elementos

Atributos

Atributo	Descrição	Tipo de dados	Obrigatório
Nome	O nome do esquema de URI (como `mailto`). Esse nome deve ser exclusivo para o pacote.	Uma cadeia de caracteres com um valor entre 2 e 39 caracteres de comprimento que contém números, letras minúsculas, pontos (`.`), sinais de adição (`+`) ou traços (`-`). A cadeia de caracteres não pode começar com um ponto (`.`).	Yes
DesiredView	A quantidade desejada de espaço na tela a ser usada quando o compromisso é iniciado.	Uma cadeia de caracteres que pode ter um dos seguintes valores: default, useLess, useHalf, useMore ou useMinimum.	No
ReturnResults	Especifica se o aplicativo retorna um valor quando invocado por meio de uma ativação de URI.	Uma cadeia de caracteres opcional que pode ter um dos seguintes valores: "none" (não retorna um valor), "always" (a ativação do URI sempre retornará um resultado), "opcional" (a ativação do URI retornará um resultado se for ativada para resultados usando LaunchUriForResultsAndContinueAsync).	No

Elementos filho

Elemento filho	Descrição
uap:DisplayName	Um nome amigável que pode ser exibido aos usuários.
uap:Logo	Um caminho para um arquivo que contém uma imagem.
desktop7:ProgId	Um ProgID (identificador programático) que pode ser associado a um CLSID.

Elementos pai

Elemento pai	Descrição
uap:Extension	Declara um ponto de extensibilidade para o aplicativo.

Exemplos

O exemplo a seguir é obtido do manifesto do pacote de um dos exemplos do SDK.

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

Confira também

TarefasComo lidar com a ativação do URI

Conceitos Contratose extensões de aplicativo

Requisitos

Item	Valor
Namespace	`http://schemas.microsoft.com/appx/manifest/uap/windows10`
Minimum OS Version	Windows 10 versão 1511 (Build 10586)

Compartilhar via