Windows Dev Center

SystemTriggerType enumeration

Specifies the system events that can be used to trigger a background task.

Syntax


var value = Windows.ApplicationModel.Background.SystemTriggerType.invalid;

Members

The SystemTriggerType enumeration has these members.

MemberValueDescription
Invalid | invalid0

Not a valid trigger type.

SmsReceived | smsReceived1

The background task is triggered when a new SMS message is received by an installed mobile broadband device.

UserPresent | userPresent2

The background task is triggered when the user becomes present.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and Windows Phone 8.1:  An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

UserAway | userAway3

The background task is triggered when the user becomes absent.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and Windows Phone 8.1:  An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

NetworkStateChange | networkStateChange4

The background task is triggered when a network change occurs, such as a change in cost or connectivity.

ControlChannelReset | controlChannelReset5

The background task is triggered when a control channel is reset.

Note  This trigger type does not support a OneShot mode. So the OneShot parameter must be false when using the SystemTrigger constructor.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and Windows Phone 8.1:  An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

InternetAvailable | internetAvailable6

The background task is triggered when the Internet becomes available.

SessionConnected | sessionConnected7

The background task is triggered when the session is connected.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and Windows Phone 8.1:  An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

ServicingComplete | servicingComplete8

The background task is triggered when the system has finished updating an app.

LockScreenApplicationAdded | lockScreenApplicationAdded9

The background task is triggered when a tile is added to the lock screen.

LockScreenApplicationRemoved | lockScreenApplicationRemoved10

The background task is triggered when a tile is removed from the lock screen.

TimeZoneChange | timeZoneChange11

The background task is triggered when the time zone changes on the device (for example, when the system adjusts the clock for daylight saving time).

Note  This trigger only fires if the new time zone actually changes the system time.
OnlineIdConnectedStateChange | onlineIdConnectedStateChange12

The background task is triggered when the Microsoft account connected to the account changes.

BackgroundWorkCostChange | backgroundWorkCostChange13

The background task is triggered when the cost of background work changes.

Windows 8, Windows Server 2012, Windows 8.1, Windows Server 2012 R2, and Windows Phone 8.1:  An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10 Insider Preview, Windows Server Technical Preview, and Windows 10 Mobile Insider Preview:  You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

PowerStateChange | powerStateChange14

The background task is triggered when the status of the battery, BatteryStatus, changes.

Note  This value was introduced in Windows 10 Insider Preview.

Requirements (Windows 10 device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Namespace

Windows.ApplicationModel.Background
Windows::ApplicationModel::Background [C++]

Metadata

Windows.winmd

Attributes

[Version(0x06020000)]

See also

SystemTrigger.TriggerType

 

 

Show:
© 2015 Microsoft