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事件引數包含擴充功能套件內的延伸模組清單。

延伸模組的範圍是由 <uap3:AppExtension Name=...> 延伸模組 Package.appxmanifest 檔案中所定義的 範圍。 只有符合 <uap3:AppExtension Name=...> 主機 Package.appxmanifest 檔案中所定義之 的擴充功能會位於延伸模組清單中。

此事件的事件處理常式是檢查每個應用程式延伸模組的正確性，並提供使用者使用選項的好位置。

AppExtension的部署單位是套件。 這就是為什麼這是 套件 安裝事件，而不是 AppExtension 安裝事件。

一般而言，套件中只會有一個擴充功能。 不過，請準備好處理套件中有多個延伸模組的情況。

使用 AppExtension.Id 來區別相同套件中的延伸模組。 若要在應用程式中唯一識別延伸模組，請考慮串連 AppInfo.AppUserModelId 和 AppExtension.Id：

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

這可確保每個 AppExtension 都有一個唯一的名稱，可供您在應用程式中用來追蹤它。 建議您將此作為 AppExtensions 的 索引鍵，以便有效率且正確地識別指定的 AppExtension 是否是您已經知道的 AppExtension 。