Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 3 - Help Manager / Help Manager Reference

Help Manager Routines / Getting and Setting the Font Name and Size

HMSetFontSize

You can use the HMSetFontSize function to specify the font size used to display text in help balloons.

FUNCTION HMSetFontSize (fontSize: Integer): OSErr;

fontSize

The global font size the Help Manager uses to display text in help balloons.

DESCRIPTION

The HMSetFontSize function sets the font size for help balloons in all applications and software that display help balloons. This function applies only to Pascal strings stored in the help resources themselves and to strings from 'STR#' and 'STR ' resources; it does not apply to text in 'PICT' or styled text resources, or in handles to either of these resources.

SPECIAL CONSIDERATIONS

Use this function with extreme restraint, because the default font size provides a consistent look across applications. If your application uses this function to change the font size, the change affects all applications that display help balloons.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the HMSetFontSize function are

Trap macro	Selector
_Pack14	$0109

RESULT CODES

noErr	0	No error
memFullErr	-108	Not enough room in heap zone

SEE ALSO

See the chapter "TextEdit" in Inside Macintosh: Text for detailed information about fonts and font sizes.