ExtractPickerHelpItemExtracts and changes the messages and other characteristics of the help balloons for a color picker.
The Color Picker Manager provides help balloons for color picker dialog boxes. For all types of color picker dialog boxes, applications generally don't need to determine or change the default help balloons. However, if your application absolutely requires greater control over Balloon Help, it can use the
ExtractPickerHelpItemfunction to obtain and change the messages and other characteristics of the default help balloons.
pascal OSErr ExtractPickerHelpItem ( picker thePicker, short itemNo, short whichState, HelpItemInfo *helpInfo);
- The color picker whose help balloons you wish to obtain.
- A number corresponding to the position of an item in the item list resource of the color picker's dialog box.
- For menu items and items in alert or dialog boxes, the state of the item specified in the
itemNoparameter. The following constants are used to represent the possible states:
kHMOtherItem. See the chapter "Help Manager" in Inside Macintosh: More Macintosh Toolbox for descriptions of these states for various types of dialog items.
- A pointer to a
HelpItemInfostructure (page 2-32). In the
helpMessagefield of this structure, the Color Picker Manager passes the default help message in an
HMHelpMessagestructure. The Color Picker Manager passes the default characteristics of the help balloon--that is, the value of the
optionselement of its help resource, its tip location, its alternate rectangle, its tip function, and its variation code--in the rest of the fields of the
DISCUSSIONFor the color picker specified in the parameter
ExtractPickerHelpItemfunction reports the messages and other characteristics for its help balloons. If your application needs to override the help message or another help balloon characteristic for the item specified in the
itemNoparameter, your application should specify the desired help message and characteristics in the
HelpItemInfostructure pointed to in the
helpInfoparameter, and then use the Help Manager function
HMShowBalloonto display the altered help balloon.
SEE ALSOListing 2-14 (page 2-27) in Advanced Color Imaging on the Mac OS illustrates how to use this function. See the chapter "Help Manager" in Inside Macintosh: More Macintosh Toolbox for more information about help balloons.