Uniface Keys (UnifaceKeys)

Uniface list of keys and key combinations to handled by Uniface rather than the widget contents.

"UnifaceKeys=DefaultKeys | Keys"

Value

Description

DefaultKeys

Default keys are redirected to and processed by Uniface. For more information, see Default Keys.

Keys

Comma-separated list of keys to be handled by Uniface rather than the widget. Each key or combination of keys has the format:

{Modifier+ | - | Space }Key

Modifier is Shift, Alt, or Ctrl.

Keys and modifiers are case-insensitive and have the same spelling as those in the .ini file.

Usage

Dynamic?

Yes

Supported in Grid?

No

Dependencies:

No

Description

For most Uniface widgets, Uniface always handles the keyboard input. However, some widgets have their own interfaces for handling some keys, and these are not always predictable. For example:

  • OCX Container—the widget can host many different OCX controls, each having its own way of dealing with the keyboard

  • HTML widget—the widget can host many different HTML pages, and the HTML and JavaScript inside the page may do its own keyboard processing.

You can use the UnifaceKeys property to define which keystrokes Uniface should intercept.

Default Keys

When the value DefaultKeys is specified, the following keys are handled by Uniface:

  • Ctrl+Letter (uppercase or lowercase) combinations: Ctrl+a through Ctrl+Z

  • Esc, optionally combined with Shift or Alt (but not Ctrl)

  • Tab, optionally combined with Shift or Alt (but not Ctrl)

    The widget determines whether the Tab key is included in the default keys. For the OCX widget, it is included if the WantTab property is False (the default). For the HTML widget, it is not included in the default keys.

Using in ProcScript

You can use $properties or $fieldproperties to set or get the property and its value. For more information, see $properties and $fieldproperties.

$properties(OCX)=OCX=SMILE.SmileCtrl.1;UnifaceKeys=Tab,ctrl+Z;SetOcxNativeProp=Always