uap:Protocol (Windows 10)

  • Artigo

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

<Pacote>

    <Aplicativos>

         <Aplicativo>

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