In The Hand LtdIn The Hand
SystemState Class
NamespacesInTheHand.WindowsMobile.StatusSystemState
.NET Components for Mobility
Gives the ability to get the current value of a system state.
Declaration Syntax
C#Visual Basic
public sealed class SystemState : StateBase, 
	IDisposable
Public NotInheritable Class SystemState _
	Inherits StateBase _
	Implements IDisposable
Members
All MembersConstructorsMethodsPropertiesEvents



IconMemberDescription
SystemState(SystemProperty)
Constructs a SystemState object that gives read-only access to the property.

SystemState(String)
Load the settings for a SystemState that has had the Application Launcher enabled.

SystemState(SystemProperty, Boolean)
Constructs a SystemState object that gives read-only access to the property.

SystemState(String, Boolean)
Load the settings for a SystemState that has had the Application Launcher enabled.

ActiveApplication
Gets the name of the application that was previously active and the name of the application that is currently active, separated by the 'Escape' character ('\e').

ActiveSyncStatus
Gets ActiveSync's current synchronization state.

ApplicationArguments
Arguments passed to the application if application launcher is enabled
(Overrides StateBase.ApplicationArguments.)
ApplicationLaunchId
Unique id for the SystemState.
(Overrides StateBase.ApplicationLaunchId.)
ApplicationToLaunch
Application to launch if application launcher is enabled.
(Overrides StateBase.ApplicationToLaunch.)
BitMask
Not Supported.
(Overrides StateBase.BitMask.)
BluetoothStateA2DPConnected
Gets a value indicating whether Bluetooth A2DP (Wireless Stereo) is connected.

BluetoothStateDiscoverable
Gets a value indicating whether Bluetooth is in Discoverable mode.

BluetoothStateHandsFreeAudio
Gets a value indicating whether Bluetooth Handsfree audio is active.

BluetoothStateHandsFreeControl
Gets a value indicating whether Bluetooth Hands Free control is active.

BluetoothStateHardwarePresent
Gets a value indicating whether Bluetooth hardware is present.

BluetoothStatePowerOn
Gets a value indicating whether Bluetooth is powered on.

CalendarAppointment
Gets the current Appointment.

CalendarAppointmentBusyStatus
Gets the user's availability (free/busy status) for the time-slot taken by the current Appointment.

CalendarAppointmentCategories
Gets the current Appointment's categories.

CalendarAppointmentEndTime
Gets the current Appointment's ending time.

CalendarAppointmentHasConflict
Gets a value indicating whether the current Appointment has a scheduling conflict with an existing Appointment.

CalendarAppointmentLocation
Gets the current Appointment's location.

CalendarAppointmentStartTime
Gets the current Appointment's starting time.

CalendarAppointmentSubject
Gets the current Appointment's subject.

CalendarEvent
Gets the current "All Day Event" Appointment.

CalendarEventBusyStatus
Gets the user's availability (free/busy status) for the current "All Day Event".

CalendarEventCategories
Gets the categories for the current "All Day Event".

CalendarEventEndTime
Gets the ending time of the current "All Day Event" Appointment. This will be the ending day of an Appointment Event that spans multiple days.

CalendarEventHasConflict
Gets a value indicating whether the user's availability (free/busy) status conflicts with the current "All Day Event".

CalendarEventLocation
Gets the location of the current "All Day Event" Appointment.

CalendarEventStartTime
Gets the starting time of the current "All Day Event" Appointment. This will be the starting day of an Appointment Event that spans multiple days.

CalendarEventSubject
Gets the subject of the current "All Day Event" Appointment.

CalendarHomeScreenAppointment
Gets the Appointment that is currently displayed on the Home Screen.

CalendarHomeScreenAppointmentBusyStatus
Gets the user's availability (free/busy status) for the Appointment displayed on the Home Screen.

CalendarHomeScreenAppointmentCategories
Gets the categories of the Appointment that is currently displayed on the Home Screen.

CalendarHomeScreenAppointmentEndTime
Gets the ending time of the Appointment that is currently displayed on the Home Screen.

CalendarHomeScreenAppointmentHasConflict
Gets a value indicating whether the Appointment that is currently displayed on the Home Screen has a scheduling conflict.

