Codecore Logo
Quick Search
»
Advanced Search »

Desktop Driver

RSS
This driver connects to the Desktop Server application to control other applications on a windows desktop, such as a music player.

Manufacturer: N/A

Primary Communications Port: Network


Configuration Settings

  • Host Name : The host name or ip address of the computer which will run the applicaion. Please ensure that the Desktop Server application is running on that computer.
  • File Path : The path to the application (.exe) file.
  • Arguments : (optional) The command line arguments. Defaults to none. Some applications can accept command line arguments (or switches) to modify the behavior of how the application will run.
  • StartPath : (optional) Defaults to the application file path directory.
  • Process Name : (optional) The name of the process. Defaults to fileName without extension.

Events

Ready State Changed

The device's running and ready state changed.

Whenever Filter:

none

EventArgs:

  • Number NewValue : The new property value.
  • Number PreviousValue : The previous property value.

Instance Properties

IsRunning

Gets the a Boolean value indicating if the application is currently running.

Accessibility : Read Only

Type: Boolean

DeviceDisplayName

The display name for this device.

Accessibility : Read Only

Type: String

DeviceStartTime

The date and time when this device was started.

Accessibility : Read Only

Type: DateTime

DeviceLifecycleStage

The current lifecycle stage of the device. The stages in order are: Pending Start, Starting, Running, Stopping

Accessibility : Read Only

Type: Number

DeviceIsRunningAndReady

Indicates if the device is ready for use, ie it is in the Running lifecycle stage and all properties are valid and all methods are ready to be used.

Accessibility : Read Only

Type: Boolean

Instance Methods

StartApplication

Starts the application.

Syntax

void StartApplication( )

Parameters

none

CloseApplication

Closes the application.

Syntax

void CloseApplication( )

Parameters

none

SendKeys ( String )

Simulates text entry, but not actual key strokes keystrokes to the current active window. SendKeys is not compatible with all applications, to simulate actual key strokes keystrokes see the Simulated Input driver.

Syntax

void SendKeys( String keys )

Parameters

keys : A sequence of key codes. For a list of special codes, see http://msdn.microsoft.com/en-us/library/system.windows.forms.sendkeys.send(VS.80).aspx

Minimize

Minimizes the application's window.

Syntax

void Minimize( )

Parameters

none

Maximize

Maximizes the application's window.

Syntax

void Maximize( )

Parameters

none

ToFront

Brings the application's window in front of all other windows. Please note that as a security measure, Microsoft Windows prevents windows from being forced to the front under some common circumstances. Please see: // Please note that to prevent some applications from hijacking the desktop windows, Microsoft restricts when a window can be brought to the front. Please see: http://msdn.microsoft.com/en-us/library/ms632599(VS.85).aspx#http%3a%2f%2fmsdn.microsoft.com%2fen-us%2flibrary%2fms632599(VS.85).aspx#foreground

Syntax

void ToFront( )

Parameters

none

ToBack

Sends the application's window behind of all other windows.

Syntax

void ToBack( )

Parameters

none

SetPropertyForDuration ( String, TimeSpan, Object, Object )

Sets a property for a duration of time and then sets the property to a subequent value asynchronously. This action returns after setting the first value and the timer and subsequent property set run in the background. Subsequent sets of the same property will reset the timer if the subsequent value has not yet been set. This is an advanced feature, be sure to set the property name correctly.

Syntax

void SetPropertyForDuration( String propertyName, unknown duration, Object initialValue, Object finalValue )

Parameters

propertyName : The name of the property to set.
duration : The amount of time to wait after setting the initial value to set the subsequent value.
initialValue : The value to set the property to initially.
finalValue : The value to set the property to after the duration of time has passed.

SetPropertyForDuration ( String, Number, TimeSpan, Object, Object )

Sets a property for a duration of time and then sets the property to a subequent value asynchronously. This action returns after setting the first value and the timer and subsequent property set run in the background. Subsequent sets of the same property will reset the timer if the subsequent value has not yet been set. This is an advanced feature, be sure to set the property name correctly.

Syntax

void SetPropertyForDuration( String propertyName, Number arrayIndex, unknown duration, Object initialValue, Object finalValue )

Parameters

propertyName : The name of the property to set.
arrayIndex : The property's array index to set.
duration : The amount of time to wait after setting the initial value to set the subsequent value.
initialValue : The value to set the property to initially.
finalValue : The value to set the property to after the duration of time has passed.

Privacy Policy | Conditions Of Use

Copyright ©2014 Codecore Technologies, All rights reserved.