hiSetBindKeys

hiSetBindKeys(
t_applicationType 
l_bindKeyList 
) 
=> t / nil 

Description

Sets multiple bindkeys for an application at one time. For memory and performance efficiency, use this function instead of hiSetBindKey if you are setting multiple bindkeys. For information about restrictions, see hiSetBindKey.

Arguments

list( 
t_key
t_skill_cmd
[ t_EFskill_cmd ]
)

Values Returned

Additional Information

To set multiple bindkeys, use the hiSetBindKeys() function, which is much more efficient than multiple calls to hiSetBindKey().

The following restrictions apply to setting bindkeys:

• When specifying a bindkey, you must ensure that it is spelt correctly and in the correct case.
  Normally, the keyname should be spelt as it appears on the keyboard. One method to ensure that you are using the correct name is to look at the file: /usr/include/X11/keysymdef.h
  Warnings due to incorrectly spelt keynames will appear in the CDS.log file.
• Do not assign the following printable keys to the CIW or to an encapsulation window:
  • a through z, A through Z, or 0 through 9
  • ! @ # $ % ^ & * ( ) _ - + = | \ ~ ‘ { [ } ] : ; " ’ < , > . ? /
  
  If you assigned any of the above keys accidentally, the key can be restored by specifying an empty string for t_skill_cmd. If the key was modified in the CIW, use the bindkey form to restore the behavior, since you will not be able to type the key you are trying to restore in the CIW anymore.
• Do not use the left or middle mouse buttons for setting bindings in the CIW and encapsulation windows. Setting bindings for these buttons conflicts with their normal actions.
• Do not assign anything to F3 or F4 function keys. Cadence software uses the F3 key to display options forms and the F4 key for partial selection in graphics windows.
• Do not assign anything to the following keys, depending on your window manager:
  Motif and OpenLook window managers use the F1 key for help and the F10 key for highlighting menus. F1 key is usually only used for Help if no explicit Help key exists on the keyboard.
• Sun Solaris reserves the F11 and F12 function keys, and they cannot be overridden. This restriction might apply to other platforms as well.
• The unmodified F10 function key is used for osfMenuBar and cannot be overridden on Sun Solaris. This restriction might apply to other platforms as well.
  In future releases, those keys with names that begin with "osf" may no longer be used. Therefore, their use should be avoided.
• By default, Alt cannot be used as a modifier with any printable characters (alphanumeric and special characters) because it is used as a modifier for menu access keys. Alt can be used with function keys and for mouse bindings. However, if menu access keys are disabled, Alt is a legal modifier for all keys, including printable characters.
• If a window manager or desktop, such as CDE, predefines an Alt+key or Alt+mouseButton binding, then that combination will not work as a menu access key or bindkey on that system.
• Bindkeys are not supported in form windows.

Bindkey customizations cannot be used in Layout Viewer. Any updates to the existing bindkeys or user-defined bindkeys are available only in Layout XL and Layout EXL . If you try to customize a bindkey for Layout Viewer, a one-time warning is displayed to inform you that these bindkeys are not available in Layout Viewer when Layout Viewer is opened. You can set noWarnOnLVBindKeyCustomization to t to disable this warning message.

Related Topics

Bindkey Functions

hiBindKeyModifiers

hiGetBindKeyPrefixList

hiRegisterBindKeyPrefix

hiSetBindKey

noWarnOnLVBindKeyCustomization