Feature Upgrade: Starting with CSPro 7.1, you should no longer use this function as it may soon be removed from CSPro. To replicate the behavior of the function, you can use the setproperty function with the argument "Keyboard".
function modifies the keyboard input associated with a field on a form. The value dictionary_symbol
may be an item, group, form, or an entire dictionary. The numeric expression keyboard_id
refers to a keyboard ID (which can be determined using the Change Keyboard Input
dialog box). A keyboard ID of 0 will reset the field to the default keyboard for the application.
Calls to this function are ignored when executed on mobile devices.
The function returns the number of items whose capture positions were successfully changed. If a keyboard ID is not specified, the function will instead return the current keyboard ID associated with a given field.