Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

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 macroSelector
_Pack14$020D

RESULT CODES
noErr0No error
memFullErr-108Not 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.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996