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

MyGetPrompt

Color picker-defined subroutine that handles a kGetPrompt request.

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

pascal ComponentResult MyGetPrompt (
PickerStorageHndl storage, 
Str255 prompt);

storage

A handle to your color picker's global data.

prompt

Your color picker's prompt string.

DISCUSSION

Your MyGetPrompt function should return the current prompt for your color picker in the prompt parameter.

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

SEE ALSO

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