In The Hand - .NET Components for Mobility
SystemState Class
NamespacesInTheHand.WindowsMobile.StatusSystemState
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.

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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

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

Requires Windows Mobile 5.0


BluetoothStateHandsFreeControl
Gets a value indicating whether Bluetooth HandsFree control is active.

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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".

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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.

CameraEnabled
Gets a value indicating whether a camera is enabled.

Requires Windows Mobile 6


CameraPresent
Gets a value indicating whether a camera is attached.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


CellularSystemAvailable1xrtt
Gets a value indicating whether 1xRTT is available.

Requires Windows Mobile 5.0


CellularSystemAvailableEdge
Gets a value indicating whether EDGE is available.

Requires Windows Mobile 5.0


CellularSystemAvailableEvdo
Gets a value indicating whether EVDO is available.

Requires Windows Mobile 5.0


CellularSystemAvailableEvdv
Gets a value indicating whether EVDV is available.

Requires Windows Mobile 5.0


CellularSystemAvailableGprs
Gets a value indicating whether GPRS is available.

CellularSystemAvailableHsdpa
Gets a value indicating whether HSDPA is available.

Requires Windows Mobile 5.0


CellularSystemAvailableUmts
Gets a value indicating whether UMTS is available.

Requires Windows Mobile 5.0


CellularSystemConnected1xrtt
Gets a value indicating whether 1xRTT is connected.

Requires Windows Mobile 5.0


CellularSystemConnectedCsd
Gets a value indicating whether CSD is connected.

Requires Windows Mobile 5.0


CellularSystemConnectedEdge
Gets a value indicating whether EDGE is connected.

Requires Windows Mobile 5.0


CellularSystemConnectedEvdo
Gets a value indicating whether EVDO is connected.

Requires Windows Mobile 5.0


CellularSystemConnectedEvdv
Gets a value indicating whether EVDV is connected.

Requires Windows Mobile 5.0


CellularSystemConnectedGprs
Gets a value indicating whether GPRS is connected.

Requires Windows Mobile 5.0


CellularSystemConnectedHsdpa
Gets a value indicating whether HSDPA is connected.

Requires Windows Mobile 5.0


CellularSystemConnectedUmts
Gets a value indicating whether UMTS is connected.

Requires Windows Mobile 5.0


Changed
Event that is raised when the state changes.

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

Requires Windows Mobile 6


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.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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).

Requires Windows Mobile 5.0


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 -90.

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()()()
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
GetHashCode()()()
Serves as a hash function for a particular type. GetHashCode()()() is suitable for use in hashing algorithms and data structures like a hash table.
(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.

Requires Windows Mobile 5.0


InternetSharingDataConnected
Internet Sharing has a valid cellular data connection.

Requires Windows Mobile 6


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

Requires Windows Mobile 6


InternetSharingHostBluetooth
Connection with PC is over Bluetooth.

Requires Windows Mobile 6


InternetSharingHostConnected
Internet Sharing has a valid connection with PC.

Requires Windows Mobile 6


InternetSharingHostUsb
Connection with PC is over USB.

Requires Windows Mobile 6


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

Requires Windows Mobile 6


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

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

KeyLocked
Determines if the device is currently key locked.

Requires Windows Mobile 5.0


LockStates
Gets the mobile device's lock state.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


MessagingVoiceMailTotalUnread
Gets the number of unplayed voice mail messages.

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


PhoneIncomingCallerContact
Gets the Contact that matches the Caller ID.

Requires Windows Mobile 5.0


PhoneIncomingCallerContactPropertyID
Gets the CEPROPID of the property that matches the Caller ID, for example, PIMPR_HOME_TELEPHONE_NUMBER.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

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

Requires Windows Mobile 5.0


PhoneLastIncomingCallerContact
Gets the Contact that matches the last Caller ID.

Requires Windows Mobile 5.0


PhoneLastIncomingCallerContactPropertyID
Gets the CEPROPID of the property that matches the last Caller ID, for example, PIMPR_HOME_TELEPHONE_NUMBER.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


PhoneLine1Selected
Gets a value indicating whether line 1 is selected.

Requires Windows Mobile 5.0


PhoneLine2Selected
Gets a value indicating whether line 2 is selected.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


PhoneMissedCalls
Gets the number of missed phone calls.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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". (Smartphone only)

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

Requires Windows Mobile 5.0


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).

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0


PhoneTalkingCallerNumber
Gets the currently connected caller's phone number.

Requires Windows Mobile 5.0


PhoneTalkingCallStartTime
Gets the time of the current active call.

Requires Windows Mobile 5.0


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.

SimLocked
Determines if SIM is currently locked.

Requires Windows Mobile 5.0


SpeakerPhoneActive
Gets a value indicating whether the speakerphone is active.

Requires Windows Mobile 5.0


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.

Requires Windows Mobile 5.0 or later


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

Requires Windows Mobile 5.0 or later


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

Requires Windows Mobile 5.0 or later


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

Requires Windows Mobile 5.0 or later


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

Requires Windows Mobile 5.0 or later


Inheritance Hierarchy
Object
StateBase
 SystemState

Assembly: InTheHand.WindowsMobile (Module: InTheHand.WindowsMobile) Version: 3.2.0.0