ActivationKind

October 30, 2025 · View on GitHub

-description

Specifies the type of activation.

-enum-fields

-field Launch:0

The user launched the app or tapped a content tile.

-field Search:1

The user wants to search with the app.

-field ShareTarget:2

The app is activated as a target for share operations.

-field File:3

An app launched a file whose file type this app is registered to handle.

-field Protocol:4

An app launched a URI whose scheme name this app is registered to handle.

-field FileOpenPicker:5

The user wants to pick files that are provided by the app.

-field FileSavePicker:6

The user wants to save a file and selected the app as the location.

-field CachedFileUpdater:7

The user wants to save a file that the app provides content management for.

-field ContactPicker:8

The user wants to pick contacts.

-field Device:9

The app handles AutoPlay.

-field PrintTaskSettings:10

The app handles print tasks.

-field CameraSettings:11

The app captures photos or video from an attached camera.

-field RestrictedLaunch:12

Windows Store only. The user launched the restricted app.

-field AppointmentsProvider:13

The user wants to manage appointments that are provided by the app.

-field Contact:14

Windows Store only. The user wants to handle calls or messages for the phone number of a contact that is provided by the app.

-field LockScreenCall:15

Windows Store only. The app launches a call from the lock screen. If the user wants to accept the call, the app displays its call UI directly on the lock screen without requiring the user to unlock. A lock-screen call is a special type of launch activation.

-field VoiceCommand:16

The app was activated as the result of a voice command.

Note

Not supported in Windows 8 and Windows 8.1 apps.

-field LockScreen:17

The app was activated as the lock screen. Introduced in Windows 10, version 1507 (10.0.10240).

-field PickerReturned:1000

Windows Phone only. The app was activated after the completion of a picker.

-field WalletAction:1001

Windows Phone only. The app was activated to perform a Wallet operation.

-field PickFileContinuation:1002

Windows Phone only. The app was activated after the app was suspended for a file picker operation.

Note

This value was deprecated in Windows 10, version 2004 (build 19041). The file/folder continuation APIs are no longer relevant with the discontinuation of Windows Phone.

-field PickSaveFileContinuation:1003

Windows Phone only. The app was activated after the app was suspended for a file save picker operation.

Note

This value was deprecated in Windows 10, version 2004 (build 19041). The file/folder continuation APIs are no longer relevant with the discontinuation of Windows Phone.

-field PickFolderContinuation:1004

Windows Phone only. The app was activated after the app was suspended for a folder picker operation.

Note

This value was deprecated in Windows 10, version 2004 (build 19041). The file/folder continuation APIs are no longer relevant with the discontinuation of Windows Phone.

-field WebAuthenticationBrokerContinuation:1005

Windows Phone only. The app was activated after the app was suspended for a web authentication broker operation.

-field WebAccountProvider:1006

The app was activated by a web account provider. Introduced in Windows 10, version 1507 (10.0.10240).

-field ComponentUI:1007

Reserved for system use. Introduced in Windows 10, version 1507 (10.0.10240).

-field ProtocolForResults:1009

The app was launched by another app with the expectation that it will return a result back to the caller. Introduced in Windows 10, version 1507 (10.0.10240).

-field ToastNotification:1010

The app was activated when a user tapped on the body of a toast notification or performed an action inside a toast notification. Introduced in Windows 10, version 1507 (10.0.10240).

-field Print3DWorkflow:1011

This app was launched by another app to provide a customized printing experience for a 3D printer. Introduced in Windows 10, version 1507 (10.0.10240).

-field DialReceiver:1012

This app was launched by another app on a different device by using the DIAL protocol. Introduced in Windows 10, version 1507 (10.0.10240).

-field DevicePairing:1013

This app was activated as a result of pairing a device.

-field UserDataAccountsProvider:1014

