ForegroundEnergyManager ForegroundEnergyManager ForegroundEnergyManager ForegroundEnergyManager ForegroundEnergyManager Class

Definition

Provides information about your app's foreground energy usage.

public : static class ForegroundEnergyManager
static struct winrt::Windows::System::Power::ForegroundEnergyManager
public static class ForegroundEnergyManager
Public Shared Class ForegroundEnergyManager
// This class does not provide a public constructor.
Attributes

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

The energy usage of a foreground app is classified into one these predefined levels, from lowest to highest energy consumption: LowUsageLevel, NearMaxAcceptableUsageLevel, MaxAcceptableUsageLevel, or ExcessiveUsageLevel.

Properties

ExcessiveUsageLevel ExcessiveUsageLevel ExcessiveUsageLevel ExcessiveUsageLevel ExcessiveUsageLevel

Gets the excessive usage level, expressed as a percentage of normal energy usage.

LowUsageLevel LowUsageLevel LowUsageLevel LowUsageLevel LowUsageLevel

Gets the low usage level, expressed as a percentage of normal energy consumption.

MaxAcceptableUsageLevel MaxAcceptableUsageLevel MaxAcceptableUsageLevel MaxAcceptableUsageLevel MaxAcceptableUsageLevel

Gets the maximum acceptable usage level, expressed as a percentage of normal energy consumption.

NearMaxAcceptableUsageLevel NearMaxAcceptableUsageLevel NearMaxAcceptableUsageLevel NearMaxAcceptableUsageLevel NearMaxAcceptableUsageLevel

Gets the near-maximum acceptable usage level, expressed as a percentage of normal energy usage.

RecentEnergyUsage RecentEnergyUsage RecentEnergyUsage RecentEnergyUsage RecentEnergyUsage

Gets the nearest predefined energy level of the foreground app for the current 30 minute period, equal to LowUsageLevel, NearMaxAcceptableUsageLevel, MaxAcceptableUsageLevel, or ExcessiveUsageLevel.

RecentEnergyUsageLevel RecentEnergyUsageLevel RecentEnergyUsageLevel RecentEnergyUsageLevel RecentEnergyUsageLevel

Gets the nearest predefined energy level of the foreground app for the current 30 minute period, equal to LowUsageLevel, NearMaxAcceptableUsageLevel, MaxAcceptableUsageLevel, or ExcessiveUsageLevel.

Events

RecentEnergyUsageIncreased RecentEnergyUsageIncreased RecentEnergyUsageIncreased RecentEnergyUsageIncreased RecentEnergyUsageIncreased

Occurs when the app's foreground energy usage has increased significantly.

RecentEnergyUsageReturnedToLow RecentEnergyUsageReturnedToLow RecentEnergyUsageReturnedToLow RecentEnergyUsageReturnedToLow RecentEnergyUsageReturnedToLow

Occurs when the app's energy usage has decreased to a low usage level.