PackageExtensionCatalog.PackageInstalled 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
安裝擴充功能套件時引發的事件。
// Register
event_token PackageInstalled(TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs const&> const& handler) const;
// Revoke with event_token
void PackageInstalled(event_token const* cookie) const;
// Revoke with event_revoker
PackageExtensionCatalog::PackageInstalled_revoker PackageInstalled(auto_revoke_t, TypedEventHandler<PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs const&> const& handler) const;
public event TypedEventHandler<PackageExtensionCatalog,PackageExtensionPackageInstalledEventArgs> PackageInstalled;
function onPackageInstalled(eventArgs) { /* Your code */ }
packageExtensionCatalog.addEventListener("packageinstalled", onPackageInstalled);
packageExtensionCatalog.removeEventListener("packageinstalled", onPackageInstalled);
- or -
packageExtensionCatalog.onpackageinstalled = onPackageInstalled;
Public Custom Event PackageInstalled As TypedEventHandler(Of PackageExtensionCatalog, PackageExtensionPackageInstalledEventArgs)
事件類型
備註
PackageExtensionPackageInstalledEventArgs.Extensions事件引數包含擴充功能套件內的延伸模組清單。
延伸模組的範圍是由 <uap17:PackageExtension Name=...>
延伸模組 Package.appxmanifest 檔案中所定義的 範圍。 只有符合 <uap17:PackageExtension Name=...>
主機 Package.appxmanifest 檔案中所定義之 的擴充功能會位於延伸模組清單中。
此事件的事件處理常式是檢查每個套件延伸模組的正確性,並提供使用者使用選項的好位置。
PackageExtension的部署單位是套件。 這就是為什麼這是 套件 安裝事件,而不是 PackageExtension 安裝事件。
一般而言,套件中只會有一個擴充功能。 不過,請準備好處理套件中有多個延伸模組的情況。
使用 PackageExtension.Id 來區別相同套件中的延伸模組。 若要唯一識別套件中的延伸模組,請考慮串連 Package.Id 和 PackageExtension.Id:
_uniqueId = yourPackageExtension.Package.Id + "|" + yourPackageExtension.Id;
這可確保每個 PackageExtension 都有可用來追蹤它的唯一名稱。 建議您將此作為 PackageExtensions 的 索引鍵,以便有效率且正確地識別指定的 PackageExtension 是否為您已經知道的套件。