uap:Protocol (Windows 10)

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>

Syntaxe

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

</uap:Protocol>

Clé

? facultatif (zéro ou un) & connecteur interleave (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 avec une valeur comprise entre 2 et 39 caractères de longueur qui contient des nombres, des lettres minuscules, des points (.), des signes+ () ou des tirets (-). La chaîne ne peut pas commencer par un point (.). Oui
DesiredView Quantité souhaitée d’espace d’écran à utiliser lors du lancement du rendez-vous. Chaîne qui peut avoir l’une des valeurs suivantes : default, useLess, useHalf, useMore ou useMinimum. Non
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 de l’URI retourne toujours un résultat), « facultatif » (l’activation d’URI renvoie un résultat s’il est activé pour les résultats à l’aide de LaunchUriForResultsAndContinueAsync). Non

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

Éléments parents

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

Exemples

L’exemple suivant est extrait du manifeste de package de l’un des exemples du Kit de développement logiciel (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

Spécifications

Élément Valeur
Espace de noms http://schemas.microsoft.com/appx/manifest/uap/windows10