Windows アプリでファイルのアクティブ化を処理する

アプリを登録して、特定の種類のファイルの既定のハンドラーにすることができます。 Windows デスクトップ アプリケーションと WinUI アプリはどちらも、既定のファイル ハンドラーとして登録できます。 ユーザーが特定のファイルの種類の既定のハンドラーとしてアプリを選択した場合、その種類のファイルが起動されるとアプリがアクティブになります。

その種類のファイルに対するすべてのファイル起動を処理する場合にのみ、ファイルの種類に登録することをお勧めします。 アプリでファイルの種類のみを内部的に使用する必要がある場合は、既定のハンドラーとして登録する必要はありません。 ファイルの種類に登録する場合は、そのファイルの種類に対してアプリをアクティブ化するときに期待される機能をエンド ユーザーに提供する必要があります。 たとえば、画像ビューアー アプリは、.jpg ファイルを表示するために登録できます。 ファイルの関連付けの詳細については、「 ファイルの種類と URI のガイドライン」を参照してください。

これらの手順では、カスタム ファイルの種類 .alsdk に登録する方法と、ユーザーが .alsdk ファイルを起動したときにアプリをアクティブ化する方法を示します。

重要な API

このトピックでは、次の API を使用します。

• Windows.ApplicationModel.Activation.FileActivatedEventArgs
• Windows.UI.Xaml.Application.OnFileActivated
• AppInstance.GetActivatedEventArgs

手順 1: パッケージ マニフェストで拡張ポイントを指定する

アプリは、パッケージ マニフェストに一覧表示されているファイル拡張子に対してのみアクティブ化イベントを受け取ります。 アプリが .alsdk 拡張子を持つファイルを処理することを示す方法を次に示します。

1. ソリューション エクスプローラーで package.appxmanifest をダブルクリックしてマニフェスト デザイナーを開きます。 [ 宣言 ] タブを選択し、[ 使用可能な宣言 ] ドロップダウンで [ ファイルの種類の関連付け ] を選択し、[ 追加] をクリックします。 ファイル の 関連付けで使用される識別子の詳細については、「プログラム識別子」を参照してください。

   マニフェスト デザイナーに入力できる各フィールドの簡単な説明を次に示します。

2. 名前として「 alsdk 」と入力 します。
3. .alsdkとして「」と入力します。
4. ロゴとして「images\Icon.png」と入力します。
5. 変更を package.appxmanifest に保存するには、Ctrl キーを押しながら S キーを押します。

上記の手順では、次のような Extension 要素をパッケージ マニフェストに追加します。 windows.fileTypeAssociation カテゴリは、アプリが.alsdk拡張子を持つファイルを処理することを示します。

      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap:FileTypeAssociation Name="alsdk">
            <uap:Logo>images\icon.png</uap:Logo>
            <uap:SupportedFileTypes>
              <uap:FileType>.alsdk</uap:FileType>
            </uap:SupportedFileTypes>
          </uap:FileTypeAssociation>
        </uap:Extension>
      </Extensions>

手順 2: 適切なアイコンを追加する

ファイルの種類の既定値となるアプリには、システム全体のさまざまな場所にアイコンが表示されます。 たとえば、次のアイコンが表示されます。

• Windows エクスプローラーのアイテム ビュー、コンテキスト メニュー、リボン
• 既定のプログラムのコントロール パネル
• ファイル選択ツール
• スタート画面の検索結果

プロジェクトに 44 x 44 アイコンを含め、ロゴをそれらの場所に表示できるようにします。 アプリタイルのロゴの外観に合わせて、アイコンを透明にするのではなく、アプリの背景色を使用します。 余白を埋め込まずに、ロゴをエッジまで拡張します。 白い背景でアイコンをテストします。 アイコンの詳細については、 タイルアセットとアイコンアセットのガイドライン を参照してください。

手順 3: アクティブ化されたイベントを処理する

OnFileActivated イベント ハンドラーは、すべてのファイルアクティブ化イベントを受け取ります。

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation
       // The number of files received is args.Files.Count
       // The name of the first file is args.Files[0].Name
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& args)
{
    // TODO: Handle file activation.
    auto numberOfFilesReceived{ args.Files().Size() };
    auto nameOfTheFirstFile{ args.Files().GetAt(0).Name() };
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs^ args)
{
    // TODO: Handle file activation
    // The number of files received is args->Files->Size
    // The name of the first file is args->Files->GetAt(0)->Name
}

新しいページを開くアクティブ化イベントごとに、新しい XAML フレーム を作成することをお勧めします。 そうすることで、新しい XAML フレームのナビゲーション バックスタックには、中断されたときにアプリが現在のウィンドウに存在する可能性がある以前のコンテンツは含まれません。 起動とファイル コントラクトに 1 つの XAML フレーム を使用する場合は、新しいページに移動する前に 、フレームのナビゲーション ジャーナルのページをクリアする必要があります。

ファイルのアクティブ化を使用してアプリを起動する場合は、ユーザーがアプリのトップ ページに戻る UI を含めるかどうかを検討する必要があります。

注釈

受信するファイルは、信頼されていないソースから取得される可能性があります。 アクションを実行する前に、ファイルの内容を検証することをお勧めします。

関連するコンテンツ

• アソシエーション起動のサンプル
• ファイル の既定のアプリを起動する
• URI のアクティブ化を処理する