Specifies the execution state of the app.
Syntax
public enum ApplicationExecutionState
Attributes
- VersionAttribute(NTDDI_WIN8)
Members
The ApplicationExecutionState enumeration has these members.
| Member | Value | Description |
|---|---|---|
| NotRunning | notRunning | 0 |
The app is not running. |
| Running | running | 1 |
The app is running. |
| Suspended | suspended | 2 |
The app is suspended. |
| Terminated | terminated | 3 |
The app was terminated after being suspended. |
| ClosedByUser | closedByUser | 4 |
The app was closed by the user. |
Remarks
This table provides more detail about when you'll see each of these states and what your app should do in response.
| State | When this state is seen | What your app should do |
|---|---|---|
| NotRunning |
The user first activates the app after:
The user closes the app through the close gesture or Alt+F4 and activates it within about 10 seconds of closing it. | Display its initial UI and perform initialization tasks. |
| Running |
The app is activated through a secondary tile or one of the activation contracts and extensions while it is running. | Respond to the activation event as appropriate. |
| Suspended |
The app is activated through a secondary tile or one of the activation contracts and extensions while Windows is suspending it or after Windows has suspended it. | Respond to the activation event as appropriate. |
| Terminated |
Windows successfully suspends the app and then it is terminated. For example, Windows can terminate a suspended app if the system is running low on resources. Some apps, such as games, can be pretty resource intensive. | Restore itself to the way the user left it, rather than starting fresh. Use data saved during app suspension. Refresh content or network connections that may have become stale. |
| ClosedByUser |
The user closes the app through the close gesture or Alt+F4 and takes longer than 10 seconds to activate the app again. | Display its initial UI and perform initialization tasks, rather than restoring its previous state. |
Windows Phone 8
On Windows Phone, only NotRunning and Suspended are supported.
Requirements
|
Minimum supported client | Windows 8 |
|---|---|
|
Minimum supported server | Windows Server 2012 |
|
Minimum supported phone | Windows Phone 8 |
|
Namespace |
|
|
Metadata |
|
See also
- Concepts
- Application lifecycle
- Guidelines for app suspend and resume
- Reference (C#/VB/C++)
- CachedFileUpdaterActivatedEventArgs.PreviousExecutionState
- CameraSettingsActivatedEventArgs.PreviousExecutionState
- ContactPickerActivatedEventArgs.PreviousExecutionState
- DeviceActivatedEventArgs.PreviousExecutionState
- FileActivatedEventArgs.PreviousExecutionState
- FileOpenPickerActivatedEventArgs.PreviousExecutionState
- FileSavePickerActivatedEventArgs.PreviousExecutionState
- LaunchActivatedEventArgs.PreviousExecutionState
- PrintTaskSettingsActivatedEventArgs.PreviousExecutionState
- ProtocolActivatedEventArgs.PreviousExecutionState
- SearchActivatedEventArgs.PreviousExecutionState
- ShareTargetActivatedEventArgs.PreviousExecutionState
- Reference (JavaScript)
- WebUICachedFileUpdaterActivatedEventArgs.previousExecutionState
- WebUICameraSettingsActivatedEventArgs.previousExecutionState
- WebUIContactPickerActivatedEventArgs.previousExecutionState
- WebUIDeviceActivatedEventArgs.previousExecutionState
- WebUIFileActivatedEventArgs.previousExecutionState
- WebUIFileOpenPickerActivatedEventArgs.previousExecutionState
- WebUIFileSavePickerActivatedEventArgs.previousExecutionState
- WebUILaunchActivatedEventArgs.previousExecutionState
- WebUIPrintTaskSettingsActivatedEventArgs.previousExecutionState
- WebUIProtocolActivatedEventArgs.previousExecutionState
- WebUISearchActivatedEventArgs.previousExecutionState
- WebUIShareTargetActivatedEventArgs.previousExecutionState
Build date: 2/25/2013
