DIALOG GET USER statement

Purpose

Retrieve a value from the user data area of a DDT dialog.

Syntax

DIALOG GET USER hDlg, index& TO retvar&

Remarks

Each DDT dialog has a user data area consisting of eight Long-integer values which may be used at the programmer's discretion to save relevant data. DIALOG GET USER allows one of the values to be retrieved, based upon the index parameter value (1 through 8).

hDlg refers to the dialog that contains the user data.

index& is the index number of the user data value to retrieve, in the range 1 to 8 inclusive.

retvar& receives the Long-integer data value stored in the nominated user data index.

Restrictions 

Data in the user data area is lost when the dialog is destroyed. The data area is completely separate from the %GWL_USERDATA area maintained by Windows.

See also

Dynamic Dialog Tools, CONTROL GET USER, CONTROL SET USER, DIALOG SET USER