|
FAQ for developers |
  
|
|
FAQ for developers |
|
What do I have to do to include an on-screen keyboard into my own installer?
1) A set of files to be copied to end users’ computers:
Lang – a folder with the program interface translated into other languages
CKeys.exe
CKeysCm.exe
COptions.exe
CKeysH.dll
Keyboards – a folder with on-screen keyboards (one text file per keyboard)
Skins – a catalog with skin images
Background – if you use an image for the keyboard background
Icons – if you use application shortcut icons
Sound – if you use sounds
CKeysDeskBand.dll – if you use a toolbar in the taskbar
*.dic – word autocomplete dictionaries. The folder to be used for storing dictionaries is specified in the Data directory field in the Dictionaries section of the program settings. For convenience, dictionary files can be moved to the program installation folder.
2) If you use the option of showing the on-screen keyboard prior to the system login:
Backup.ini – the pre-login settings file for the on-screen keyboard
You will also need to copy the following four files to the system folder Windows\system32: runcosk.exe, CsCredentialLogon.dll, CsCredentialLogon64.dll, cskeyboardlogon.dll
3) If you have special shortcuts configured, you will also need to copy the file with the settings of these shortcuts to the same folder as on the source computer. The full path to this file and its name can be found in the title of the Keyboard Shortcuts Settings window.
4) To transfer the program settings, do the following:
Save the settings to a separate file. To do that, click the Save to File button in the Advanced section of the settings window.
Once the files have been copied to the end user’s computer, start CKeys.exe with the /RESTORE parameter.
Command format: CKeys.exe /RESTORE "file name"
Example: CKeys.exe /RESTORE "C:\Program Files\Settings.ini"
How can I switch between several on-screen keyboards?
To do that, add a separate key to each on-screen keyboard (in the Edit keyboard type window) and then assign the Activate the next keyboard type action to this key in the Keyboard Shortcuts Settings window. Once you’ve assigned a keyboard switch action to this key, you will see a button next to it that will allow you to configure the list of switchable keyboards.
How do I create a key with a “.com” text?
The most convenient way to add special keys is by using the Edit keyboard type window.
1. Add a separate key to the on-screen keyboard using the Edit keyboard type. You can use unassigned keys that are defined using a hexadecimal code (for instance, 00D9).
2. Select this key and press the Action button. In the new Keyboard Shortcuts Settings window, assign a Paste text action to this key. Enter the necessary text (in this case, “.com”) into the Text field. Do not forget the Show text on the on-screen keyboard box under the Text field.
Once done configuring the settings, save them and close the window.
Can I configure the pre-login on-screen keyboard to differ from the keyboard that is used after the system login?
The settings of the on-screen keyboard that is used for entering the login password are stored in the Backup.ini file. This file is stored in the program installation folder. When you change the program parameters in the Options window, these parameters are saved in the Backup.ini file.
If you don’t want the Backup.ini file to change, mark it as a “Read only” file.
How do I paint keyboard keys into different colors?
Use any graphic editor to create a BMP file with the necessary filling. The size of the image can be arbitrary (50x50 pixels will suffice). For convenience, copy this file to the “Keyboards” subfolder.
Select the necessary key in the Edit keyboard type window and specify the name of the file you just created in the Picture field. Once done, check the Show as background box next to it.
How do I change keyboard parameters from my program?
Program parameters are stored in the HKEY_CURRENT_USER\Software\ComfortSoftware\CKeys registry key.
Once your program has changed some parameters in the system registry, our program needs to load them again. This can be done by sending a windows message containing the WM_USER + 196 code to the program:
WM_CSRELOADOPTIONS = WM_USER + 196;
PostMessage(FindWindow('TFirstForm', 'CKeysFirstForm'), WM_CSRELOADOPTIONS, 0, 0);
This command allows you to do the following:
- Change the interface language (labels on system keys) according to the currently selected input language
- Change the keyboard transparency
- Change the keyboard size
- Temporarily disable the “Show the on-screen keyboard when the text cursor is visible” parameter
- Temporarily disable the word autocomplete feature
- Change the program settings access limitation without reloading the program
How do I transfer the program settings and data to another computer?
Unfortunately, this is not a one-click action.
You will need to do the following:
1. Save the general settings: Options –> Advanced -> Save to File.
2. Save the hotkeys settings file (the name of the file and its full path can be found in the title of the Keyboard Shortcuts Settings window).
3. Save the templates file (the name of the file and its full path can be found in the title of the Template manager window).
4. Save the folder with clipboard data (the path to these files can be found in the settings of the Clipboard manager section).
5. Restore all these data on another computer.
Why won’t the program start and why does it show an error message each time I run it?
1. The program works under Windows 2000 and above only. Windows 95, Windows
98 and Windows CE are NOT supported.
2. Some of the program components may not have been installed. Please try reinstalling the program.
3. If you use Windows Vista or Windows 7, the program must be installed in the Program Files folder. It’s a security-related requirement for these operating systems.