Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Color Picker Manager Functions / Creating a Custom Color Picker Dialog Box

AddPickerToDialog
Adds a color picker to an application-owned dialog box.
pascal OSErr AddPickerToDialog (
ApplicationDialogInfo *info, 
picker *thePicker);
info
A pointer to an ApplicationDialogInfo structure (page 2-25).
thePicker
A pointer to the last color picker chosen by the user. Your application often refers to the color picker returned here in subsequent Color Picker Manager functions.

DISCUSSION
The AddPickerToDialog function places the color picker returned in the parameter thePicker inside the dialog box specified by the info parameter. All of your application's dialog items must already appear in the dialog box, because your application may not add dialog items after the dialog box has been created. The dialog box is invisible upon creation; use the SetPickerVisibility function (page 2-40) to make it visible. The Color Picker Manager may change some of the flags in the ApplicationDialogInfo structure (such as those regarding the type of dialog box for the color picker).

SEE ALSO
Listing 2-5 (page 2-13) in Advanced Color Imaging on the Mac OS illustrates how to use the AddPickerToDialog function.