LaunchAction (in ContactLaunchActions)

  • Artikel

Beschreibt eine ContactLaunchActions-Inhaltsaktion .

Elementhierarchie

<Durchwahl>
<Contact>
<ContactLaunchActions>
<LaunchAction>

Syntax

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

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

</LaunchAction>

Schlüssel

? Optionaler (null oder ein) {} bestimmter Bereich von Vorkommen

Attribute und Elemente

Attributes

Attribut BESCHREIBUNG Datentyp Erforderlich Standardwert
DesiredView

Der gewünschte Bildschirmbereich, der beim Start des Kontakts verwendet werden soll.

Windows Phone: DesiredView wird für die Windows Phone.

Dieses Attribut kann einen der folgenden Werte haben:

  • default
  • Nutzlos
  • useHalf
  • useMore
  • useMinimum
 Nein
Verb

Ein eindeutiger Bezeichner, der beim Start an die App übergeben wird. Die App kann diese Zeichenfolge verwenden, um zu bestimmen, welcher ContactLaunchActions-Handler den Start ausgelöst hat. Sie ist pro Anwendung im Paket eindeutig und berücksichtigt die Kleinschreibung.

Dieses Attribut kann einen der folgenden Werte haben:

  • Aufruf
  • Karte
  • message
  • post
  • videoCall
 Ja

 

Untergeordnete Elemente

Untergeordnetes Element BESCHREIBUNG
ServiceId

Identifiziert den Dienst für eine Kontaktaktion.

 

Übergeordnete Elemente

Übergeordnetes Element BESCHREIBUNG
ContactLaunchActions

Deklariert Aktionen, die beim Start eines Kontakts durchgeführt werden sollen.

 

Die folgenden Elemente haben denselben Namen wie dieses Element, aber ihr Inhalt oder ihre Attribute sind anders.

Hinweise

Weitere Informationen zu Startaktionen eines Kontaktanbieters finden Sie unter ContactLaunchActionVerbs.

Das Manifest erzwingt diese semantischen Überprüfungen für das Verb-Attribut für eine ContactLaunchActions-Inhaltsaktion .

  • Wenn Verb auf map festgelegt ist, darf es keine ServiceId-Elemente deklarieren . Alle anderen Werte für Verb müssen eine ServiceId deklarieren.
  • Nur wenn verb auf call oder message festgelegt ist, kann es ServiceId als bekannten Wert "telephone" angeben.

Die LaunchAction-Definition (in ContactLaunchActions) enthält die folgenden Anweisungen:

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

Die vorangehende ref-Anweisung gibt an, dass LaunchAction (in ContactLaunchActions) alle diese Basisattribute der Erweiterung erbt:

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

Da LaunchAction (in ContactLaunchActions) die Basisattribute der Erweiterung zulässt, verfügt sie über diese semantischen Validierungen, die nicht vom XSD-Manifestschema abgedeckt werden:

  • Erweiterungsbasisattribute müssen diesen Regeln entsprechen:

    • Wenn das StartPage-Attribut angegeben wird, ist ein Fehler zu sehen, wenn das EntryPoint-, Executable- oder RuntimeType-Attribut angegeben ist.
    • Andernfalls führen Sie einen Fehler aus, wenn das Executable- oder RuntimeType-Attribut ohne Angabe eines EntryPoint angegeben wird.

  • Wenn LaunchAction das EntryPoint-Attribut definiert, muss entweder diese LaunchAction oder das übergeordnete Extension - oder Application-Element ein Executable-Attribut angeben.

Anforderungen

Wert
Namespace http://schemas.microsoft.com/appx/2013/manifest