Socket ScanAPI Reference Manual page 67

Socket ScanAPI Reference
Java:
The helper macro can be found in com.SocketMobile.ScanAPI.SktScan.helper.
C#:
The helper macro can be found in ScanAPI.SktScan.helper.
Objective C:
The helper macro can be found in the SktScanPropIds.h file.
Event Data Type: kSktScanEventDataTypeByte.
See also:
Property kSktScanPropIdButtonStatusDevice
11.6.4 Error Event
This event occurs each time there is an error, usually during communication with
the device. The error code can be retrieve in the Result field of the message
structure.
Event Data Type: kSktScanEventDataTypeNone or kSktScanEventDataTypeString.
In the case of a String data type, the Event String data contains more information
about the error. For example, it might contain the communication port name that is
reporting an error.
11.6.5 Battery Level Event
The Battery Level Event is received when the device has a change regarding its
battery level. This allows the application UI to display an alert if the battery level
gets low.
The Battery Level Event is not activated by default. The device notification must be
modified in order to turn on this notification. This is accomplished by using the
property kSktScanPropIdNotificationDevice.
The device must be opened in order to receive this event.
The power information is coded in a Ulong that can be decomposed into three fields
from the most significant byte to the less significant:
Byte 3
Battery Level Max
A set of macros is defined in order to retrieve these values.
© 2013 Socket Mobile, Inc.
Byte 2
Battery Level Min
Byte 1
Battery Level
Byte 0
-reserved-
67/152