8.11 DUIM-Gadgets Module

gadget-key-press-callback-setter

Generic function

Summary

Sets the key-press callback for the specified gadget.

Signature

gadget-key-press-callback-setter key-press-callback gadget
=> key-press-callback

Arguments

key-press-callback

An instance of type false-or(<command>, <function>).

gadget

An instance of type <collection-gadget>.

Values

key-press-callback: An instance of type false-or(<command>, <function>).

Library

duim-gadgets

Module

duim-gadgets

Description

Sets the key-press callback for gadget. The key-press callback is the callback invoked when a key on the keyboard is pressed while the gadget has focus. They are of most use in tab controls, list controls, table controls, graph controls, and tree controls.

In Windows, a good use for the key-press callback would be to mirror the behavior of Windows Explorer, where typing a filename, or part of a filename, selects the first file in the current folder whose name matches that typed.