デスクトップアプリを Windows 10 および UWP と統合するIntegrate your desktop app with Windows 10 and UWP

デスクトップアプリにパッケージ idがある場合は、パッケージマニフェストで定義済みの拡張機能を使用して、拡張機能を使用してアプリを Windows 10 と統合できます。If your desktop app has package identity, you can use extensions to integrate your app with Windows 10 by using predefined extensions in the package manifest.

たとえば、拡張機能を使用して、ファイアウォールの例外を作成したり、アプリをファイルの種類の既定のアプリケーションにしたり、アプリへのタイルを開始したりすることができます。For example, use an extension to create a firewall exception, make your app the default application for a file type, or point start tiles to your app. 拡張機能は、アプリのパッケージ マニフェスト ファイルに XML を追加するだけで使用できます。To use an extension, just add some XML to your app's package manifest file. コードは必要ありません。No code is required.

この記事では、これらの拡張機能と、それらを使用して実行できるタスクについて説明します。This article describes these extensions and the tasks that you can perform by using them.

注意

この記事で説明されている機能を使用するには、デスクトップアプリにパッケージ idがあることが必要です。これには、デスクトップアプリを msix パッケージでパッケージ化するか、スパースパッケージを使用してアプリ id を付与します。The features described in this article require that your desktop app has package identity, either by packaging your desktop app in an MSIX package or by granting your app identity by using a sparse package.

ユーザーをアプリに移行するTransition users to your app

ユーザーによってパッケージ アプリが使用されるように、移行を促します。Help users transition to your packaged app.

既存のスタート タイルとタスク バー ボタンの参照先をパッケージ アプリに設定するPoint existing Start tiles and taskbar buttons to your packaged app

ユーザーによって、デスクトップ アプリがタスク バーまたはスタート メニューにピン留めされている可能性があります。Your users might have pinned your desktop application to the taskbar or the Start menu. これらのショートカットの参照先を新しいパッケージ アプリに変更できます。You can point those shortcuts to your new packaged app.

XML 名前空間XML namespace

http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.desktopAppMigration">
    <DesktopAppMigration>
        <DesktopApp AumId="[your_app_aumid]" />
        <DesktopApp ShortcutPath="[path]" />
    </DesktopAppMigration>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.desktopAppMigration です。Always windows.desktopAppMigration.
AumIDAumID パッケージ アプリのアプリケーション ユーザー モデル ID。The Application User Model ID of your packaged app.
ShortcutPathShortcutPath アプリのデスクトップ バージョンを起動する .lnk ファイルへのパス。The path to .lnk files that start the desktop version of your app.

Example

<Package
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="rescap3">
  <Applications>
    <Application>
      <Extensions>
        <rescap3:Extension Category="windows.desktopAppMigration">
          <rescap3:DesktopAppMigration>
            <rescap3:DesktopApp AumId="[your_app_aumid]" />
            <rescap3:DesktopApp ShortcutPath="%USERPROFILE%\Desktop\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\[my_app_folder]\[my_app].lnk"/>
         </rescap3:DesktopAppMigration>
        </rescap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

移行/移行/アンインストールを含む WPF 画像ビューアーWPF picture viewer with transition/migration/uninstallation

デスクトップアプリではなく、パッケージ化されたアプリケーションがファイルを開いているようにするMake your packaged application open files instead of your desktop app

アプリのデスクトップバージョンを開く代わりに、ユーザーが特定の種類のファイルに対して既定で新しいパッケージアプリケーションを開くようにすることができます。You can make sure that users open your new packaged application by default for specific types of files instead of opening the desktop version of your app.

これを行うには、ファイルの関連付けを継承するために、関連付けされている各アプリケーションのプログラム識別子 (ProgID) を指定します。To do that, you'll specify the programmatic identifier (ProgID) of each application from which you want to inherit file associations.

XML 名前空間XML namespaces

  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
         <MigrationProgIds>
            <MigrationProgId>"[ProgID]"</MigrationProgId>
        </MigrationProgIds>
    </FileTypeAssociation>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
MigrationProgIdMigrationProgId ファイルの関連付けを継承するデスクトップアプリケーションのアプリケーション、コンポーネント、およびバージョンを記述するプログラム識別子 (ProgID)The programmatic identifier (ProgID) that describes the application, component, and version of the desktop application from which you want to inherit file associations.

Example

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap3, rescap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <rescap3:MigrationProgIds>
              <rescap3:MigrationProgId>Foo.Bar.1</rescap3:MigrationProgId>
              <rescap3:MigrationProgId>Foo.Bar.2</rescap3:MigrationProgId>
            </rescap3:MigrationProgIds>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

移行/移行/アンインストールを含む WPF 画像ビューアーWPF picture viewer with transition/migration/uninstallation

パッケージアプリケーションをファイルの種類のセットに関連付けるAssociate your packaged application with a set of file types

パッケージ化されたアプリケーションをファイルの種類の拡張子に関連付けることができます。You can associated your packaged application with file type extensions. ユーザーがファイルを右クリックし、[ファイルを開くアプリケーションの選択] オプションを選択すると、アプリケーションが候補の一覧に表示されます。If a user right-clicks a file and then selects the Open with option, your application appears in the list of suggestions.

