MOVE - OBJECT to OBJECT

The MOVE OBJECT to OBJECT instruction transfers an existing GUI object to another object of the same type. It uses one of the following formats:

Where:

label

Optional. A Program Execution Label.

source

Required. A GUI object variable that serves as the source operand.

sep

Required. A comma or one of the following prepositions: BY, TO, OF, FROM, USING, WITH, IN, or INTO.

dest

Required. A GUI Object variable that serves as the destination operand.

Flags Affected: ZERO

Note the following:

1. The ZERO flag is set when the {source} GUI Object control is moved to the {dest} GUI object.

2. {source} must be the same type object as the {dest}. A compilation error occurs if the types do not match. If an object type mismatch is detected by the runtime, an O160 error occurs.

3. If {dest} has been previously created, it is destroyed before the MOVE operation is performed.

4. After the MOVE operation has been completed successfully, {dest} acquires the creation state of {source} and the {source} GUI object is always set to a not created state.

5. If {source} is not in a created state before the MOVE operation, {dest} is set to a not created state after the MOVE.

6. If the {source} and the {dest} variables reference the same program variable, no action is taken.

See Also: MOVE