CalendarHomeScreenAppointmentLocation
Gets the location of the Appointment that is currently displayed on the Home Screen.

CalendarHomeScreenAppointmentStartTime
Gets the starting time of the Appointment that is currently displayed on the Home Screen.

CalendarHomeScreenAppointmentSubject
Gets the subject of the Appointment that is currently displayed on the Home Screen.

CalendarNextAppointment
Gets the next Appointment.

CalendarNextAppointmentBusyStatus
Gets the user's availability (e.g., Free, Busy, Tenative, Out of Office) status for the next Appointment.

CalendarNextAppointmentCategories
Gets the next Appointment's categories.

CalendarNextAppointmentEnd
Gets the ending time of the next Appointment.

CalendarNextAppointmentHasConflict
Gets a value indicating whether there is a conflict with the next Appointment.

CalendarNextAppointmentLocation
Gets the location of the next Appointment.

CalendarNextAppointmentStart
Gets the starting time of the next Appointment.

CalendarNextAppointmentSubject
Gets the subject of the next Appointment.

CallRecordingStartTime
If there is a recording in progress, it returns the UTC time of the start of the recording.

CallRecordingStatus
Specifies if there is an active call recording.

CameraEnabled
Gets a value indicating whether a camera is enabled.

CameraPresent
Gets a value indicating whether a camera is attached.

CarKitPresent
Gets a value indicating whether a car kit is present.

CellularSystemAvailable1xrtt
Gets a value indicating whether 1xRTT is available.

CellularSystemAvailableEdge
Gets a value indicating whether EDGE is available.

CellularSystemAvailableEvdo
Gets a value indicating whether EVDO is available.

CellularSystemAvailableEvdv
Gets a value indicating whether EVDV is available.

CellularSystemAvailableGprs
Gets a value indicating whether GPRS is available.

CellularSystemAvailableHsdpa
Gets a value indicating whether HSDPA is available.

CellularSystemAvailableUmts
Gets a value indicating whether UMTS is available.

CellularSystemConnected1xrtt
Gets a value indicating whether 1xRTT is connected.

CellularSystemConnectedCsd
Gets a value indicating whether CSD is connected.

CellularSystemConnectedEdge
Gets a value indicating whether EDGE is connected.

CellularSystemConnectedEvdo
Gets a value indicating whether EVDO is connected.

CellularSystemConnectedEvdv
Gets a value indicating whether EVDV is connected.

CellularSystemConnectedGprs
Gets a value indicating whether GPRS is connected.

CellularSystemConnectedHsdpa
Gets a value indicating whether HSDPA is connected.

CellularSystemConnectedUmts
Gets a value indicating whether UMTS is connected.

Changed
Event that is raised when the state changes.

ClamshellClosed
Gets a value indicating whether Clamshell is closed or not.

ClockAlarmStatus
Gets the Clock Alarm Status.

ComparisonType
Type of comparison operation to perform if you want your event to be raised only under a specific condition.
(Overrides StateBase.ComparisonType.)
ComparisonValue
The value to compare against.
(Overrides StateBase.ComparisonValue.)
ConnectionsBluetoothCount
Gets a value indicating the number of Bluetooth connections that are currently connected.

ConnectionsBluetoothDescriptions
Gets a semicolon delimited string containing the description of each of the Bluetooth connections.

ConnectionsCellularCount
Gets a value indicating the number of cellular connections that are currently connected.

ConnectionsCellularDescriptions
Gets a semicolon delimited string containing the description of each cellular connection.

ConnectionsCount
Gets a value indicating the number of connections that are currently connected.

ConnectionsDesktopCount
Gets a value indicating the number of desktop connections that are currently connected.

ConnectionsDesktopDescriptions
Gets a semicolon delimited string containing the description of each desktop connection.

ConnectionsModemCount
Gets a value indicating the number of modem connections that are currently connected.

ConnectionsModemDescriptions
Gets a semicolon delimited string containing the description of each modem connection.

ConnectionsNetworkAdapters
Gets a semicolon delimited string containing the adapter name of each network connection.

ConnectionsNetworkCount
Gets a value indicating the number of network connections that are currently connected.

ConnectionsNetworkDescriptions
Gets a semicolon delimited string containing the description of each network connection.

