AppExtensionCatalog.PackageInstalled イベント

定義

名前空間:

Windows.ApplicationModel.AppExtensions

拡張機能パッケージのインストール時に発生するイベント。

// Register
event_token PackageInstalled(TypedEventHandler<AppExtensionCatalog, AppExtensionPackageInstalledEventArgs const&> const& handler) const;

// Revoke with event_token
void PackageInstalled(event_token const* cookie) const;

// Revoke with event_revoker
AppExtensionCatalog::PackageInstalled_revoker PackageInstalled(auto_revoke_t, TypedEventHandler<AppExtensionCatalog, AppExtensionPackageInstalledEventArgs const&> const& handler) const;

public event TypedEventHandler<AppExtensionCatalog,AppExtensionPackageInstalledEventArgs> PackageInstalled;

function onPackageInstalled(eventArgs) { /* Your code */ }
appExtensionCatalog.addEventListener("packageinstalled", onPackageInstalled);
appExtensionCatalog.removeEventListener("packageinstalled", onPackageInstalled);
- or -
appExtensionCatalog.onpackageinstalled = onPackageInstalled;

Public Custom Event PackageInstalled As TypedEventHandler(Of AppExtensionCatalog, AppExtensionPackageInstalledEventArgs) 

イベントの種類

TypedEventHandler<AppExtensionCatalog,AppExtensionPackageInstalledEventArgs>

注釈

イベント引数 AppExtensionPackageInstalledEventArgs.Extensions には、拡張機能パッケージ内の拡張機能の一覧が含まれています。

拡張機能のスコープは、拡張機能の Package.appxmanifest ファイルで定義されている <uap3:AppExtension Name=...> です。 拡張機能の一覧には、ホストの Package.appxmanifest ファイルで定義されている と一致 <uap3:AppExtension Name=...> する拡張機能のみが含まれます。

このイベントのイベント ハンドラーは、各アプリ拡張機能の正確性を調べ、それを使用するオプションをユーザーに提供するのに適しています。

AppExtension のデプロイの単位は Package です。 そのため、これは Package インストール イベントであり、 AppExtension インストール イベントではありません。

通常、パッケージには 1 つの拡張機能のみが含まれます。 ただし、パッケージ内に複数の拡張機能がある場合に対処する準備をしてください。

AppExtension.Id を使用して、同じパッケージ内の拡張機能を区別します。 アプリ内の拡張機能を一意に識別するには、 AppInfo.AppUserModelId と AppExtension.Id を連結することを検討してください。

_uniqueId = yourAppExtention.AppInfo.AppUserModelId + "!" + yourAppExtention.Id;

これにより、各 AppExtension には、アプリで追跡するために使用できる一意の名前が含まれている必要があります。 これを AppExtension の キーとして使用することをお勧めします。これにより、特定の AppExtension が既に知っているものであるかどうかを効率的かつ正しく識別できます。