Important: The information in this document is obsolete and should not be used for new development.
HMSetBalloons
To enable or disable Balloon Help assistance for the user, use theHMSetBalloons
function.
FUNCTION HMSetBalloons (flag: Boolean): OSErr;
flag
- Specifies whether help should be enabled or disabled for all applications and the system software.
DESCRIPTION
If the value of theflag
parameter isTRUE
,HMSetBalloons
enables Balloon Help assistance. If the value of theflag
parameter isFALSE
,HMSetBalloons
disables Balloon Help assistance. If a help balloon is showing, you must first remove it using theHMRemoveBalloon
function before you useHMSetBalloons
to disable Balloon Help assistance.SPECIAL CONSIDERATIONS
When Balloon Help assistance is disabled, the Help Manager does not display help balloons for any applications. When help is disabled, theHMShowBalloon
andHMShowMenuBalloon
functions do not display help balloons; they return nonzero result codes.Because the setting of Balloon Help assistance should be under the user's control, you generally should not use the
HMSetBalloons
function.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theHMSetBalloons
function are
Trap macro Selector _Pack14 $0104 RESULT CODES
noErr 0 No error paramErr -50 Error in parameter list memFullErr -108 Not enough room in heap zone resNotFound -192 Unable to read resource SEE ALSO
The description of theHMShowBalloon
function begins on page 3-93; the description of theHMShowMenuBalloon
function begins on page 3-96.