Important: The information in this document is obsolete and should not be used for new development.
Determining Control Values
Your application sets a control's various values--such as current setting, minimum and maximum settings, title, reference value, and action procedure--when it creates the control. When the user clicks a control, however, your application often needs to determine the current setting and other possible values of that control. When the user clicks a checkbox, for example, your application must determine whether the box is checked before deciding whether to draw a checkmark inside the checkbox or remove the checkmark.You can use the
GetControlValue
,GetControlTitle
,GetControlMinimum
,GetControlMaximum
,GetControlAction
, andGetControlReference
routines to determine, respectively, a control's current setting, title, minimum setting, maximum setting, action procedure, and reference value. To get a handle to a control's auxiliary control record, you can use theGetAuxiliaryControlRecord
function; your application can use theacRefCon
field of an auxiliary control record for any purpose. To determine the variation code that is specified in the control definition function for a particular control, you can use theGetControlVariant
function. This section also includes a description of theSetControlReference
procedure, which allows your application to change its reference value for a control.
Subtopics
- GetControlValue
- GetControlMinimum
- GetControlMaximum
- GetControlTitle
- GetControlReference
- SetControlReference
- GetControlAction
- GetControlVariant
- GetAuxiliaryControlRecord