Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 5 - Control Manager / Control Manager Reference

Control Manager Routines / Determining Control Values

SetControlReference

To change a control's current reference value, use the SetControlReference procedure. The SetControlReference procedure is also available as the SetCRefCon procedure.

PROCEDURE SetControlReference (theControl: ControlHandle; 
                               data: LongInt);

theControl

A handle to the control whose reference value you wish to change.

data

The new reference value for the control.

DESCRIPTION

The SetControlReference procedure sets the control's reference value to the value you specify in the data parameter.

When you create a control, you specify an initial reference value, either in the
control resource or in the refCon parameter of the NewControl function. The
reference value is stored in the contrlRfCon field of the control record; you can
use the GetControlReference function to determine the current value. You
can use this value for any purpose.