LaunchAction (dans ContactLaunchActions)

  • Article

Décrit une action de contenu ContactLaunchActions .

Hiérarchie d’éléments

<Poste>
<Contact>
<ContactLaunchActions>
<LaunchAction>

Syntaxe

<LaunchAction Verb         = "call" | "map" | "message" | "post" | "videoCall"
              DesiredView? = "default" | "useLess" | "useHalf" | "useMore" | "useMinimum" >

  <!-- Child elements -->
  ServiceId{0,100}

</LaunchAction>

Clé

? plage d’occurrences spécifique (zéro ou une) {} facultative

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
DesiredView

Quantité d’espace d’écran souhaitée à utiliser lors du lancement du contact.

Windows Phone : DesiredView n’est pas pris en charge pour les Windows Phone.

Cet attribut peut avoir l’une des valeurs suivantes :

  • default
  • Mail
  • useHalf
  • useMore
  • useMinimum
 No
Verb

Identificateur unique qui est passé à l’application lorsqu’elle est lancée. L’application peut utiliser cette chaîne pour déterminer le gestionnaire ContactLaunchActions qui a déclenché son lancement. Elle est unique pour chaque application du package et respecte la casse.

Cet attribut peut avoir l’une des valeurs suivantes :

  • appel
  • carte
  • message
  • post
  • videoCall
 Oui

 

Éléments enfants

Élément enfant Description
ServiceId

Identifie le service pour une action de contact.

 

Éléments parents

Élément parent Description
ContactLaunchActions

Déclare des actions à entreprendre lorsqu’un contact est lancé.

 

Les éléments suivants portent le même nom que celui-ci, mais ils ont un contenu ou des attributs différents :

Notes

Pour plus d’informations sur les actions de lancement qu’un fournisseur de contacts prend, consultez ContactLaunchActionVerbs.

Le manifeste applique ces vérifications sémantiques pour l’attribut verb pour une action de contenu ContactLaunchActions .

  • Si le verbe a la valeur Map, il ne doit pas déclarer d’éléments ServiceId . Toutes les autres valeurs du verbe doivent déclarer un ServiceId.
  • Si le verbe est défini sur Call ou message, peut-il spécifier ServiceId comme valeur connue « téléphone ».

La définition de LaunchAction (dans ContactLaunchActions) contient les instructions suivantes :

            <xs:element name="LaunchAction" maxOccurs="50">
              <xs:complexType>
                <xs:sequence>
                  <xs:element name="ServiceId" type="CT_ServiceId" minOccurs="0" maxOccurs="100"/>
                </xs:sequence>
                <xs:attribute name="Verb" type="ST_ContactLaunchActionVerbs" use="required"/>
                <xs:attribute name="DesiredView" type="ST_DesiredView" use="optional"/>
                <xs:attributeGroup ref="m:ExtensionBaseAttributes"/>
              </xs:complexType>
              <xs:unique name="Service_Id">
                <xs:selector xpath="m2:ServiceId"/>
                <xs:field xpath="."/>
              </xs:unique>
            </xs:element>

L’instruction « Ref » précédente indique que LaunchAction (dans ContactLaunchActions) hérite de tous ces attributs de base d' extension :

  <xs:attributeGroup name="ExtensionBaseAttributes">
    <xs:attribute name="Executable" type="ST_Executable" use="optional"/>
    <xs:attribute name="EntryPoint" type="ST_EntryPoint" use="optional"/>
    <xs:attribute name="RuntimeType" type="ST_ActivatableClassId" use="optional"/>
    <xs:attribute name="StartPage" type="ST_FileName" use="optional"/>
  </xs:attributeGroup>

Étant donné que LaunchAction (dans ContactLaunchActions) autorise les attributs de base d' extension , il a ces validations sémantiques qui ne sont pas couvertes par le schéma de manifeste xsd :

  • Les attributs de base d' extension doivent respecter les règles suivantes :

    • Si l’attribut StartPage est spécifié, échoue si l’attribut entryPoint, executableou RuntimeType est spécifié.
    • Sinon, échoue si l’attribut executable ou RuntimeType est spécifié sans entryPoint spécifié.

  • Si LaunchAction définit l’attribut entryPoint , ce LaunchAction ou l' extension parente ou l’élément d' application doit spécifier un attribut exécutable .

Spécifications

Valeur
Espace de noms http://schemas.microsoft.com/appx/2013/manifest