Balloon Help for Icons
Balloon Help for Icons
The Finder offers Balloon Help on-line assistance for users. After the user
chooses Show Balloons from the Help menu, de scriptive help balloons appear
when the user moves the cursor to an area of the screen (such as a menu, a
window control, or a dialog box) that has a help resource associated with it.
The Finder provides default help balloons for application, control panel,
system extension, and desk accessory icons. You can provide a customized help
balloon for your application, control panel, system extension, or desk
accessory icon by adding an 'hfdr' resource with resource ID -5696 to the
resource fork of your application. The following figure compares the default
help balloon with a customized help balloon for a sample application icon.
Default and customized help balloons for application icons
The following program shows the Finder help override resource and its
associated 'STR ' resource that are used for the customized help balloon in this
figure.
Creating a help balloon resource for an application icon
resource 'hfdr' (-5696, purgeable) { /* help for app icon */
HelpMgrVersion, hmDefaultOptions, 0, 0, /* header information */
{
HMSTRResItem { /* use 'STR ' resource 1001 */
1001
}
}
};
resource 'STR ' (1001, purgeable) { /* help message for app icon */
"Use the SurfWriter word processor to create or edit the most
"radical documents ever written on your Macintosh computer.
};
Note: You cannot override the default help balloon that the Finder uses
for document icons.
The Help Manager describes in detail how to provide Balloon Help for your
application icon and for other elements of your application.