Compartilhar via

Launchaction (em ContactLaunchActions)

  • Artigo

Descreve uma ação de conteúdo do ContactLaunchActions .

Hierarquia de elementos

<Extensão>
<Contact>
<ContactLaunchActions>
<LaunchAction>

Syntax

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

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

</LaunchAction>

Chave

? intervalo de ocorrências (zero ou um) {} específico

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Valor padrão
DesiredView

A quantidade desejada de espaço na tela a ser usada quando o contato é iniciado.

Windows Phone: DesiredView não tem suporte para Windows Phone.

Esse atributo pode ter um dos seguintes valores:

  • padrão
  • Úteis
  • useHalf
  • useMore
  • useMinimum
 Não
Verbo

Um identificador exclusivo que é passado para o aplicativo quando é iniciado. O aplicativo pode usar essa cadeia de caracteres para determinar qual manipulador ContactLaunchActions disparou sua inicialização. Ele é exclusivo por aplicativo no pacote e diferencia maiúsculas de minúsculas.

Esse atributo pode ter um dos seguintes valores:

  • chamada
  • mapa
  • message
  • post
  • videoCall
 Yes

 

Elementos filho

Elemento filho Descrição
ServiceId

Identifica o serviço para uma ação de contato.

 

Elementos pai

Elemento pai Descrição
ContactLaunchActions

Declara as ações a serem tomadas quando um contato é iniciado.

 

Os elementos a seguir têm o mesmo nome que este, mas um conteúdo ou atributos diferentes:

Comentários

Para obter mais informações sobre as ações de inicialização que um provedor de contatos pega, consulte ContactLaunchActionVerbs.

O manifesto impõe essas verificações semânticas para o atributo Verb de uma ação de conteúdo ContactLaunchActions .

  • Se Verb for definido como MAP, ele não deverá declarar nenhum elemento ServiceId . Todos os outros valores de verbo devem declarar um ServiceId.
  • Somente se o verbo estiver definido como chamada ou mensagem, ele poderá especificar ServiceId como o valor "telefone" bem conhecido.

A definição de launchaction (in ContactLaunchActions) tem estas instruções:

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

A instrução ' ref ' anterior indica que launchaction (em ContactLaunchActions) herda todos esses atributos de base de extensão :

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

Como launchaction (no ContactLaunchActions) permite os atributos de base de extensão , ele tem essas validações semânticas que não são cobertas pelo esquema de manifesto xsd:

  • Os atributos de base de extensão devem seguir estas regras:

    • Se o atributo Startpage for especificado, falhará se o atributo EntryPoint, executávelou RuntimeType for especificado.
    • Caso contrário, falhará se o atributo executável ou RuntimeType for especificado sem um EntryPoint especificado.

  • Se launchaction definir o atributo EntryPoint , essa inicialização ou a extensão pai ou o elemento de aplicativo deverão especificar um atributo executável .

Requisitos

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