uap:Protocol (Windows 10)

  • [アーティクル]

windows.protocol 型のアプリ拡張ポイントを宣言します。 URI 関連付けは、指定されたスキームで URI を処理するためにアプリが登録されていることを示します。

要素の階層

<パッケージ>

    <アプリケーション>

         <Application>

              <拡張機能>

                   <uap:Extension>

                        <uap:Protocol>

構文

<uap:Protocol
  Name = 'A string with a value between 2 and 39 characters in length that contains numbers, lowercase letters, periods ("."), plus signs ("+"), or dashes ("-"). The string cannot start with a period (".").'
  DesiredView = 'A string that can have one of the following values: "default", "useLess", "useHalf", "useMore", or "useMinimum".'
  ReturnResults = 'An optional string that can have one of the following values: "none", "always", "optional".' >

  <!-- Child elements -->
  uap:Logo?
  & uap:DisplayName?
  & desktop7:ProgId
</uap:Protocol>

キー

? 省略可能 (0 または 1) & インターリーブ コネクタ (任意の順序で発生する可能性があります)

属性と要素

属性

属性 説明 データ型 必須 既定値
名前 URI スキームの名前 (など mailto)。 この名前は、パッケージに対して一意である必要があります。 数字、小文字、ピリオド ()、プラス記号 ()、ダッシュ- (.+) を含む長さが 2 ~ 39 文字の文字列。 文字列をピリオド (.) で始めることはできません。 Yes
DesiredView 予定の起動時に使用する画面領域の量。 default、useLess、useHalf、useMore、useMinimum のいずれかの値を持つ文字列。 いいえ
ReturnResults URI のアクティブ化を介して呼び出されたときに、アプリが値を返すかどうかを指定します。 "none" (値を返しません)、"always" (URI アクティブ化は常に結果を返します)、"省略可能" ( LAUNCHUriForResultsAndContinueAsync を使用して結果に対してアクティブ化された場合、URI アクティブ化は結果を返します) のいずれかの値を持つことができます。省略可能な文字列。 いいえ

子要素

子要素 説明
uap:DisplayName ユーザーに表示できるフレンドリ名。
uap:Logo イメージを含むファイルへのパス。
desktop7:ProgId CLSID に関連付けることができるプログラム識別子 (ProgID)。

親要素

親要素 説明
uap:Extension アプリの拡張ポイントを宣言します。

例

次の例は、いずれかの SDK サンプルのパッケージ マニフェストから取得したものです。

<Applications>
  <Application
    Id="App"
    StartPage="default.html">
    <Extensions>
      <uap:Extension
        Category="windows.protocol">
        <uap:Protocol
          Name="alsdk" />
      </uap:Extension>
    </Extensions>
  </Application>
</Applications>

こちらもご覧ください

タスクURI のアクティブ化を処理する方法

概念アプリコントラクトと拡張機能

必要条件

Item 値
Namespace http://schemas.microsoft.com/appx/manifest/uap/windows10
Minimum OS Version Windows 10 バージョン 1511 (ビルド 10586)