CONTROL SET USER statement

Purpose

Set a value in the user data area of a DDT control.

Syntax

CONTROL SET USER hDlg, id&, index&, usrval&

Remarks

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

hDlg refers to the dialog that owns the control.

id& is the unique control identifier as assigned to the control with a CONTROL ADD statement.

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

usrval& is the Long-integer data value to store in the user data area.

Restrictions 

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

See also

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