uap:Protocol (Windows 10)

Declara um ponto de extensibilidade de 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

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <uap:Extension>
               └─ <uap:Protocol>

Sintaxe

<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

Attribute Descrição Tipo de dados Obrigatório Valor padrão
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, períodos (.), mais sinais (+) ou traços (-). A cadeia de caracteres não pode começar com um período (.). Sim
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: padrão, 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 de URI sempre retornará um resultado), "opcional" (a ativação de 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 é extraído 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>

Consulte 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
versão mínima do sistema operacional Windows 10 versão 1511 (Build 10586)
  • Last updated on