Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Color Picker-Defined Functions / Responding to Requests to Return and Set Color Picker Information

MySetPrompt

Color picker-defined subroutine that handles a kSetPrompt request.

If you create a color picker, it must respond to the kSetPrompt request code. The Color Picker Manager sends this code to set the prompt string used by your color picker. A color picker responds to the kSetPrompt request code by calling a color picker-defined subroutine (for example, MySetPrompt) to handle the request.

pascal ComponentResult MySetPrompt (
PickerStorageHndl storage, 
Str255 prompt);

storage

A handle to your color picker's global data.

prompt

The new prompt string for your color picker.

DISCUSSION

Your MySetPrompt function should set the prompt for your color picker to the one specified in the prompt parameter.

Your function should return noErr if successful, or an appropriate result code otherwise.

SEE ALSO

Listing 2-28 (page 2-44) in Advanced Color Imaging on the Mac OS illustrates how to implement this function.