The app was launched to handle the user interface for account management. In circumstances where the system would have shown the default system user interface, it instead has invoked your app with the UserDataAccountProvider contract. The activation payload contains information about the type of operation being requested and all the information necessary to replicate the system-provided user interface. This activation kind is limited to 1st party apps. To use this field, you must add the userDataAccountsProvider capability in your app's package manifest. For more info see App capability declarations. Introduced in Windows 10, version 1607 (10.0.14393).

-field FilePickerExperience:1015

Reserved for system use. Introduced in Windows 10, version 1607 (10.0.14393).

-field ContactPanel:1017

The app was launched from the My People UI. Note: introduced in Windows 10, version 1703 (10.0.15063), but not used. Now used starting with Windows 10, version 1709 (10.0.16299).

-field LockScreenComponent:1016

Reserved for system use. Introduced in Windows 10, version 1703 (10.0.15063).

-field PrintWorkflowForegroundTask:1018

The app was activated because the user is printing to a printer that has a Print Workflow Application associated with it which has requested user input.

-field GameUIProvider:1019

The app was activated because it was launched by the OS due to a request for game-specific UI. Introduced in Windows 10, version 1703 (10.0.15063).

-field StartupTask:1020

The app was activated because the app is specified to launch at system startup or user log-in. Introduced in Windows 10, version 1703 (10.0.15063).

-field CommandLineLaunch:1021

The app was launched from the command line. Introduced in Windows 10, version 1709 (10.0.16299)

-field BarcodeScannerProvider:1022

The app was activated as a barcode scanner provider.

-field PrintSupportJobUI: 1023

The app was activated as a print support settings UI extension. For more information, see For more information, see PrintWorkflowJobUISession.

-field PrintSupportSettingsUI: 1024

The app was activated as a print workflow job UI extension. For more information, see PrintSupportSettingsUISession.

-field PhoneCallActivation: 1025

The app was activated in response to a phone call.

-field VpnForeground: 1026

The app is a VPN foreground app that was activated by the plugin. For more details, see VpnChannel.ActivateForeground.

-field PrintSupportEnterpriseManagementUI: 1027

The app is a print support app that was activated by the Print Management Console.

-remarks

Values are mutually exclusive and cannot be combined. Each one relates to a different type of activation, and an app instance can be activated in only one way at a time.

For more information about app activation, see the remarks on the Application.OnActivated(IActivatedEventArgs) page.

Version history

Windows versionSDK versionValue added
151110586DevicePairing
151110586Print3DWorkflow
160714393FilePickerExperience
160714393UserDataAccountsProvider
170315063ContactPanel
170315063LockScreenComponent
170916299CommandLineLaunch
170916299GameUIProvider
170916299PrintWorkflowForegroundTask
170916299StartupTask
180317134BarcodeScannerProvider

-examples

-see-also

CachedFileUpdaterActivatedEventArgs.Kind, CameraSettingsActivatedEventArgs.Kind, ContactPickerActivatedEventArgs.Kind, DeviceActivatedEventArgs.Kind, FileActivatedEventArgs.Kind, FileOpenPickerActivatedEventArgs.Kind, FileSavePickerActivatedEventArgs.Kind, LaunchActivatedEventArgs.Kind, LockScreenActivatedEventsArg.Kind, PrintTaskSettingsActivatedEventArgs.Kind, ProtocolActivatedEventArgs.Kind, SearchActivatedEventArgs.Kind, ShareTargetActivatedEventArgs.Kind, WebUICachedFileUpdaterActivatedEventArgs.Kind, WebUICameraSettingsActivatedEventArgs.Kind, WebUIContactPickerActivatedEventArgs.Kind, WebUIDeviceActivatedEventArgs.Kind, WebUIFileActivatedEventArgs.Kind, WebUIFileOpenPickerActivatedEventArgs.Kind, WebUIFileSavePickerActivatedEventArgs.Kind, WebUILaunchActivatedEventArgs.Kind, WebUIPrintTaskSettingsActivatedEventArgs.Kind, WebUIProtocolActivatedEventArgs.Kind, WebUISearchActivatedEventArgs.Kind, WebUIShareTargetActivatedEventArgs.Kind