ConnectionsProxyCount
Gets a value indicating the number of network connections that are currently connected.

ConnectionsProxyDescriptions
Gets a semicolon delimited string containing the description of each proxy connection.

ConnectionsUnknownCount
Gets a value indicating the number of connections of unknown type that are currently connected.

ConnectionsUnknownDescriptions
Gets a semicolon delimited string containing the description of each connections of unknown type.

ConnectionsVpnCount
Gets a value indicating the number of virtual private network connections that are currently connected.

ConnectionsVpnDescriptions
Gets a semicolon delimited string containing the description of each virtual private network connection.

CradlePresent
Gets a value indicating whether the device is connected to a cradle.

CurrentValue
The current value of this system property.
(Overrides StateBase.CurrentValue.)
Date
Gets the current date.

DeviceLocked
Determines if the device is currently locked (e.g. with password).

DisableApplicationLauncher()()()()
Disables the Application Launcher for this instance. It will no longer launch the application that it was associated with.
(Overrides StateBase.DisableApplicationLauncher()()()().)
DisableApplicationLauncher(String)
Disables the Application Launcher for the given id. It will no longer launch the application that it was associated with.

DisplayRotation
Gets the orientation of the display, specified as the number of degrees, ranging from 0 to 360. Portrait = 0. Landscape = 90 or 270.

Dispose()()()()
Disposes resources used by the SystemState.

EnableApplicationLauncher(String)
Enable the Application Launcher for this object. When your event is raised, your app will be launched. When your app is launched, "/notify 'applicationLaunchId'" (no quotes) will be passed on the command line.
(Overrides StateBase.EnableApplicationLauncher(String).)
EnableApplicationLauncher(String, String)
Enable the Application Launcher for this object. When your event is raised, your app will be launched. When your app is launched, "/notify 'applicationLaunchId'" (no quotes) will be passed on the command line.
(Overrides StateBase.EnableApplicationLauncher(String, String).)
EnableApplicationLauncher(String, String, String)
Enable the Application Launcher for this object. When your event is raised, your app will be launched. When your app is launched, "/notify 'applicationLaunchId'" (no quotes) will be passed on the command line.
(Overrides StateBase.EnableApplicationLauncher(String, String, String).)
Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Finalize()()()()
(Overrides Object.Finalize()()()().)
GetHashCode()()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetType()()()()
Gets the Type of the current instance.
(Inherited from Object.)
GetValue(SystemProperty)
Get's the value of a system property.

HeadsetPresent
Gets a value indicating whether a headset is present.

InternetSharingDataConnected
Internet Sharing has a valid cellular data connection.

InternetSharingEnabled
Internet Sharing data session is currently enabled. This means Internet Sharing is either connecting or connected.

InternetSharingHostBluetooth
Connection with PC is over Bluetooth.

InternetSharingHostConnected
Internet Sharing has a valid connection with PC.

InternetSharingHostUsb
Connection with PC is over USB.

InternetSharingProcessRunning
Internet Sharing has successfully been loaded and is ready for use.

IsApplicationLauncherEnabled(String)
Tests to see if the Application Launcher has been enabled for the given id.

KeyboardInputMode
Gets a value indicating what’s the current input mode of keyboard driver.

KeyboardPresent
Gets a value indicating whether a keyboard is attached and enabled.

KeyLocked
Determines if the device is currently key locked.

LockStates
Gets the mobile device's lock state.

MediaPlayerAlbumArtist
Gets the album artist's name of the currently playing track in Windows Media Player.

MediaPlayerAlbumTitle
Gets the album title of the currently playing track in Windows Media Player.

MediaPlayerTrackArtist
Gets the artist's name of the currently playing track in Windows Media Player.

MediaPlayerTrackBitrate
Gets the title of the track currently playing in Windows Media Player. For example, "128Kbps"

MediaPlayerTrackGenre
Gets the genre of the currently playing track in Windows Media Player.

MediaPlayerTrackNumber
Gets the number of the current track playing in Windows Media Player.

MediaPlayerTrackTimeElapsed
Gets the elapsed time (in milliseconds) of the currently playing track in Windows Media Player.

MediaPlayerTrackTitle
Gets the title of the track currently playing in Windows Media Player.

