Touch-It Virtual Keyboard Version 4.9.2
Automation interface

Here is a list of the automation methods available (Delphi syntax). See Driving keyboards, Lights and Display text for code samples.

Display (restore) the keyboards when minimized
procedure Show;

Minimize the keyboards
procedure Hide;

Open a keyboard at its default position. (Defined on the Package page)
procedure Open(aFileName: OleVariant; aMonitor: Integer);

  • aFileName : Template file name or identification. (ID)
  • aMonitor : Select on which monitor to display the keyboard.
    • 0 : 1st monitor
    • 1 : 2nd monitor
    • etc.

Open or move a keyboard at a specific position
procedure OpenAs(aFileName: OleVariant; aPos, aMonitor: Integer);

  • aFileName : Template file name or identification. (ID)
  • aPos : Screen position
    • 0 : Left appbar
    • 1 : Top appbar
    • 2 : Right appbar
    • 3 : Bottom appbar
    • 4 : Floating
    • 5 : Menu
    • 7 : Top-left corner
    • 8 : Top-right corner
    • 9 : Bottom-left corner
    • 10 : Bottom-right corner
    • 13 : Top-left add-on
    • 14 : Top-right add-on
    • 15 : Bottom-left add-on
    • 16 : Bottom-right add-on
    • 17 : Center of the screen
  • aMonitor : Select on which monitor to display the keyboard.
    • 0 : 1st monitor
    • 1 : 2nd monitor
    • etc.

Close a keyboard
procedure Close(aFileName: OleVariant; aMonitor: Integer);

  • aFileName : Template file name or identification. (ID)
  • aMonitor : Select on which monitor to display the keyboard.
    • 0 : 1st monitor
    • 1 : 2nd monitor
    • etc.

Change the template in a container
procedure ChangeTemplate(aFileName, aContainer: OleVariant);

  • aFileName : Template file name
  • aContainer : Container to change.

Set an absolute floating keyboard position
procedure SetPos(aLeft, aTop: integer);

  • aLeft, aTop : Keyboard top-left position.

Set a floating keyboard position relative to an edit control without hidding it
procedure SetBoundPos(aLeft, aTop, aRight, aBottom: integer);

  • aLeft, aTop, aRight, aBottom : Bounds of the edit control.

Reload the keyboards defined in the Setup - Startup section.
procedure Reload;

Switch on/off one light
procedure Light(aID: Integer; aON: WordBool);

  • aID : Light code.

Switching on one light only between aRangeStart and aRangeEnd
procedure LightOne(aID, aRangeStart, aRangeEnd: Integer);

  • aID : Light code.
  • aRangeStart : First light identification.
  • aRangeEnd : Last light identification.

Switching on lights between aRangeStart and aID
procedure LightRange(aID, aRangeStart, aRangeEnd: Integer);

  • aID : Light code.
  • aRangeStart : First light identification.
  • aRangeEnd : Last light identification.

Driving a progress bar
procedure LightProgress(aID, aPosition: Integer);

  • aID : Progress bar code.
  • aPosition : Alighted from Min to aPosition.

Driving a progress bar
procedure Write(aID : integer; aText :OleVariant);

  • aID : Display code.
  • aText : Text to display.

Lock/unlock screen refresh
procedure Lock;
procedure Unlock;
procedure ResetLock;

Change the system wide language
procedure ChangeLanguage(aLanguage :integer);
(You are responsible to provide a valid language ID by checking the registry: HKCU\Keyboard layout\Preload)

Send text (or keystrokes) using the Touch-It kernel
procedure SendText(aText :WideString);

Customize a SendText key
procedure CustomizeKey(aName: OleVariant; aData :WideString);
Change the look and behavior of SendText keys. This procedure is especially designed to be accessed from an OPOS sofware.

  • aName, name of the SendText key. If this parameter is left blank, all SendText keys with a name defined are modified allowing to reset the keyboard.
  • aData is a wide string (unicode) which represents the customization. It can include one or more of the following parameters:
    • ImageUp (numeric) : Index of the background image when the key is released.
    • ImageDown (numeric) : Index of the background image when the key is pressed.
    • ColorID (numeric) : Index of the background color when no images are selected.
    • Image (text) : File name (whithout path) of an image used as the pictogram.
    • Caption (text) : Text on the key.
    • Data (text) : Keystrokes to the 3rd party application.

Copyright © 2011 Chessware SA