Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 5 - Control Manager / Control Manager Reference

Data Structures

This section describes the control record, the auxiliary control record, the pop-up menu private data record, and the control color table record.

Your application doesn't specifically create the control record, the auxiliary control record, or the pop-up menu private data record; rather, your application simply
creates any necessary resources and uses the appropriate Control Manager routines.
The Control Manager creates these records as necessary.

You can use Control Manager routines to change values in the control record, or you
can access and change its fields yourself; normally, you don't change the values in
the auxiliary control record. However, both the control record and the auxiliary
control record have fields in which your application can store information as you
deem appropriate.

You can obtain the menu handle and the menu ID of the menu associated with a pop-up menu by dereferencing the contrlData field of the control record, which, for pop-up menu controls, contains a handle to a pop-up private data record. This record contains the menu handle and the menu ID for the associated menu.

You use a control color table record only when you want to use nonstandard colors for a control that you create while your application is running. Your application probably shouldn't ever create a control color table record because you should use the system's default colors to ensure consistency of the interface across applications.

---

Subtopics

The Control Record

The Auxiliary Control Record

The Pop-Up Menu Private Data Record

The Control Color Table Record