Keystroke methods

Top  Previous  Next

 

Some keyboard keystroke combinations are not sent to the remote machine because they are intended to work only on the local environment.

Through ThinRDP SDK library it is possible to send any keystroke combination to the server by using a list of methods available in any ThinRDP instance you create.

 

The table below lists and describes those methods.

The first four methods are general base methods that once combined could generate any keystroke sequence.

The last eight methods are commonly used key combinations that might be useful to enhance functionality to your ThinRDP integration.

 

 

 

Method

 

Behaviour

 

Arguments

sendText(textValue)

This method sends a plain text value to the current remote cursor position.

textValue

String

Text to be sent

sendKeyStroke(keyCode)

The sendKeyStroke method sends a key code, emulating the key's press and release sequentially.

keyCode

Number

Unicode representing

the key the user pressed

and released

sendKeyDown(keyCode)

Sends a key down.

keyCode

Number

Unicode representing

the key the user

pressed

sendKeyUp(keyCode)

Sends a key up.

keyCode

Number

Unicode representing

the key the user released

sendCtrlAltDel()

Sends a CTRL+ALT+DEL sequence.

 

sendShiftCtrlEsc()

Sends a CTRL+ALT+DEL sequence.

 

sendShellExplorer()

Sends a CTRL+ALT+E (or WINDOWS+E) sequence.

 

sendShellRun()

Sends a CTRL+ALT+R (or WINDOWS+R) sequence.

 

sendCtrlEsc()

Sends a CTRL+ESC sequence.

 

sendCut()

Sends a CTRL+X sequence.

 

sendCopy()

Sends a CTRL+C sequence.

 

sendPaste()

Sends a CTRL+V sequence.

 

 

 

Usage Examples:

 

The next examples are JavaScript methods which are intended to show you a couple of usage cases for combining ThinRDP Library Keystroke methods.

 

 

Example 1 - Enter:

 

This first example shows you how to send a single keystroke, by sending its key code on the sendKeyStroke method argument.

 

  function sendEnter() {

      if (mythinrdp) {

           mythinrdp.sendKeyStroke(13);

       }

   }

 

 

Example 2 - Select next word / Select Line:

 

Observe on these next examples how to use the combination of "keydown" followed by "keyup" keys in order to select the next word inside of a text.

These next two examples simulate a combinations of keys pressed all together.

Remember that the sendKeyDown method has to be followed, at some point, by the sendKeyUp method, in order to release the key. If you only call the sendKeyDown method it is as if a key was constantly pressed on the keyboard.

 

  function selectNextWord() {

      if (mythinrdp) {

           mythinrdp.sendKeyDown(0x11); //CTRL

           mythinrdp.sendKeyDown(0x10); //SHIFT

           mythinrdp.sendKeyStroke(39); // RIGHT ARROW

           mythinrdp.sendKeyUp(0x10); //SHIFT

           mythinrdp.sendKeyUp(0x11); //CTRL

       }

   }

 

  function selectLine() {

      if (mythinrdp) {

           mythinrdp.sendKeyDown(0x10); //SHIFT

           mythinrdp.sendKeyStroke(40); // DOWN ARROW

           mythinrdp.sendKeyUp(0x10); //SHIFT

       }

   }

 

 

Example 3 - Send a plain text:

 

This next example sends a plain text followed by an 'enter' to the remote environment.

 

  function sendText() {

      if (mythinrdp) {

           mythinrdp.sendText("This is a test...");

           sendEnter();

       }

   }