共用方式為


ContactLaunchActions 中的 LaunchAction ()

描述 ContactLaunchActions 內容動作。

元素階層

<延伸模組>
<Contact>
<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。

這個屬性可以具有下列其中一個值:

  • 預設
  • 無用
  • useHalf
  • useMore
  • useMinimum
No
動詞

啟動時傳遞至應用程式的唯一識別碼。 應用程式可以使用此字串來判斷哪個 ContactLaunchActions 處理常式觸發其啟動。 它在封裝中的每個應用程式都是唯一的,而且會區分大小寫。

這個屬性可以具有下列其中一個值:

  • call
  • map
  • message
  • post
  • videoCall
Yes

 

子元素

子元素 描述
ServiceId

識別連絡人動作的服務。

 

父項目

Parent 項目 描述
ContactLaunchActions

宣告當連絡人啟動時要採取的動作。

 

下列專案的名稱與這個專案的名稱相同,但內容或屬性不同:

備註

如需連絡人提供者所需啟動動作的詳細資訊,請參閱 ContactLaunchActionVerbs

資訊清單會針對ContactLaunchActions內容動作的Verb屬性強制執行這些語義檢查。

  • 如果 Verb 設定為 map,它就不能宣告任何 ServiceId 元素。 動詞的所有其他值都必須宣告ServiceId
  • 只有當 Verb 設為 callmessage時,它才能將 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 屬性,就會在指定 EntryPointExecutable>system.runtimetype 屬性時失敗。
    • 否則,如果指定了 Executable>system.runtimetype 屬性,但未指定 EntryPoint ,則會失敗。
  • 如果 LaunchAction 定義 EntryPoint 屬性,則這個 LaunchAction 或 parent ExtensionApplication 元素必須指定 可執行 的屬性。

需求

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