MOVE-NAVIGATION-ITEMS Action

This document covers the following topics:


Description

Moves a range of controls to a new position in the control sequence. The control sequence within the range of controls being moved remains unchanged.

Parameters

Name/Data Type Explanation
First control

(HANDLE OF GUI)

Input

Specifies the first control in the range of controls which is to be moved. If this parameter is specified as NULL-HANDLE, the first control in the control sequence is used.

Last control

(HANDLE OF GUI

Input

Specifies the last control in the range of controls which is to be moved. If this parameter is specified as NULL-HANDLE, the last control in the control sequence is used.

Position To

(HANDLE OF GUI)

Input

Specifies the control which is to immediately precede the moved control(s) in the new control sequence. This control must not be one of the controls being moved. If this parameter is specified as NULL-HANDLE, the controls are moved to the end of the control sequence. If this parameter is specified as the handle of the dialog itself, the controls are moved to the front of the control sequence.

Response (I4) Output

NATURAL error (if applicable).

Example:

 
  /* Move the controls in the current control sequence starting from #PB-1 and ending with the last
  /* control in the control sequence to follow #SB-1
  PROCESS GUI ACTION MOVE-NAVIGATION-ITEMS WITH
      #PB-1 NULL-HANDLE #SB-1 GIVING #RESPONSE