通过

ContactLaunchActions) 中的 LaunchAction (

  • 项目

介绍 ContactLaunchActions 内容操作。

元素层次结构

<分机>
<联系人>
<ContactLaunchActions>
<LaunchAction>

语法

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

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

</LaunchAction>

键

? 可选 (零个或一个) {} 特定的发生范围

特性和元素

特性

属性 说明 数据类型 必须 默认值
DesiredView

联系人启动时要使用的所需屏幕空间量。

Windows Phone： Windows Phone 不支持 DesiredView。

此属性可以具有以下值之一：

  • default
  • 无用
  • useHalf
  • useMore
  • useMinimum
 否
谓词

启动时传递给应用程序的唯一标识符。 应用可以使用此字符串来确定哪个 ContactLaunchActions 处理程序触发了其启动。 它对于包中的每个应用程序都是唯一的，并区分大小写。

此属性可以具有以下值之一：

  • call
  • map
  • message
  • post
  • videoCall
 是

 

子元素

子元素 说明
ServiceId

标识联系人操作的服务。

 

父元素

父元素 说明
ContactLaunchActions

声明在启动联系人时要执行的操作。

 

以下元素具有与此相同的名称，但内容或属性不同：

备注

有关联系人提供商所采用的启动操作的详细信息，请参阅 ContactLaunchActionVerbs。

清单对ContactLaunchActions内容操作的Verb特性强制执行这些语义检查。

  • 如果 谓词 设置为 map，则它不能声明任何 ServiceId 元素。 谓词的所有其他值必须声明ServiceId。
  • 只有 谓词 设置为 call 或 message，才能将 ServiceId 指定为众所周知的值 "电话"。

ContactLaunchActions) 定义中的 LaunchAction (具有以下语句：

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

前面的 "ref" 语句指示 ContactLaunchActions) 中的 LaunchAction ( 继承所有这些 扩展 基本属性：

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

由于 ContactLaunchActions) 中的 LaunchAction ( 允许 扩展 基本属性，因此它具有 XSD 清单架构未涵盖的这些语义验证：

  • 扩展 基本属性必须遵循下列规则：

    • 如果指定了 StartPage 属性，则如果指定了 EntryPoint、 Executable或 RuntimeType 属性，则会失败。
    • 否则，如果指定了 Executable 或 RuntimeType 属性，但未指定 入口点 ，则会失败。

  • 如果 LaunchAction 定义 入口点 属性，则此 LaunchAction 或父 扩展 或 应用程序 元素必须指定一个 可执行 属性。

要求

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