DtkshSetReturnKeyControls

DtkshSetReturnKeyControls configures a text widget within a form widget so that the Return key does not activate the default button within the form, but instead moves the focus to the next text widget within the form. This is useful if you have a window that contains a series of text widgets, and the default button should not be activated until the user presses the Return key while the focus is in the last text widget.

Usage:

DtkshSetReturnKeyControls textWidget nextTextWidget formWidget
                           defaultButton

The textWidget parameter specifies the widget to be configured to catch the Return key and force the focus to move to the next text widget (as indicated by the nextTextWidget parameter). The formWidget parameter specifies the form containing the default button and should be the parent of the two text widgets. The defaultButton parameter indicates which component is to be treated as the default button within the form widget.

Examples:

DtkshSetReturnKeyControls $TEXT1 $TEXT2 $FORM $OK 
DtkshSetReturnKeyControls $TEXT2 $TEXT3 $FORM $OK