Home page  
Help >
DDL Command MOVE
Version 7.11
MOVE

Move titles or messages to the TITLEBAR or the STATUSBAR, or to move values back and forth between named objects in screens or dialogs and/or transfer fields on screens.

Form1:
MOVE string TO TITLEBAR
MOVE string TO STATUSBAR

Form2:
MOVE/options value TO object-name

Form3:
MOVE/options object-name TO %variable

Form4:
MOVE object-name[STATE] TO %variable

Form5:
MOVE n TO object-name[STATE]

Notation standards Options Answers

Options:
V -(Form 2 only) Force transfer field validations to be performed.
N -(Form 2 only) Do not mark the record as having been changed.
T -(Form 3 only) Trim trailing blanks.
Z -(Form 3 only) Move to a numeric variable.
X -Suppress command response.
Y -Do not alter the command answer cells.

Answers:
Ctl.Ans1 =Zero
Ctl.Ans2 =Zero
Ctl.Ans3 =Zero .

Notes:
In form 1 the "string" can be either a literal or a variable. TITLEBAR is a fixed name refering to the title bar at the top of your screen, and STATUSBAR is a fixed name refering to the status message area at the bottom of the screen. You can move things to them, but not from them.

In forms 2 and 3 the "object-name" can be either a named object or a transfer field. You can only move values to an edit field, not from. But you can move values to and from boxed edit fields, service fields, and transfer fields.

In form 2 the "value" can be a literal, a string or numeric variable, or as noted as follows: If the target is an icon button or icon object then the "value" is an icon name (from the icon library) and that name must be enclosed in quotes. If the target is a picture object then the source "value" is an image file name and that name must be enclosed in quotes. The supported image file formats are GIF, TIFF, BMP, and JPEG.

In form 3 if the variable did not previously exist it is created as a string variable unless you use the Z option, in which case it will be created as a numeric variable.

Forms 4 and 5 are for radio buttons and check boxes. With form 4 you can discover the current state of the radio button or check box, and with form 5 you can set the state of a radio button or check box.

For example, suppose you have a radio button object named RB. Suppose there are three buttons in it; button 1 has the return string 'aaa' assigned to it, button 2 has 'bbb,' and button 3 has 'ccc.' If you say

move rb[state] to %v

if button 1 was selected %v =aaa. If button 2, %v=bbb. If button3, %v=ccc.

Conversly, if you did either of the following:

move 2 to rb[state]
or
move 'bbb' to rb[state]

then your procedure would be setting button 2.

The "state" of a check box is either YES or NO. So if you had a check box named CB, then

move cb[state] to %vv

would return a YES if the box is checked, NO if not. And if you want to set that check box as being checked you would

move 'YES' to cb[state]

Or, if you moved NO then it would uncheck it.

For more examples of MOVE, and for more information about named objects and the "state" of certain objects, see named objects .


Copyright © 2019 , WhamTech, Inc.  All rights reserved. This document is provided for information purposes only and the contents hereof are subject to change without notice. Names may be trademarks of their respective owners.