uap :Protocol (Windows 10)

  • Article

Déclare un point d’extensibilité d’application de type windows.protocol. Une association d’URI indique que l’application est inscrite pour gérer les URI avec le schéma spécifié.

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

              <Extensions>

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

Clé :

? connecteur facultatif (zéro ou un) & entrelacement (peut se produire dans n’importe quel ordre)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
Nom Nom du schéma d’URI (par exemple mailto). Ce nom doit être unique pour le package. Chaîne dont la longueur est comprise entre 2 et 39 caractères et qui contient des chiffres, des lettres minuscules, des points (.), des signes plus (+) ou des tirets (-). La chaîne ne peut pas commencer par un point (.). Yes
DesiredView Quantité d’espace d’écran souhaitée à utiliser lors du lancement du rendez-vous. Chaîne qui peut avoir l’une des valeurs suivantes : default, useLess, useHalf, useMore ou useMinimum. No
ReturnResults Spécifie si l’application retourne une valeur lorsqu’elle est appelée via une activation d’URI. Chaîne facultative qui peut avoir l’une des valeurs suivantes : « none » (ne retourne pas de valeur), « always » (l’activation d’URI renvoie toujours un résultat), « facultatif » (l’activation d’URI retourne un résultat si elle est activée pour les résultats à l’aide de LaunchUriForResultsAndContinueAsync). No

Éléments enfants

Élément enfant Description
uap:DisplayName Nom convivial qui peut être affiché aux utilisateurs.
uap:Logo Chemin d’accès à un fichier qui contient une image.
desktop7 :ProgId Identificateur programmatique (ProgID) qui peut être associé à un CLSID.

Éléments parents

Élément parent Description
uap:Extension Déclare un point d’extensibilité pour l’application.

Exemples

L’exemple suivant est tiré du manifeste de package de l’un des exemples de SDK.

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

Voir aussi

TâchesComment gérer l’activation d’URI

Concepts Contratset extensions d’application

Configuration requise

Élément Valeur
Espace de noms http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version Windows 10 version 1511 (build 10586)