AppExtensionCatalog.PackageInstalled Событие

Определение

Событие, возникающее при установке пакета расширения.

// 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) 

Тип события

Комментарии

Аргумент события 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 тем, о чем вы уже знаете.

Применяется к