MemberwiseClone()()()()
Creates a shallow copy of the current Object.
(Inherited from Object.)
MessagingActiveSyncAccountName
Get the name of the Outlook e-mail messaging account.

MessagingActiveSyncEmailUnread
Gets the number of unread ActiveSync e-mail messages.

MessagingLastEmailAccountName
Gets the name of the e-mail account that was last active.

MessagingMmsAccountName
Gets the name of the MMS messaging account.

MessagingMmsUnread
Gets the number of unread MMS messages.

MessagingOtherEmailUnread
Gets the number of unread e-mail messages from all non-ActiveSync messaging accounts.

MessagingSmsAccountName
Gets the name of the SMS messaging account.

MessagingSmsUnread
Gets the number of unread SMS messages.

MessagingTotalEmailUnread
Gets the total number of unread e-mail messages from all POP3/IMAP accounts.

MessagingVoiceMail1Unread
Gets the number of unplayed voice mail messages for line 1.

MessagingVoiceMail2Unread
Gets the number of unplayed voice mail messages for line 2.

MessagingVoiceMailTotalUnread
Gets the number of unplayed voice mail messages.

OwnerEmail
Gets the mobile devices owner's e-mail address.

OwnerName
Gets the mobile devices owner's name.

OwnerNotes
Gets the text notes entered by the owner of the mobile device.

OwnerPhoneNumber
Gets the mobile device owner's phone number.

Phone1xRttCoverage
Gets a value indicating whether the phone currently has 1xRTT coverage.

PhoneActiveCallCount
Gets the number of active phone calls.

PhoneActiveDataCall
Gets a value indicating whether the phone has an active cellular data connection.

PhoneBlockedSim
Gets a value indicating whether the Subscriber Identity Module (SIM) is blocked.

PhoneCallBarring
Gets a value indicating whether the call barring feature is enabled.

PhoneCallCalling
Gets a value indicating whether the phone is currently attempting to connect an outgoing call.

PhoneCallForwardingOnLine1
Gets a value indicating whether call forwarding is enabled on line 1.

PhoneCallForwardingOnLine2
Gets a value indicating whether call forwarding is enabled on line 2.

PhoneCallOnHold
Gets a value indicating whether a phone call is currently on hold.

PhoneCallTalking
Gets a value indicating whether there is currently a phone call in the talking state.

PhoneCellBroadcast
Gets the cell broadcast message.

PhoneConferenceCall
Gets a value indicating whether a conference call is currently in progress.

PhoneGprsCoverage
Gets a value indicating whether the phone currently has GPRS coverage.

PhoneHomeService
Gets a value indicating whether the phone is currently registered on its home network.

PhoneIncomingCall
Gets a value indicating whether there is an incoming (ringing) call.

PhoneIncomingCallerContact
Gets the Contact that matches the Caller ID.

PhoneIncomingCallerContactPropertyID
Gets the CEPROPID of the property that matches the Caller ID, for example, PIMPR_HOME_TELEPHONE_NUMBER. You can cast this to the ContactProperty enumeration type.

PhoneIncomingCallerContactPropertyName
Gets the name of the property that matches the Caller ID, e.g. "h" for "Home Telephone".

PhoneIncomingCallerName
Gets the name of the person who is currently placing the incoming call.

PhoneIncomingCallerNumber
Gets the incoming call's phone number (Caller ID).

PhoneInvalidSim
Gets a value indicating whether the Subscriber Identity Module (SIM) is invalid.

PhoneLastIncomingCallerContact
Gets the Contact that matches the last Caller ID.

PhoneLastIncomingCallerContactPropertyID
Gets the CEPROPID of the property that matches the last Caller ID, for example, PIMPR_HOME_TELEPHONE_NUMBER. You can cast this to the ContactProperty enumeration type.

PhoneLastIncomingCallerContactPropertyName
Gets the name of the property that matches the last Caller ID, e.g. "h" for "Home Telephone".

PhoneLastIncomingCallerName
Gets the name of the last caller to place an incoming call.

PhoneLastIncomingCallerNumber
Gets the last incoming call's phone number (Caller ID).

PhoneLine1Selected
Gets a value indicating whether line 1 is selected.

