Carbon


GetAuxiliaryControlRecord

Header: Controls.h Carbon status: Supported

Obtains a handle to a control’s auxiliary control structure.

Boolean GetAuxiliaryControlRecord (
    ControlRef theControl, 
    AuxCtlHandle *acHndl
);
theControl

A handle to a control.

acHndl

A pointer to a handle to the auxiliary control structure for the control.

function result

True if your application has changed the default control color table for the given control, either by using SetControlColor or by creating its own control color table. If your application has not changed the default control color table, the function returns false. If you set the parameter theControl to NULL, the system default color table uses the default color table, and GetAuxiliaryControlRecord returns true.0

DISCUSSION

Your application typically doesn’t need to access an auxiliary control structure unless you need its acRefCon field, which your application can use for any purpose.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)