XML 名前空間XML namespaces

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[file extension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
FileTypeFileType アプリでサポートされているファイル拡張子。The file extension supported by your app.

Example

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="mediafiles">
            <uap:SupportedFileTypes>
            <uap:FileType>.avi</uap:FileType>
            </uap:SupportedFileTypes>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

移行/移行/アンインストールを含む WPF 画像ビューアーWPF picture viewer with transition/migration/uninstallation

特定の種類のファイルのコンテキスト メニューにオプションを追加するAdd options to the context menus of files that have a certain file type

ほとんどの場合、ユーザーはファイルをダブルクリックして開きます。In most cases, users double-click files to open them. ユーザーがファイルを右クリックすると、さまざまなオプションが表示されます。If users, right click a file, various options appear.

このメニューには、オプションを追加できます。You can add options to that menu. これらのオプションを使用すると、ファイルの印刷、編集、プレビューなど、ファイルの操作を別の方法で行うことができます。These options give users other ways to interact with your file such as print, edit, or preview the file.

XML 名前空間XML namespaces

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/2
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedVerbs>
           <Verb Id="[ID]" Extended="[Extended]" Parameters="[parameters]">"[verb label]"</Verb>
        </SupportedVerbs>
    </FileTypeAssociation>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
動詞Verb エクスプローラーのコンテキスト メニューに表示される名前です。The name that appears in the File Explorer context menu. この文字列は、ms-resource を使用してローカライズできます。This string is localizable that uses ms-resource.
IdId 動詞の一意の ID。The unique Id of the verb. アプリケーションが UWP アプリである場合、これはアクティブ化イベントの引数の一部としてアプリに渡されるので、ユーザーの選択を適切に処理できます。If your application is a UWP app, this is passed to your app as part of its activation event args so it can handle the user’s selection appropriately. アプリケーションが完全に信頼されたパッケージアプリである場合は、代わりにパラメーターを受け取ります (次の箇条書きを参照)。If your application is a full-trust packaged app, it receives parameters instead (see the next bullet).
パラメーターParameters 動詞に関連付けられている引数のパラメーターと値のリスト。The list of argument parameters and values associated with the verb. アプリケーションが完全に信頼されたパッケージアプリである場合、これらのパラメーターは、アプリケーションがアクティブ化されるときにイベント引数としてアプリケーションに渡されます。If your application is a full-trust packaged app, these parameters are passed to the application as event args when the application is activated. さまざまなアクティベーション動詞に基づいて、アプリケーションの動作をカスタマイズできます。You can customize the behavior of your application based on different activation verbs. 変数にファイル パスが含まれる可能性がある場合は、パラメーター値を引用符で囲みます。If a variable can contain a file path, wrap the parameter value in quotes. これにより、パスにスペースが含まれている場合に発生する問題を回避できます。That will avoid any issues that happen in cases where the path includes spaces. アプリケーションが UWP アプリの場合、パラメーターを渡すことはできません。If your application is a UWP app, you can’t pass parameters. アプリは、代わりに ID を受け取ります (前の項目を参照してください)。The app receives the Id instead (see the previous bullet).
ExtendedExtended ユーザーが Shift キーを押しながらファイルを右クリックすることでコンテキスト メニューを表示した場合にのみ表示される動詞を指定します。Specifies that the verb appears only if the user shows the context menu by holding the Shift key before right-clicking the file. この属性は省略可能であり、既定値はFalseに設定されています (たとえば、常に動詞を表示します)。This attribute is optional and defaults to a value of False (for example, always show the verb) if not listed. この動作は各動詞について個別に指定します ("開く" は例外で、常に False)。You specify this behavior individually for each verb (except for "Open," which is always False).

Example

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"

  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" Parameters="/e &quot;%1&quot;">Edit</uap3:Verb>
              <uap3:Verb Id="Print" Extended="true" Parameters="/p &quot;%1&quot;">Print</uap3:Verb>
            </uap2:SupportedVerbs>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

移行/移行/アンインストールを含む WPF 画像ビューアーWPF picture viewer with transition/migration/uninstallation

URL を使用して特定の種類のファイルを直接開くOpen certain types of files directly by using a URL

アプリのデスクトップバージョンを開く代わりに、ユーザーが特定の種類のファイルに対して既定で新しいパッケージアプリケーションを開くようにすることができます。You can make sure that users open your new packaged application by default for specific types of files instead of opening the desktop version of your app.

XML 名前空間XML namespaces

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" UseUrl="true" Parameters="%1">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
UseUrlUseUrl URL ターゲットから直接ファイルを開くかどうかを示します。Indicates whether to open files directly from a URL target. この値を設定しなかった場合、URL を使用してアプリケーションがファイルを開こうとすると、システムは最初にファイルをローカルにダウンロードします。If you do not set this value, attempts by your application to open a file by using a URL cause the system to first download the file locally.
パラメーターParameters 省略可能なパラメーター。Optional parameters.
FileTypeFileType 関連するファイル拡張子。The relevant file extensions.

Example

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
      <Application>
        <Extensions>
          <uap:Extension Category="windows.fileTypeAssociation">
            <uap3:FileTypeAssociation Name="myfiletypes" UseUrl="true" Parameters="%1">
              <uap:SupportedFileTypes>
                <uap:FileType>.txt</uap:FileType>
                <uap:FileType>.doc</uap:FileType>
              </uap:SupportedFileTypes>
            </uap3:FileTypeAssociation>
          </uap:Extension>
        </Extensions>
      </Application>
    </Applications>
</Package>

セットアップ タスクを実行するPerform setup tasks

アプリのファイアウォール例外を作成するCreate firewall exception for your app

アプリケーションがポート経由の通信を必要とする場合は、アプリケーションをファイアウォール例外の一覧に追加できます。If your application requires communication through a port, you can add your application to the list of firewall exceptions.

XML 名前空間XML namespace

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.firewallRules">
  <FirewallRules Executable="[executable file name]">
    <Rule
      Direction="[Direction]"
      IPProtocol="[Protocol]"
      LocalPortMin="[LocalPortMin]"
      LocalPortMax="LocalPortMax"
      RemotePortMin="RemotePortMin"
      RemotePortMax="RemotePortMax"
      Profile="[Profile]"/>
  </FirewallRules>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.firewallRulesAlways windows.firewallRules
実行可能ファイルExecutable ファイアウォールの例外の一覧に追加する実行可能ファイルの名前。The name of the executable file that you want to add to the list of firewall exceptions
DirectionDirection 規則が受信規則か送信規則かを示します。Indicates whether the rule is an inbound or outbound rule
IPProtocolIPProtocol 通信プロトコル。The communication protocol
LocalPortMinLocalPortMin ローカル ポート番号の範囲を示すポート番号の下限。The lower port number in a range of local port numbers.
LocalPortMaxLocalPortMax ローカル ポート番号の範囲を示すポート番号の上限。The highest port number of a range of local port numbers.
RemotePortMaxRemotePortMax リモート ポート番号の範囲を示すポート番号の下限。The lower port number in a range of remote port numbers.
RemotePortMaxRemotePortMax リモート ポート番号の範囲を示すポート番号の上限。The highest port number of a range of remote port numbers.
ProfileProfile ネットワークの種類。The network type

Example

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Extensions>
    <desktop2:Extension Category="windows.firewallRules">
      <desktop2:FirewallRules Executable="Contoso.exe">
          <desktop2:Rule Direction="in" IPProtocol="TCP" Profile="all"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="domain"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="public"/>
          <desktop2:Rule Direction="out" IPProtocol="UDP" LocalPortMin="1339" LocalPortMax="1340" RemotePortMin="15"
                         RemotePortMax="19" Profile="domainAndPrivate"/>
          <desktop2:Rule Direction="out" IPProtocol="GRE" Profile="private"/>
      </desktop2:FirewallRules>
  </desktop2:Extension>
</Extensions>
</Package>

DLL ファイルをパッケージの任意のフォルダーに配置します。Place your DLL files into any folder of the package

拡張機能を使ってそれらのフォルダーを指定します。Use an extension to identify those folders. これにより、システムは配置したファイルを見つけて読み込むことができます。That way, the system can find and load the files that you place in them. この拡張機能は、 %PATH% 環境変数の置き換えと考えてください。Think of this extension as a replacement of the %PATH% environment variable.

この拡張機能を使わない場合、システムはプロセスのパッケージの依存関係グラフ、パッケージ ルート フォルダー、システム ディレクトリ ( %SystemRoot%\system32) の順で検索します。If you don't use this extension, the system searches the package dependency graph of the process, the package root folder, and then the system directory (%SystemRoot%\system32) in that order. 詳しくは、Windows アプリの検索順序に関するページをご覧ください。To learn more, see Search order of Windows apps.

各パッケージには、これらの拡張機能を 1 つだけ含めることができます。Each package can contain only one of these extensions. つまり、1 つをメイン パッケージに追加し、他の拡張機能はオプション パッケージと関連するセットそれぞれに 1 つずつ追加できます。That means that you can add one of them to your main package, and then add one to each of your optional packages, and related sets.

XML 名前空間XML namespace

http://schemas.microsoft.com/appx/manifest/uap/windows10/6

この拡張機能の要素と属性Elements and attributes of this extension

アプリケーション マニフェストのパッケージ レベルでこの拡張機能を宣言します。Declare this extension at the package-level of your app manifest.

<Extension Category="windows.loaderSearchPathOverride">
  <LoaderSearchPathOverride>
    <LoaderSearchPathEntry FolderPath="[path]"/>
  </LoaderSearchPathOverride>
</Extension>

名前Name 説明Description
カテゴリCategory 常に windows.loaderSearchPathOverride です。Always windows.loaderSearchPathOverride.
FolderPathFolderPath dll ファイルが含まれているフォルダーのパス。The path of the folder that contains your dll files. パッケージのルート フォルダーの相対パスを指定します。Specify a path that is relative to the root folder of the package. 1 つの拡張機能で最大 5 つのパスを指定できます。You can specify up to five paths in one extension. システムがパッケージのルート フォルダーにあるファイルを検索するようにする場合、これらのパスのいずれかに空の文字列を使用します。If you want the system to search for files in the root folder of the package, use an empty string for one of these paths. 重複するパスを含めないでください。パスの先頭と末尾にスラッシュや円記号を使わないでください。Don't included duplicate paths and make sure that your paths don't contain leading and trailing slashes or backslashes.

システムはサブフォルダーを検索しないため、システムが読み込む DLL ファイルが含まれている各フォルダーを明示的に一覧表示してください。The system won't search subfolders, so make sure to explicitly list each folder that contains DLL files that you want the system to load.

Example

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/6"
  IgnorableNamespaces="uap6">
  ...
    <Extensions>
      <uap6:Extension Category="windows.loaderSearchPathOverride">
        <uap6:LoaderSearchPathOverride>
          <uap6:LoaderSearchPathEntry FolderPath=""/>
          <uap6:LoaderSearchPathEntry FolderPath="folder1/subfolder1"/>
          <uap6:LoaderSearchPathEntry FolderPath="folder2/subfolder2"/>
        </uap6:LoaderSearchPathOverride>
      </uap6:Extension>
    </Extensions>
...
</Package>

エクスプローラーに統合するIntegrate with File Explorer

ユーザーが慣れた方法でファイルを整理し操作できるようになります。Help users organize your files and interact with them in familiar ways.

ユーザーが複数のファイルを同時に選択して開くときのアプリケーションの動作を定義します。Define how your application behaves when users select and open multiple files at the same time

ユーザーが複数のファイルを同時に開いたときのアプリケーションの動作を指定します。Specify how your application behaves when a user opens multiple files simultaneously.

XML 名前空間XML namespaces

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/2
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" MultiSelectModel="[SelectionModel]">
        <SupportedVerbs>
            <Verb Id="Edit" MultiSelectModel="[SelectionModel]">Edit</Verb>
        </SupportedVerbs>
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
MultiSelectModelMultiSelectModel 下を参照See below
FileTypeFileType 関連するファイル拡張子。The relevant file extensions.

MultiSelectModelMultiSelectModel

パッケージ デスクトップ アプリには、通常のデスクトップ アプリと同じ 3 つのオプションがあります。packaged desktop apps have the same three options as regular desktop apps.

  • Player: アプリケーションは1回だけアクティブ化されます。Player: Your application is activated one time. 選択したファイルはすべて、引数パラメーターとしてアプリケーションに渡されます。All of the selected files are passed to your application as argument parameters.
  • Single: 最初に選択したファイルに対してアプリケーションが1回アクティブ化されます。Single: Your application is activated one time for the first selected file. その他のファイルは無視されます。Other files are ignored.
  • Document: 選択したファイルごとに、アプリケーションの新しい個別のインスタンスがアクティブ化されます。Document: A new, separate instance of your application is activated for each selected file.

ファイルの種類やアクションごとに、さまざまな環境設定項目を設定できます。You can set different preferences for different file types and actions. たとえば、DocumentsDocument モードで開き、ImagesPlayer モードで開くことができます。For example, you may wish to open Documents in Document mode and Images in Player mode.

Example

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes" MultiSelectModel="Document">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" MultiSelectModel="Player">Edit</uap3:Verb>
              <uap3:Verb Id="Preview" MultiSelectModel="Document">Preview</uap3:Verb>
            </uap2:SupportedVerbs>
            <uap:SupportedFileTypes>
              <uap:FileType>.txt</uap:FileType>
            </uap:SupportedFileTypes>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

ユーザーが 15 個以下のファイルを開いた場合、MultiSelectModel 属性の既定値は Player になります。If the user opens 15 or fewer files, the default choice for the MultiSelectModel attribute is Player. それ以外の場合、既定値は Document です。Otherwise, the default is Document. UWP アプリは常に Player として起動されます。UWP apps are always started as Player.

エクスプ ローラーでサムネイル画像のファイル内容を表示するShow file contents in a thumbnail image within File Explorer

ファイルが中アイコン、大アイコン、特大アイコンで表示された場合に、ファイル内容のサムネイル画像をユーザーが確認できるようにします。Enable users to view a thumbnail image of the file's contents when the icon of the file appears in the medium, large, or extra large size.

XML 名前空間XML namespace

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/2
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <ThumbnailHandler
            Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
FileTypeFileType 関連するファイル拡張子。The relevant file extensions.
ClsidClsid アプリのクラス ID。The class ID of your app.

Example

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap2:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap2:SupportedFileTypes>
            <desktop2:ThumbnailHandler
              Clsid  ="20000000-0000-0000-0000-000000000001"  />
            </uap3:FileTypeAssociation>
         </uap::Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

エクスプローラーのプレビュー ウィンドウにファイル内容を表示するShow file contents in the Preview pane of File Explorer

エクスプローラーのプレビュー ウィンドウで、ユーザーがファイルの内容をプレビューできるようにします。Enable users to preview a file's contents in the Preview pane of File Explorer.

XML 名前空間XML namespace

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/2
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <DesktopPreviewHandler Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
FileTypeFileType 関連するファイル拡張子。The relevant file extensions.
ClsidClsid アプリのクラス ID。The class ID of your app.

Example

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap2SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
                </uap2SupportedFileTypes>
              <desktop2:DesktopPreviewHandler Clsid ="20000000-0000-0000-0000-000000000001" />
           </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

ユーザーがエクスプローラーの [種類] 列を使用してファイルをグループ化できるようにするEnable users to group files by using the Kind column in File Explorer

ファイルの種類に関する 1 つまたは複数の定義済みの値を Kind フィールドに関連付けることができます。You can associate one or more predefined values for your file types with the Kind field.

ユーザーはエクスプローラーでこのフィールドを使用して、ファイルをグループ化できます。In File Explorer, users can group those files by using that field. また、このフィールドは、システム コンポーネントによって、インデックス作成などのさまざまな目的にも使用されます。System components also use this field for various purposes such as indexing.

Kind フィールドの詳細と、このフィールドに使用できる値については、「種類名の使用」をご覧ください。For more information about the Kind field and the values that you can use for this field, see Using Kind Names.

XML 名前空間XML namespaces

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <KindMap>
            <Kind value="[KindValue]">
        </KindMap>
    </FileTypeAssociation>
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
FileTypeFileType 関連するファイル拡張子。The relevant file extensions.
valuevalue 有効な Kind 値A valid Kind value

Example

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap, rescap">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
           <uap:FileTypeAssociation Name="mediafiles">
             <uap:SupportedFileTypes>
               <uap:FileType>.m4a</uap:FileType>
               <uap:FileType>.mta</uap:FileType>
             </uap:SupportedFileTypes>
             <rescap:KindMap>
               <rescap:Kind value="Item">
               <rescap:Kind value="Communications">
               <rescap:Kind value="Task">
             </rescap:KindMap>
          </uap:FileTypeAssociation>
      </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

ファイルのプロパティを検索、インデックス、プロパティ ダイアログ、詳細ウィンドウに利用できるようにするMake file properties available to search, index, property dialogs, and the details pane

XML 名前空間XML namespace

  • http://schemas.microsoft.com/appx/manifest/uap/windows10
  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

この拡張機能の要素と属性Elements and attributes of this extension

<uap:Extension Category="windows.fileTypeAssociation">
    <uap:FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>.bar</FileType>
        </SupportedFileTypes>
        <DesktopPropertyHandler Clsid ="[Clsid]"/>
    </uap:FileTypeAssociation>
</uap:Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.fileTypeAssociation です。Always windows.fileTypeAssociation.
名前Name ファイルの種類の関連付けの名前。The name of the file type association. この名前を使用して、ファイルの種類を整理およびグループ化することができます。You can use this name to organize and group file types. 名前は、すべて小文字で、スペースを使用しないようにする必要があります。The name must be all lower case characters with no spaces.
FileTypeFileType 関連するファイル拡張子。The relevant file extensions.
ClsidClsid アプリのクラス ID。The class ID of your app.

Example

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:DesktopPropertyHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

ファイルの種類のコンテキストメニューハンドラーを指定するSpecify a context menu handler for a file type

デスクトップアプリケーションでコンテキストメニューハンドラーを定義する場合は、この拡張機能を使用してメニューハンドラーを登録します。If your desktop application defines a context menu handler, use this extension to register the menu handler.

XML 名前空間XML namespaces

  • http://schemas.microsoft.com/appx/manifest/foundation/windows10
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10/4

この拡張機能の要素と属性Elements and attributes of this extension

<Extensions>
    <com:Extension Category="windows.comServer">
        <com:ComServer>
            <com:SurrogateServer AppId="[AppID]" DisplayName="[DisplayName]">
                <com:Class Id="[Clsid]" Path="[Path]" ThreadingModel="[Model]"/>
            </com:SurrogateServer>
        </com:ComServer>
    </com:Extension>
    <desktop4:Extension Category="windows.fileExplorerContextMenus">
        <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type="[Type]">
                <desktop4:Verb Id="[ID]" Clsid="[Clsid]" />
            </desktop4:ItemType>
        </desktop4:FileExplorerContextMenus>
    </desktop4:Extension>
</Extensions>

完全なスキーマ参照については、「 com: ComServer and desktop4: FileExplorerContextMenus」を参照してください。Find the complete schema reference here: com:ComServer and desktop4:FileExplorerContextMenus.

手順Instructions

コンテキストメニューハンドラーを登録するには、次の手順に従います。To register your context menu handler, follow these instructions.

  1. デスクトップアプリケーションで、 IExplorerCommandまたはIExplorerCommandStateインターフェイスを実装してコンテキストメニューハンドラーを実装します。In your desktop application, implement a context menu handler by implementing the IExplorerCommand or IExplorerCommandState interface. サンプルについては、 ExplorerCommandVerbのコードサンプルを参照してください。For a sample, see the ExplorerCommandVerb code sample. 各実装オブジェクトのクラス GUID を定義していることを確認してください。Make sure that you define a class GUID for each of your implementation objects. たとえば、次のコードは、 IExplorerCommandの実装のクラス ID を定義します。For example, the following code defines a class ID for an implementation of IExplorerCommand.

    class __declspec(uuid("d0c8bceb-28eb-49ae-bc68-454ae84d6264")) CExplorerCommandVerb;
    
  2. パッケージマニフェストで、com サロゲートサーバーをコンテキストメニューハンドラーの実装のクラス ID に登録するcom: ComServerアプリケーション拡張機能を指定します。In your package manifest, specify a com:ComServer application extension that registers a COM surrogate server with the class ID of your context menu handler implementation.

    <com:Extension Category="windows.comServer">
        <com:ComServer>
            <com:SurrogateServer AppId="d0c8bceb-28eb-49ae-bc68-454ae84d6264" DisplayName="ContosoHandler">
                <com:Class Id="d0c8bceb-28eb-49ae-bc68-454ae84d6264" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
            </com:SurrogateServer>
        </com:ComServer>
    </com:Extension>
    
  3. パッケージマニフェストで、コンテキストメニューハンドラーの実装を登録するdesktop4: FileExplorerContextMenusアプリケーション拡張機能を指定します。In your package manifest, specify a desktop4:FileExplorerContextMenus application extension that registers your context menu handler implementation.

    <desktop4:Extension Category="windows.fileExplorerContextMenus">
        <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type=".rar">
                <desktop4:Verb Id="Command1" Clsid="d0c8bceb-28eb-49ae-bc68-454ae84d6264" />
            </desktop4:ItemType>
        </desktop4:FileExplorerContextMenus>
    </desktop4:Extension>
    

Example

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:desktop4="http://schemas.microsoft.com/appx/manifest/desktop/windows10/4"
  IgnorableNamespaces="desktop4">
  <Applications>
    <Application>
      <Extensions>
        <com:Extension Category="windows.comServer">
          <com:ComServer>
            <com:SurrogateServer AppId="d0c8bceb-28eb-49ae-bc68-454ae84d6264" DisplayName="ContosoHandler"">
              <com:Class Id="Id="d0c8bceb-28eb-49ae-bc68-454ae84d6264" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
            </com:SurrogateServer>
          </com:ComServer>
        </com:Extension>
        <desktop4:Extension Category="windows.fileExplorerContextMenus">
          <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type=".contoso">
              <desktop4:Verb Id="Command1" Clsid="d0c8bceb-28eb-49ae-bc68-454ae84d6264" />
            </desktop4:ItemType>
          </desktop4:FileExplorerContextMenus>
        </desktop4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

クラウド サービスのファイルがエクスプローラーに表示されるようにするMake files from your cloud service appear in File Explorer

アプリに実装するハンドラーを登録するRegister the handlers that you implement in your application. ユーザーがエクスプローラーでクラウド ベースのファイルを右クリックしたときに表示されるコンテキスト メニュー オプションを追加することもできます。You can also add context menu options that appear when you users right-click your cloud-based files in File Explorer.

XML 名前空間XML namespace

  • http://schemas.microsoft.com/appx/manifest/desktop/windows10

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.cloudfiles" >
    <CloudFiles IconResource="[Icon]">
        <CustomStateHandler Clsid ="[Clsid]"/>
        <ThumbnailProviderHandler Clsid ="[Clsid]"/>
        <ExtendedPropertyhandler Clsid ="[Clsid]"/>
        <CloudFilesContextMenus>
            <Verb Id ="Command3" Clsid= "[GUID]">[Verb Label]</Verb>
        </CloudFilesContextMenus>
    </CloudFiles>
</Extension>

名前Name 説明Description
カテゴリCategory 常に windows.cloudfiles です。Always windows.cloudfiles.
iconResourceiconResource クラウド ファイル プロバイダー サービスを表すアイコン。The icon that represents your cloud file provider service. このアイコンは、エクスプローラーのナビゲーション ウィンドウに表示されます。This icon appears in the Navigation pane of File Explorer. ユーザーは、このアイコンを選んでクラウド サービスのファイルを表示します。Users choose this icon to show files from your cloud service.
CustomStateHandler ClsidCustomStateHandler Clsid CustomStateHandler を実装するアプリケーションのクラス ID。The class ID of the application that implements the CustomStateHandler. システムは、このクラス ID を使ってクラウド ファイルのカスタム状態と列を要求します。The system uses this Class ID to request custom states and columns for cloud files.
ThumbnailProviderHandler ClsidThumbnailProviderHandler Clsid ThumbnailProviderHandler を実装するアプリケーションのクラス ID。The class ID of the application that implements the ThumbnailProviderHandler. システムは、このクラス ID を使ってクラウド ファイルの縮小版イメージを要求します。The system uses this Class ID to request thumbnail images for cloud files.
ExtendedPropertyHandler ClsidExtendedPropertyHandler Clsid ExtendedPropertyHandler を実装するアプリケーションのクラス ID。The class ID of the application that implements the ExtendedPropertyHandler. システムは、このクラス ID を使ってクラウド ファイルの拡張プロパティを要求します。The system uses this Class ID to request extended properties for a cloud file.
動詞Verb クラウド サービスによって提供されるファイルのエクスプローラー コンテキスト メニューに表示される名前です。The name that appears in the File Explorer context menu for files provided by your cloud service.
IdId 動詞の一意の ID。The unique ID of the verb.

Example

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
    IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <Extension Category="windows.cloudfiles" >
            <CloudFiles IconResource="images\Wide310x150Logo.png">
                <CustomStateHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ThumbnailProviderHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ExtendedPropertyhandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <desktop:CloudFilesContextMenus>
                    <desktop:Verb Id ="keep" Clsid=
                       "20000000-0000-0000-0000-000000000001">
                       Always keep on this device</desktop:Verb>
                </desktop:CloudFilesContextMenus>
            </CloudFiles>
          </Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

さまざまな方法でアプリケーションを起動するStart your application in different ways

プロトコルを使用してアプリケーションを起動するStart your application by using a protocol

プロトコルの関連付けによって、他のプログラムやシステム コンポーネントがパッケージ アプリと相互運用できるようにします。Protocol associations can enable other programs and system components to interoperate with your packaged app. パッケージアプリケーションがプロトコルを使用して起動された場合は、それに応じて動作するように、アクティブ化イベントの引数に渡す特定のパラメーターを指定できます。When your packaged application is started by using a protocol, you can specify specific parameters to pass to its activation event arguments so it can behave accordingly. パラメーターは、完全に信頼できるパッケージ アプリでのみサポートされています。Parameters are supported only for packaged, full-trust apps. UWP アプリでは、パラメーターを使用できません。UWP apps can't use parameters.

XML 名前空間XML namespace

http://schemas.microsoft.com/appx/manifest/uap/windows10/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension
    Category="windows.protocol">
  <Protocol
      Name="[Protocol name]"
      Parameters="[Parameters]" />
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.protocol です。Always windows.protocol.
名前Name プロトコルの名前。The name of the protocol.
パラメーターParameters アプリケーションがアクティブ化されるときに、イベント引数としてアプリケーションに渡すパラメーターと値の一覧。The list of parameters and values to pass to your application as event arguments when the application is activated. 変数にファイル パスが含まれる可能性がある場合は、パラメーター値を引用符で囲みます。If a variable can contain a file path, wrap the parameter value in quotes. これにより、パスにスペースが含まれている場合に発生する問題を回避できます。That will avoid any issues that happen in cases where the path includes spaces.

Example

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="uap3, desktop">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension
          Category="windows.protocol">
          <uap3:Protocol
            Name="myapp-cmd"
            Parameters="/p &quot;%1&quot;" />
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

エイリアスを使用してアプリケーションを起動するStart your application by using an alias

ユーザーおよびその他のプロセスは、アプリケーションの完全なパスを指定しなくても、エイリアスを使用してアプリケーションを起動できます。Users and other processes can use an alias to start your application without having to specify the full path to your app. そのエイリアス名を指定できます。You can specify that alias name.

XML 名前空間XML namespaces

  • http://schemas.microsoft.com/appx/manifest/uap/windows10/3
  • http://schemas.microsoft.com/appx/manifest/desktop/windows10

この拡張機能の要素と属性Elements and attributes of this extension

<Extension
    Category="windows.appExecutionAlias"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
    <AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </AppExecutionAlias>
</Extension>
名前Name 説明Description
カテゴリCategory 常に windows.appExecutionAlias です。Always windows.appExecutionAlias.
実行可能ファイルExecutable エイリアスが呼び出されたときに起動する実行可能ファイルの相対パス。The relative path to the executable to start when the alias is invoked.
AliasAlias アプリの短い名前。The short name for your app. 常に、拡張子 ".exe" で終わっている必要があります。It must always end with the ".exe" extension. パッケージ内のアプリケーションごとにアプリの実行エイリアスは 1 つだけ指定できます。You can only specify a single app execution alias for each application in the package. 複数のアプリで同じエイリアスが登録されている場合、システムは最後に登録されたアプリを呼び出します。したがって、他のアプリが上書きする可能性が低い一意のエイリアスを選んでください。If multiple apps register for the same alias, the system will invoke the last one that was registered, so make sure to choose a unique alias other apps are unlikely to override.

Example

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
         <uap3:Extension
                Category="windows.appExecutionAlias"
                Executable="exes\launcher.exe"
                EntryPoint="Windows.FullTrustApplication">
            <uap3:AppExecutionAlias>
                <desktop:ExecutionAlias Alias="Contoso.exe" />
            </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

ユーザーが Windows にログオンしたときに実行可能ファイルを起動するStart an executable file when users log into Windows

スタートアップタスクを使用すると、アプリケーションは、ユーザーがログオンするたびに実行可能ファイルを自動的に実行できます。Startup tasks allow your application to run an executable automatically whenever a user logs on.

注意

このスタートアップタスクを登録するには、ユーザーが少なくとも1回アプリケーションを起動する必要があります。The user has to start your application at least one time to register this startup task.

アプリケーションでは、複数のスタートアップタスクを宣言できます。Your application can declare multiple startup tasks. 各タスクは独立して起動されます。Each task starts independently. すべてのスタートアップ タスクは、タスク マネージャーの [スタートアップ] タブに、アプリのマニフェストで指定した名前とアプリのアイコンを使って表示されます。All startup tasks will appear in Task Manager under the Startup tab with the name that you specify in your app's manifest and your app's icon. タスク マネージャーによって、タスクの起動への影響が自動的に分析されます。Task Manager will automatically analyze the startup impact of your tasks.

ユーザーは、タスク マネージャーを使用して、アプリのスタートアップ タスクを手動で無効にすることができます。Users can manually disable your app's startup task by using Task Manager. ユーザーがタスクを無効にした場合、プログラムでタスクを再度有効にすることはできません。If a user disables a task, you can't programmatically re-enable it.

XML 名前空間XML namespace

http://schemas.microsoft.com/appx/manifest/desktop/windows10

この拡張機能の要素と属性Elements and attributes of this extension

<Extension
    Category="windows.startupTask"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
  <StartupTask
      TaskId="[TaskID]"
      Enabled="true"
      DisplayName="[DisplayName]" />
</Extension>
名前Name 説明Description
カテゴリCategory 常に windows.startupTask です。Always windows.startupTask.
実行可能ファイルExecutable 起動する実行可能ファイルへの相対パス。The relative path to the executable file to start.
TaskIdTaskId タスクの一意の識別子。A unique identifier for your task. この識別子を使用して、アプリケーションは、プログラムによってスタートアップタスクを有効または無効にするために、 Windowsの api を呼び出すことができます。Using this identifier, your application can call the APIs in the Windows.ApplicationModel.StartupTask class to programmatically enable or disable a startup task.
有効Enabled 初めて起動したタスクを有効にするか、無効にするかを指定します。Indicates whether the task first starts enabled or disabled. 有効になっているタスクは、(ユーザーが無効にしていない限り) 次回ユーザーがログオンするときに実行されます。Enabled tasks will run the next time the user logs on (unless the user disables it).
DisplayNameDisplayName タスク マネージャーに表示されるタスクの名前。The name of the task that appears in Task Manager. この文字列は、ms-resource を使用してローカライズできます。You can localize this string by using ms-resource.

Example

<Package
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <desktop:Extension
          Category="windows.startupTask"
          Executable="bin\MyStartupTask.exe"
          EntryPoint="Windows.FullTrustApplication">
        <desktop:StartupTask
          TaskId="MyStartupTask"
          Enabled="true"
          DisplayName="My App Service" />
        </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
 </Package>

ユーザーがデバイスを PC に接続するときにアプリケーションを起動できるようにするEnable users to start your application when they connect a device to their PC

自動再生では、ユーザーがデバイスを PC に接続するときに、アプリケーションをオプションとして表示できます。AutoPlay can present your application as an option when a user connects a device to their PC.

XML 名前空間XML namespace

http://schemas.microsoft.com/appx/manifest/desktop/windows10/3

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.autoPlayHandler">
  <AutoPlayHandler>
    <InvokeAction ActionDisplayName="[action string]" ProviderDisplayName="[name of your app/service]">
      <Content ContentEvent="[Content event]" Verb="[any string]" DropTargetHandler="[Clsid]" />
      <Content ContentEvent="[Content event]" Verb="[any string]" Parameters="[Initialization parameter]"/>
      <Device DeviceEvent="[Device event]" HWEventHandler="[Clsid]" InitCmdLine="[Initialization parameter]"/>
    </InvokeAction>
  </AutoPlayHandler>
名前Name 説明Description
カテゴリCategory 常に windows.autoPlayHandler です。Always windows.autoPlayHandler.
ActionDisplayNameActionDisplayName ユーザーが PC に接続したときにデバイスで実行できるアクションを表す文字列 (例: "ファイルのインポート" や "ビデオの再生")。A string that represents the action that users can take with a device that they connect to a PC (For example: "Import files", or "Play video").
ProviderDisplayNameProviderDisplayName アプリケーションまたはサービスを表す文字列 (例: "Contoso video player")。A string that represents your application or service (For example: "Contoso video player").
ContentEventContentEvent ユーザーに ActionDisplayNameProviderDisplayName をプロンプト表示する原因となるコンテンツ イベントの名前。The name of a content event that causes users to be prompted with your ActionDisplayName and ProviderDisplayName. コンテンツ イベントは、カメラのメモリ カード、サム ドライブ、DVD などのボリューム デバイスが PC に挿入されたときに発生します。A content event is raised when a volume device such as a camera memory card, thumb drive, or DVD is inserted into the PC. これらのイベントの詳しい一覧については、ここをご覧ください。You can find the full list of those events here.
動詞Verb 動詞の設定は、選択したオプションのアプリケーションに渡される値を識別します。The Verb setting identifies a value that is passed to your application for the selected option. 自動再生のイベントの起動アクションは複数指定できます。また、[動詞] 設定を使って、ユーザーがアプリで選んだアクションを確認できます。You can specify multiple launch actions for an AutoPlay event and use the Verb setting to determine which option a user has selected for your app. アプリに渡される起動イベント引数の verb プロパティを調べることでユーザーが選んだオプションを確認できます。You can tell which option the user selected by checking the verb property of the startup event arguments passed to your app. [動詞] 設定には任意の値を使うことができます。ただし、予約されている open を除きます。You can use any value for the Verb setting except, open, which is reserved.
DropTargetHandlerDropTargetHandler IDropTargetインターフェイスを実装するアプリケーションのクラス ID。The class ID of the application that implements the IDropTarget interface. リムーバブル メディアのファイルは、IDropTarget 実装の Drop メソッドに渡されます。Files from the removable media are passed to the Drop method of your IDropTarget implementation.
パラメーターParameters すべてのコンテンツ イベントで IDropTarget インターフェイスを実装する必要はありません。You don't have to implement the IDropTarget interface for all content events. どのコンテンツ イベントにも、IDropTarget インターフェイスを実装する代わりにコマンド ライン パラメーターを指定することができます。For any of the content events, you could provide command line parameters instead of implementing the IDropTarget interface. これらのイベントについては、自動再生によって、これらのコマンドラインパラメーターを使用してアプリケーションが起動されます。For those events, AutoPlay will start your application by using those command line parameters. アプリの初期化コードでそれらのパラメーターを解析して、自動再生によって起動したかどうかを判断し、カスタム実装を提供することができます。You can parse those parameters in your app's initialization code to determine if it was started by AutoPlay and then provide your custom implementation.
DeviceEventDeviceEvent ユーザーに ActionDisplayNameProviderDisplayName をプロンプト表示する原因となるデバイス イベントの名前。The name of a device event that causes users to be prompted with your ActionDisplayName and ProviderDisplayName. デバイス イベントは、デバイスが PC に接続されると発生します。A device event is raised when a device is connected to the PC. デバイス イベントの先頭は文字列 WPD です。一覧についてはここをご覧ください。Device events begin with the string WPD and you can find them listed here.
HWEventHandlerHWEventHandler IHWEventHandlerインターフェイスを実装するアプリケーションのクラス ID。The Class ID of the application that implements the IHWEventHandler interface.
InitCmdLineInitCmdLine IHWEventHandler インターフェイスの Initialize メソッドに渡す文字列パラメーター。The string parameter that you want to pass into the Initialize method of the IHWEventHandler interface.

Example

<Package
  xmlns:desktop3="http://schemas.microsoft.com/appx/manifest/desktop/windows10/3"
  IgnorableNamespaces="desktop3">
  <Applications>
    <Application>
      <Extensions>
        <desktop3:Extension Category="windows.autoPlayHandler">
          <desktop3:AutoPlayHandler>
            <desktop3:InvokeAction ActionDisplayName="Import my files" ProviderDisplayName="ms-resource:AutoPlayDisplayName">
              <desktop3:Content ContentEvent="ShowPicturesOnArrival" Verb="show" DropTargetHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8"/>
              <desktop3:Content ContentEvent="PlayVideoFilesOnArrival" Verb="play" Parameters="%1" />
              <desktop3:Device DeviceEvent="WPD\ImageSource" HWEventHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8" InitCmdLine="/autoplay"/>
            </desktop3:InvokeAction>
          </desktop3:AutoPlayHandler>
      </Extensions>
    </Application>
  </Applications>
</Package>

Microsoft Store から更新プログラムを受信した後、自動的に再起動するRestart automatically after receiving an update from the Microsoft Store

ユーザーがアプリケーションに更新プログラムをインストールしたときにアプリケーションが開いている場合は、アプリケーションが閉じられます。If your application is open when users install an update to it, the application closes.

更新の完了後にアプリケーションを再起動する場合は、再起動するすべてのプロセスでRegisterapplicationrestart関数を呼び出します。If you want that application to restart after the update completes, call the RegisterApplicationRestart function in every process that you want to restart.

アプリケーション内の各アクティブなウィンドウは、 WM_QUERYENDSESSIONメッセージを受信します。Each active window in your application receives a WM_QUERYENDSESSION message. この時点で、アプリケーションはRegisterapplicationrestart関数を再度呼び出して、必要に応じてコマンドラインを更新できます。At this point, your application can call the RegisterApplicationRestart function again to update the command line if necessary.

アプリケーション内の各アクティブウィンドウがWM_ENDSESSIONメッセージを受信すると、アプリケーションはデータを保存してシャットダウンする必要があります。When each active window in your application receives the WM_ENDSESSION message, your application should save data and shut down.

注意

アプリケーションがWM_ENDSESSIONメッセージを処理しない場合にも、アクティブなウィンドウにはWM_CLOSEメッセージが表示されます。Your active windows also receive the WM_CLOSE message in case the application doesn't handle the WM_ENDSESSION message.

この時点で、アプリケーションは独自のプロセスを終了するまで30秒かかります。または、プラットフォームによって強制終了されます。At this point, your application has 30 seconds to close it's own processes or the platform terminates them forcefully.

更新が完了すると、アプリケーションが再起動します。After the update is complete, your application restarts.

他のアプリケーションと連携するWork with other applications

他のアプリとの統合、他のプロセスの開始、情報の共有が可能です。Integrate with other apps, start other processes or share information.

印刷をサポートするアプリケーションで、アプリケーションが印刷ターゲットとして表示されるようにするMake your application appear as the print target in applications that support printing

ユーザーがメモ帳などの別のアプリケーションからデータを印刷する場合は、アプリの使用可能な印刷ターゲットの一覧に印刷ターゲットとしてアプリケーションを表示させることができます。When users want to print data from another application such as Notepad, you can make your application appear as a print target in the app's list of available print targets.

XML Paper Specification (XPS) 形式で印刷データを受信するようにアプリケーションを変更する必要があります。You'll have to modify your application so that it receives print data in XML Paper Specification (XPS) format.

XML 名前空間XML namespaces

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.appPrinter">
    <AppPrinter
        DisplayName="[DisplayName]"
        Parameters="[Parameters]" />
</Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.appPrinter です。Always windows.appPrinter.
DisplayNameDisplayName アプリの印刷先一覧に表示する名前。The name that you want to appear in the list of print targets for an app.
パラメーターParameters 要求を適切に処理するためにアプリケーションで必要なすべてのパラメーター。Any parameters that your application requires to properly handle the request.

Example

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Applications>
  <Application>
    <Extensions>
      <desktop2:Extension Category="windows.appPrinter">
        <desktop2:AppPrinter
          DisplayName="Send to Contoso"
          Parameters="/insertdoc %1" />
      </desktop2:Extension>
    </Extensions>
  </Application>
</Applications>
</Package>

この拡張機能を使用するサンプルについては、こちらをご覧ください。Find a sample that uses this extension Here

他の Windows アプリケーションとフォントを共有するShare fonts with other Windows applications

他の Windows アプリケーションとカスタム フォントを共有できます。Share your custom fonts with other Windows applications.

XML 名前空間XML namespaces

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.sharedFonts">
    <SharedFonts>
      <Font File="[FontFile]" />
    </SharedFonts>
  </Extension>

完全なスキーマ リファレンスについては、こちらをご覧ください。Find the complete schema reference here.

名前Name 説明Description
カテゴリCategory 常に windows.sharedFonts です。Always windows.sharedFonts.
ファイルFile 共有するフォントが格納されたファイル。The file that contains the fonts that you want to share.

Example

<Package
  xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
  IgnorableNamespaces="uap4">
  <Applications>
    <Application>
      <Extensions>
        <uap4:Extension Category="windows.sharedFonts">
          <uap4:SharedFonts>
            <uap4:Font File="Fonts\JustRealize.ttf" />
            <uap4:Font File="Fonts\JustRealizeBold.ttf" />
          </uap4:SharedFonts>
        </uap4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

ユニバーサル Windows プラットフォーム (UWP) アプリから Win32 プロセスを開始するStart a Win32 process from a Universal Windows Platform (UWP) app

完全信頼で実行される Win32 プロセスを開始します。Start a Win32 process that runs in full-trust.

XML 名前空間XML namespaces

http://schemas.microsoft.com/appx/manifest/desktop/windows10

この拡張機能の要素と属性Elements and attributes of this extension

<Extension Category="windows.fullTrustProcess" Executable="[executable file]">
  <FullTrustProcess>
    <ParameterGroup GroupId="[GroupID]" Parameters="[Parameters]"/>
  </FullTrustProcess>
</Extension>
名前Name 説明Description
カテゴリCategory 常に windows.fullTrustProcess です。Always windows.fullTrustProcess.
GroupIDGroupID 実行可能ファイルに渡すパラメーターのセットを識別するための文字列。A string that identifies a set of parameters that you want to pass to the executable.
パラメーターParameters 実行可能ファイルに渡すパラメーター。Parameters that you want to pass to the executable.

Example

<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:rescap=
"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
         xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10">
  ...
  <Capabilities>
      <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    <Application>
      <Extensions>
          <desktop:Extension Category="windows.fullTrustProcess" Executable="fulltrustprocess.exe">
              <desktop:FullTrustProcess>
                  <desktop:ParameterGroup GroupId="SyncGroup" Parameters="/Sync"/>
                  <desktop:ParameterGroup GroupId="OtherGroup" Parameters="/Other"/>
              </desktop:FullTrustProcess>
           </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

この拡張機能は、すべてのデバイスで実行されるユニバーサル Windows プラットフォームユーザーインターフェイスを作成するが、Win32 アプリケーションのコンポーネントを完全に信頼したまま実行する必要がある場合に便利です。This extension might be useful if you want to create a Universal Windows Platform User interface that runs on all devices, but you want components of your Win32 application to continue running in full-trust.

Win32 アプリの Windows アプリケーションパッケージを作成するだけです。Just create a Windows app package for your Win32 app. そのうえで、この拡張機能を UWP アプリのパッケージ ファイルに追加してください。Then, add this extension to the package file of your UWP app. この拡張機能は、Windows アプリケーションパッケージで実行可能ファイルを開始することを示します。This extensions indicates that you want to start an executable file in the Windows app package. UWP アプリと Win32 アプリの間でやり取りを行うには、1 つまたは複数のアプリ サービスを設定します。If you want to communicate between your UWP app and your Win32 app, you can set up one or more app services to do that. このシナリオについては詳しくは、こちらをご覧ください。You can read more about this scenario here.

次のステップNext steps

質問に対する回答を検索するFind answers to your questions

ご質問がある場合は、Have questions? Stack Overflow でお問い合わせください。Ask us on Stack Overflow. Microsoft のチームでは、これらのタグをチェックしています。Our team monitors these tags. こちらから質問することもできます。You can also ask us here.

フィードバックの提供または機能に関する提案Give feedback or make feature suggestions

UserVoice のページをご覧ください。See UserVoice.