Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 5 - Control Manager / Control Manager Reference

Control Manager Routines / Determining Control Values

GetControlReference

To determine a control's current reference value, use the GetControlReference function. The GetControlReference function is also available as the GetCRefCon function.

FUNCTION GetControlReference (theControl: ControlHandle): LongInt;

theControl

A handle to the control whose current reference value you wish
to determine.

DESCRIPTION

The GetControlReference function returns as its function result the current reference value for the specified control.

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 this field for any purpose, and you can use the SetControlReference procedure, described next, to change this value.