次の方法で共有


LaunchAction (ContactLaunchActions 内)

ContactLaunchActions コンテンツ アクションについて説明します。

要素の階層

<拡張子>
<Contact>
<ContactLaunchActions>
<LaunchAction>

構文

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

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

</LaunchAction>

キー

? 省略可能 (0 または 1) {} 特定の出現範囲

属性および要素

属性

属性 説明 データ型 必須 既定値
DesiredView

連絡先の起動時に使用する画面領域の量。

Windows Phone: DesiredView は、サポートされていないWindows Phone。

この属性は、次のいずれかの値になります。

  • 既定値 (default)
  • 無用
  • useHalf
  • useMore
  • useMinimum
いいえ
動詞

アプリの起動時にアプリに渡される一意の識別子。 アプリでは、この文字列を使用して、 起動をトリガーした ContactLaunchActions ハンドラーを特定できます。 パッケージ内のアプリケーションごとに一意であり、大文字と小文字が区別されます。

この属性は、次のいずれかの値になります。

  • call
  • map
  • message
  • post
  • videoCall
はい

 

子要素

子要素 説明
ServiceId

連絡先アクションのサービスを識別します。

 

親要素

Parent 要素 説明
ContactLaunchActions

連絡先の起動時に実行するアクションを宣言します。

 

次の要素の名前はこれと同じですが、コンテンツまたは属性が異なります:

注釈

連絡先プロバイダーが実行する起動アクションの詳細については、「 ContactLaunchActionVerbs」を参照してください

マニフェストは、ContactLaunchActions コンテンツ アクションの Verb 属性に対してこれらのセマンティック チェックを適用します。

  • Verb が map に設定 されている場合は、 ServiceId 要素を宣言する必要 があります。 Verb の他のすべての値は、ServiceId を宣言する必要があります
  • Verb が呼び出しまたはメッセージに設定されている場合にのみ、既知の値 "電話" として ServiceId を指定できます。

LaunchAction (ContactLaunchActions 内) 定義には、次のステートメントがあります。

            <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' ステートメントは、 LaunchAction (ContactLaunchActions 内) が次のすべての拡張基本属性を 継承することを 示しています。

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

LaunchAction (ContactLaunchActions 内) では拡張機能の基本属性が許可されるので、XSD マニフェスト スキーマではカバーされない次のセマンティック検証があります。

  • 拡張基本 属性は、次の規則に従う必要があります。

    • StartPage 属性が指定されている場合、EntryPointExecutableまたは RuntimeType 属性が指定されている場合は失敗します。
    • それ以外の場合は、 EntryPoint を指定せずに Executable 属性または RuntimeType 属性を指定 した場合は失敗 します。
  • LaunchAction でEntryPoint 属性が定義されている場合は、この LaunchAction または親の Extension 要素または Application 要素で Executable 属性を指定する必要があります。

要件

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