Compartir a través de

LaunchAction (en ContactLaunchActions)

  • Artículo

Describe una acción de contenido ContactLaunchActions .

Jerarquía de elemento

<Extensión>
<Contacto>
<ContactLaunchActions>
<LaunchAction>

Sintaxis

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

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

</LaunchAction>

Clave

?intervalo de repeticiones específico opcional (cero o uno) {}

Atributos y elementos

Atributos

Atributo Descripción Tipo de datos Obligatorio Valor predeterminado
DesiredView

Cantidad deseada de espacio de pantalla que se usará cuando se inicie el contacto.

Windows Phone: DesiredView no se admite para Windows Phone.

Este atributo puede tener uno de los siguientes valores:

  • default
  • Inútil
  • useHalf
  • useMore
  • useMinimum
 No
Verb

Identificador único que se pasa a la aplicación cuando se inicia. La aplicación puede usar esta cadena para determinar qué controlador ContactLaunchActions desencadenó su inicio. Es único por aplicación en el paquete y distingue mayúsculas de minúsculas.

Este atributo puede tener uno de los siguientes valores:

  • llamada
  • mapa
  • message
  • post
  • Videollamada
 Sí

 

Elementos secundarios

Elemento secundario Descripción
ServiceId

Identifica el servicio para una acción de contacto.

 

Elementos primarios

Elemento primario Descripción
ContactLaunchActions

Declara las acciones que se deben realizar cuando se inicia un contacto.

 

Los elementos siguientes tienen el mismo nombre que este, pero contenido o atributos diferentes:

Comentarios

Para obtener más información sobre las acciones de inicio que realiza un proveedor de contactos, vea ContactLaunchActionVerbs.

El manifiesto aplica estas comprobaciones semánticas para el atributo Verb para una acción de contenido ContactLaunchActions .

  • Si Verb está establecido en map, no debe declarar ningún elemento ServiceId . Todos los demás valores de Verb deben declarar un ServiceId.
  • Solo si verb está establecido en call o message, puede especificar ServiceId como el valor conocido "telephone".

La definición LaunchAction (en ContactLaunchActions) tiene estas instrucciones:

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

La instrucción "ref" anterior indica que LaunchAction (en ContactLaunchActions) hereda todos estos atributos base de extensión:

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

Dado que LaunchAction (en ContactLaunchActions) permite los atributos base de la extensión, tiene estas validaciones semánticas que no están cubiertas por el esquema de manifiesto XSD:

  • Los atributos base de la extensión deben seguir estas reglas:

    • Si se especifica el atributo StartPage , se producirá un error si se especifica el atributo EntryPoint, Executable o RuntimeType .
    • De lo contrario, se producirá un error si se especifica el atributo Executable o RuntimeType sin un entryPoint especificado.

  • Si LaunchAction define el atributo EntryPoint , este Elemento LaunchAction o el elemento Primario Extension o Application deben especificar un atributo Executable .

Requisitos

Value
Espacio de nombres http://schemas.microsoft.com/appx/2013/manifest