Version 4.2.
Softkeyboard INDEX 1 OPERATING SYSTEMS ................................................................................................................. 3 2 LAYOUTS .................................................................................................................................. 4 2.1 LAYOUT TYPE, DEPTH AND LOCAL IDENTIFIERS .................................................................................... 4 2.2 PIXEL SIZE OF LAYOUTS .................................................
Softkeyboard 1 OPERATING SYSTEMS The Softkeyboard V4.00 runs with the following operating systems: • • • • • Windows Windows Windows Windows Windows XP Home XP Professional XP Embedded Vista 7 The Softkeyboard doesn’t run with the following operating systems: • • • • • • • Windows NT Windows ME Windows 98 Windows 95 Windows 3.1/3.
Softkeyboard 2 LAYOUTS 2.
Softkeyboard 2.
Softkeyboard 3 SPECIAL SOFTK KEYBOARD FEATURES 3.1 STANDARD FEATU URES U Upsizes the layout of the Softkeyboard. D Downsizes the layout of the Softkeyboard. Changes the layout type between alpha numeric layout, numeric C b block layout and function block layout (if it’s enab bled) one after a another. C Changes the numeric bloc layouts between digits and arrows. Free Area 3.2 M Moves the Softkeyboard on the screen.
Softkeyboard 4 CHANGE SOFTKEYBOARD PROPERTIES Start configuration of Softkeyboard by clicking its icon in the Control Panel (elder Versions) or by starting the ads-tec Configuration Center (latest versions). OLD VERSION NEWER VERSIONS © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 4.1 SOFTKEYBOARD KEYBOARD LANGUAGE The following languages are available: • • • • • • • • • • • • • German English (United States) English (United Kingdom) French Italian Spanish Portuguese Finnish Turkish Danish Swedish Japanese Korean • • • • • • • • • • • • • Greek Czech Polish Romanian Russian Serbian Croatian Hungarian Dutch Slovak Slovenian Bulgarian Norwegian If "Auto detect language" is enabled the Softkeyboard will use the language of your local operating system.
Softkeyboard 4.2 KEY SEQUENCE AVAILABLE Enable/Disable key sequences for the combinations: • • • Ctrl-Esc Ctrl-Alt-Del Alt-F4 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 4.3 LOCK KEYS Lock/Unlock the keys Ctrl, Alt or AltGr to send combinations like Ctrl+A or Alt+F4 without multiple input of Ctrl or Alt. • Ctrl • Alt • AltGr 4.4 DEFAULT VALUE Clicking this button to restore default values of all properties. 10 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 4.5 SOFTKEYBOARD COLORS Change the colors of Softkeyboard by clicking in one of the four color areas (right of description) and select a new color from the color dialog. © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 4.6 START UP AND CLOSE ACTIVATE BY MOUSE • not available: supported. Activation of Softkeyboard by mouse-click is not • right mouse button: to hide (if show) Right mouse button will be enabled to popup (if hide) or • middle mouse button: or to hide (if the Softkeyboard. Middle mouse button will be enabled to popup (if hide) show) the Softkeyboard. SWITCH AUTOLOGON Toggles existing autologon registry entry "AutoAdminLogon" with a key sequence (Microsoft Windows 2000 and newer).
Softkeyboard UNLOCK WHEN CLOSING • not activated: closing • activated: closing © ads-tec GmbH • Raiffeisenstr.14 • 70771 Leinfelden-Echterdingen The state of Ctrl, Alt and AltGr will not be unlocked while Softkeyboard. The state of Ctrl, Alt and AltGr will be unlocked while Softkeyboard.
Softkeyboard 5 KEYBOARD SIZE MINIMUM • Values 2 – 11: Smallest zoom factor available for resizing the keyboard. STANDARD • Values 2 – 11: Default zoom factor available for resizing the keyboard. MAXIMUM • Values 2 – 11: 14 Largest zoom factor available for resizing the keyboard. © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 5.1 TRANSPARENCY IN PERCENT (10-100) • Values 10-100 Any value between 10 and 100 is possible. It's recommended to use values between 50 and 100. Value 10 Value 100 Softkeyboard and Virtual-FrontKey are nearly absolute transparent. Softkeyboard and Virtual-FrontKey are not transparent. © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 5.2 KEYBOARD LAYOUTS AVAILABLE Enable/Disable the following keyboard layout: • Alphanumeric keyboard • Numeric keyboard • Function keys Note: At least one keyboard layout must be enabled! The Extended Mode option enables in the alphanumeric keyboard layout the red marked six buttons on the right border of the Softkeyboard (see the following picture). 16 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 5.3 START LAYOUTTYPE The following layouttypes are available (if it’s enabled): • Alphanumeric keyboard • Numeric keyboard • Function keys © ads-tec GmbH • Raiffeisenstr.14 • 70771 Leinfelden-Echterdingen Softkeyboard will be started with alpha numeric layout. Softkeyboard will be started with numeric block layout. Softkeyboard will be started with function block layout.
Softkeyboard 6 FRONTKEY PROPERTIES Enable or disable the check-boxes for the hardware keys which are available at the front of the panel. 6.1 ATTACH MACRO If the "Left/right keys available" is activated you can choose in the dropdown box one of the additional keys to record a macro. To do this, choose the number of your favorite frontkey and click the "Record"-button. Now you can start recording by pressing a key or key sequence (for example: "F5" or "Ctrl + Alt + F3").
Softkeyboard An alternative definition for the Hotkey-button is to launch an application by pressing this key. Please select the application in the window that appears by clicking the "Select Application"-button. © ads-tec GmbH • Raiffeisenstr.
Softkeyboard Note: For the changes to take effect please first click the "Apply"-button! 20 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 7 VERSION INFORMATION To get the information about the Softkeyboard version please have a look at the bottom right corner (alpha numeric layout and function block layout) or at the left upper corner (numeric block layout). On the Control Panel Applet you get information about the Softkeyboard version by clicking on the information tab. In the next picture you can see the version and build date of the product. In the next picture the file version of “Softkey.exe” and “Genkey.exe” is shown.
Softkeyboard 8 SCREENSHOTS SOFTKEYBOARD Alpha numeric layout: Numeric block layout: Function block layout (normal status and shift status): 22 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 9 VFRONTKEY Open the folder Softtkeyboard and start the VFrontkey.exe application n to simulate the frontkey buttons. Op pen the file SoftKey.ini for configurating the VFrontkey application. There are three layo outs available: Layout 1 Layout 2 Layout 3 One click on the ABC C button or on the keyboard button in the third la ayout will show or hide the Softkeyboard. One click on the Mouse button in the first layo out simulates the right mousekey funcctionality.
Softkeyboard You can change the configuration in the section [VfrontKey] of the SoftKey.ini file. The options below are available: Layout: Changes the layout type of Vfrontkey application. Available values are 1, 2 and 3, default value is 1. 1 = Layout 1 2 = Layout 2 3 = Layout 3 MoveTimeout: Timout to start the movement of the VFrontkey application. Any positive value is possible, default value is 500. 0…nnnn = Timeout in milliseconds. Mode: The way of resizing the application.
Softkeyboard 9.1 AUTOMATIC START AND STOP OF THE VFRONTKEY APPLICATION Note: This option is currently not available for V4.xx. With this option is it possible to open the Softkeyboard application in the logon screen to enter the logon data. You can configure the automatic start and stop of the VFrontkey application in the file “Genkey.ini” in the Windows directory. In this file is the section [VFRONTKEYSETTINGS] with the “StartVFrontkey” parameter.
Softkeyboard 10 KEYLOOK Open the folder So oftkeyboard and start the keylook.exe application. This tool will help you finding out the e keycodes and scancodes for any pressed key on n the keyboard. 26 © ads-tec GmbH • Raiffeisenstr str.
Softkeyboard 11 SOFTKEYBOARD API (CLASSIC API) 11.1 SEND MESSAGES TO THE SOFTKEYBOARD (CLASSIC API) SHOW SOFTKEYBOARD Description Shows the Softkeyboard on the screen. Definition static UINT SOFTKEYBOARD_MSG_OPEN; Registration SOFTKEYBOARD_MSG_OPEN = ::RegisterWindowMessage(_T("SOFTKEYBOARD_MSG_OPEN")); Usage ::PostMessage(HWND_BROADCAST, SOFTKEYBOARD_MSG_OPEN,0, 0); HIDE SOFTKEYBOARD Description Hides the Softkeyboard on the screen.
Softkeyboard MOVE POSITION Description Moves the Softkeyboard to the new x,y Position. Definition static UINT SOFTKEYBOARD_MSG_API; Registration SOFTKEYBOARD_MSG_API = ::RegisterWindowMessage(_T("SOFTKEYBOARD_MSG_API")); Usage const short SKB_POSITION = 1; short XPos = 200; short YPos = 400; ::PostMessage (HWND_BROADCAST, SOFTKEYBOARD_MSG_API, SKB_POSITION, MAKELPARAM(XPos,YPos)); CHANGE SIZE Description Changes the size of Softkeyboard. Available values are from 2 up to 11.
Softkeyboard CHANGE LAYOUT Description Changes the layout type of Softkeyboard. Available values are 0, 1, 2 and 3. 0 = Alphanumeric keyboard layout. 1 = Numeric keyboard layout. 2 = Function block layout, Layer A. 3 = Function block layout, Layer B.
Softkeyboard CHANGE LANGUAGE Description Changes the language of Softkeyboard.
Softkeyboard Usage const short GERMAN_DE = 1; ::PostMessage (HWND_BROADCAST, SOFTKEYBOARD_MSG_API, SKB_LANGUAGE, GERMAN_DE); CHANGE TRANSPARENCY Description Changes the transparency of Softkeyboard. Available values are from 10 up to 100.
Softkeyboard 11.2 RECEIVE MESSAGES FROM THE GENKEY SERVICE (CLASSIC API) ABC FRONTKEY Description Receive this message if the ABC frontkey was pressed. Definition static UINT SOFTKEY_KEYABC; Registration SOFTKEY_KEYABC = RegisterWindowMessage("SOFTKEY_KEYABC"); Usage LRESULT CSoftKeyDlg::DefWindowProc(UINT message, WPARAM wParam, LPARAM lParam) { if (message == SOFTKEY_KEYABC) { [Your code starts here!] } } 32 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard TASK TOGGLE FRONTKEY Description Receive this message if the task toggle frontkey was pressed. Definition static UINT SOFTKEY_KEYPAGES; Registration SOFTKEY_KEYPAGES = RegisterWindowMessage("SOFTKEY_KEYPAGES"); Usage LRESULT CSoftKeyDlg::DefWindowProc(UINT message, WPARAM wParam, LPARAM lParam) { if (message == SOFTKEY_KEYPAGES) { [Your code starts here!] } } © ads-tec GmbH • Raiffeisenstr.
Softkeyboard HOTKEY FRONTKEY Description Receive this message if the hotkey frontkey was pressed. Definition static UINT SOFTKEY_KEYLOCK; Registration SOFTKEY_KEYLOCK = RegisterWindowMessage("SOFTKEY_KEYLOCK"); Usage LRESULT CSoftKeyDlg::DefWindowProc(UINT message, WPARAM wParam, LPARAM lParam) { if (message == SOFTKEY_KEYLOCK) { [Your code starts here!] } } 34 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard RIGHT MOUSE FRONTKEY Description Receive this message if the right mouse frontkey was pressed. Definition static UINT SOFTKEY_KEYMOUSE; Registration SOFTKEY_KEYMOUSE = RegisterWindowMessage("SOFTKEY_KEYMOUSE"); Usage LRESULT CSoftKeyDlg::DefWindowProc(UINT message, WPARAM wParam, LPARAM lParam) { if (message == SOFTKEY_KEYMOUSE) { [Your code starts here!] } } Note: The classic API works for Windows versions before Vista. With Vista, this API requires the helper application “SkbdCtrl.exe”.
Softkeyboard 12 SOFTKEYBOARD API (C++ API) Starting with Vista, UIPI (User interface privilege isolation) restricts the way how applications can interchange windows messages. With UAC (User account control) enabled, softkey.exe runs at an elevated level, since it is started from a service, and may not receive messages from a standard application. When using the classic API, a proxy (skbdctrl.exe) receives the global window messages and talks to the service through a named pipe.
Softkeyboard MOVE POSITION Description Moves the Softkeyboard to the new x,y Position. Definition bool CSKCtrl::SetPos(int x, int y); Usage CKCtrl.SetPos(x, y); CHANGE SIZE Description Changes the size of Softkeyboard. Available values are from 2 up to 11. Definition bool CSKCtrl::SetSize(int factor); Usage CSKCtrl.SetSize(factor); © ads-tec GmbH • Raiffeisenstr.
Softkeyboard CHANGE LAYOUT Description Changes the layout type of Softkeyboard. Available values are 0, 1, 2 and 3. 0 = Alphanumeric keyboard layout. 1 = Numeric keyboard layout. 2 = Function block layout, Layer A. 3 = Function block layout, Layer B. Definition typedef enum { LayoutABC = 0, LayoutNUM, LayoutFuncA, LayoutFuncB } SkbdLayoutType; bool CSKCtrl:: SetLayout(SkbdLayoutType layout); Usage CSKCtrl.SetLayout(layout); 38 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard CHANGE LANGUAGE Description Changes the language of Softkeyboard.
Softkeyboard Usage #define GERMAN_DE 1 CSKCtrl.SetLanguage(GERMAN_DE); CHANGE TRANSPARENCY Description Changes the transparency of Softkeyboard. Available values are from 10 up to 100. Definition bool CSKCtrl:: SetTransparency(int percent); Usage CSKCtrl. SetTransparency(transparency); 40 © ads-tec GmbH • Raiffeisenstr.
Softkeyboard 12.2 READ FRONTKEY STATUS FROM THE GENKEY SERVICE (C++ API) FRONTKEY STATUS Description Read the current frontkey status. The frontkey status is an OR’ed flag combination of the keys pressed. Definition #define KEYSHIFT 0x10 // Fn #define KEYPAGES 0x02 // V+ #define KEYLOCK 0x04 // V- #define KEYMOUSE 0x08 #define KEYABC 0x01 // B+ // B- bool CSKCtrl::GetKey (int *key); Usage CSKCtrl.GetKey (&key); ===== Ende der Stüc kli ste ===== © ads-tec GmbH • Raiffeisenstr.