PhoneLine2Selected
Gets a value indicating whether line 2 is selected.

PhoneMissedCall
Gets a value indicating whether there was a new missed call.

PhoneMissedCalls
Gets the number of missed phone calls.

PhoneMultiLine
Gets a value indicating whether the phone supports multiple lines.

PhoneNoService
Gets a value indicating whether the phone is not currently connected to a network.

PhoneNoSim
Gets a value indicating whether the Subscriber Identity Module (SIM) is installed in the mobile device.

PhoneOperatorName
Gets the name of the mobile operator (i.e., the mobile phone company, or carrier).

PhoneProfile
Gets the non-localized name of the current sound profile. For example, "Normal", "Silent", "Car", "Headset", "Loud", "Meeting", or "Speakerphone". (Standard Edition only)

PhoneProfileName
Gets the localized name of the current sound profile. (Standard Edition only)

PhoneRadioOff
Gets a value indicating whether the phone's radio is turned off.

PhoneRadioPresent
Gets a value indicating whether the mobile device has a phone.

PhoneRingerOff
Gets a value indicating whether the phone's ringer is off (i.e., if it rings and/or vibrates).

PhoneRoaming
Gets a value indicating whether the phone is currently in roaming mode.

PhoneSearchingForService
Gets a value indicating whether the phone is currently searching for service on a network.

PhoneSignalStrength
Get the phone signal strength, expressed as a percentage of full strength.

PhoneSimFull
Gets a value indicating whether the Subscriber Identity Module (SIM) memory is full.

PhoneTalkingCallerContact
Gets the contact who is on the active phone call.

PhoneTalkingCallerContactPropertyID
Gets the CEPROPID of the property of the contact who is on the active phone call, for example, PIMPR_HOME_TELEPHONE_NUMBER.

PhoneTalkingCallerContactPropertyName
Gets the name of the property of the contact who is on the active phone call, e.g. "h" for "Home Telephone".

PhoneTalkingCallerName
Gets the name of the person you are talking to on the phone. This value is not set when you are talking on a conference call.

PhoneTalkingCallerNumber
Gets the currently connected caller's phone number.

PhoneTalkingCallStartTime
Gets the time of the current active call.

PowerBatteryBackupState
Gets the current backup battery state (for example, it is low, and charging). This enumeration allows a bitwise combination of it's member values.

PowerBatteryBackupStrength
Gets the remaining backup battery power level, expressed as a percentage of fully charged.

PowerBatteryState
Gets the current battery state (for example, it is low, and charging). This enumeration allows a bitwise combination of it's member values.

PowerBatteryStrength
Gets the remaining battery power level, expressed as a percentage of fully charged.

Property
The system property to monitor.

ServiceProviderName
Gets the name of the mobile operator (i.e., the mobile phone company, or carrier).

SimLocked
Determines if SIM is currently locked.

SpeakerPhoneActive
Gets a value indicating whether the speakerphone is active.

TasksActive
Gets the number of active tasks.

TasksDueToday
Gets the number of active tasks that are due today.

TasksHighPriority
Gets the number of high priority tasks that are currently active.

TasksOverdue
Gets the number of overdue tasks.

Time
Gets the current time.

ToString()()()()
Returns a String that represents the current Object.
(Inherited from Object.)
WiFiStateConnected
Gets a value indicating whether Wi-Fi is connected to a network.

WiFiStateConnecting
Gets a value indicating whether Wi-Fi is connecting to a network.

WiFiStateHardwarePresent
Gets a value indicating whether Wi-Fi hardware is present.

WiFiStateNetworksAvailable
Gets a value indicating whether Wi-Fi networks are available.

WiFiStatePowerOn
Gets a value indicating whether Wi-Fi is powered on.

Remarks
Limited functionality is available on Pocket PC 2003 and generic Windows Embedded Compact devices. For example these devices do not support change notifications.
Requirements
Windows Mobile
Windows Mobile Version 5.0 and later
Windows Embedded Compact
Windows CE.NET 4.1 and later
Inheritance Hierarchy
Object
StateBase
 SystemState

Assembly: InTheHand.WindowsMobile.Status (Module: InTheHand.WindowsMobile.Status) Version: 7.0.0.0