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

HMSetFont

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

FUNCTION HMSetFont (font: Integer): OSErr;

font

A global font number.

DESCRIPTION

The HMSetFont function sets the font for help balloons in all applications 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 provides a consistent look across applications. If your application uses this function to change the font name or size, the change affects all applications that display help balloons.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the HMSetFont function are

Trap macro	Selector
_Pack14	$0108

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 numbers.