void DeviceSetBatteryMonitoring(int flag);
Turns monitoring for the battery state / level on or off.
Return Value
Returns a non-zero value if the call was successful, zero otherwise.
Parameters
flag Specifies whether battery monitoring should be on or off (0 = off, 1 = on).
Remarks
DeviceSetBatteryMonitoring() turns battery monitoring on or off. If you have checked the battery level or state using either DeviceGetBatteryLevel() or DeviceGetBatteryState(), then this function would have been called implicitly for you if battery monitoring was not on previously.
NOTE: If your application no longer needs information about the battery, it is a good idea to turn off battery monitoring.
Availability
Available in DragonFireSDK 1.4 and later.
Example
#include "DragonFireSDK.h"
int MyFont; int BatteryLevelText; int BatteryStateText;
int Value; char TextBuffer[100];
void GetBatteryStateText() { Value = DeviceGetBatteryState(); switch (Value) { case 0: sprintf(TextBuffer, "Battery State: Unknown"); break;
case 1: sprintf(TextBuffer, "Battery State: Unplugged"); break;
case 2: sprintf(TextBuffer, "Battery State: Charging"); break;
case 3: sprintf(TextBuffer, "Battery State: Full"); break;
default: sprintf(TextBuffer, "Battery State: Unknown"); break; } }
void AppMain() { LandscapeMode();
DeviceSetBatteryMonitoring(1); MyFont = FontAdd("Helvetica", "Regular", 18, 0x00FF00);
Value = DeviceGetBatteryLevel(); sprintf(TextBuffer, "Battery Level: %d", Value); BatteryLevelText = TextAdd(10, 10, TextBuffer, MyFont);
GetBatteryStateText(); BatteryStateText = TextAdd(10, 40, TextBuffer, MyFont); }
//=============================================== void OnTimer() { Value = DeviceGetBatteryLevel(); sprintf(TextBuffer, "Battery Level: %d", Value); TextSetText(BatteryLevelText, TextBuffer);
GetBatteryStateText(); TextSetText(BatteryStateText, TextBuffer); }
//=============================================== void AppExit() {
} |