Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 3 - Help Manager / Help Manager Reference

Help Manager Routines / Setting and Getting Information for Help Resources

HMSetMenuResID

You can use the HMSetMenuResID function to set the 'hmnu' resource for a menu that did not previously have one or to supplement the existing 'hmnu' resource for a menu.

FUNCTION HMSetMenuResID (menuID, resID: Integer): OSErr;

menuID

The menu to associate with the 'hmnu' resource.

resID

The resource ID of the 'hmnu' resource to use for the menu specified by the menuID parameter.

DESCRIPTION

The resID parameter specifies the resource ID of the 'hmnu' resource to use for the menu specified by the menuID parameter. The menu identified by the menuID parameter should correspond to an existing menu in your menu list. The Help Manager maintains a list of the menus whose 'hmnu' resources you set using the HMSetMenuResID function.

Before your application terminates, specify -1 in the resID parameter to disassociate a particular menu and an 'hmnu' resource that you previously associated using the HMSetMenuResID function.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the HMSetMenuResID function are

Trap macro	Selector
_Pack14	$020D

RESULT CODES

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

SEE ALSO

"Providing Help Balloons for Menus You Disable for Dialog Boxes" beginning on page 3-43 describes how to use HMSetMenuResID to associate an alternate 'hmnu' resource with a menu that your application dims when it displays a dialog box.