Inside Macintosh: More Macintosh Toolbox /

Chapter 3 - Help Manager / Help Manager Reference

Help Manager Routines / Setting and Getting Information for Help Resources

HMSetDialogResID

You can use the HMSetDialogResID function to set the 'hdlg' resource that specifies help balloons for the next dialog box or alert box.

FUNCTION HMSetDialogResID (resID: Integer): OSErr;

resID

The resource ID of the 'hdlg' resource to use when your application displays the next dialog box or alert box.

DESCRIPTION

The HMSetDialogResID function uses the 'hdlg' resource specified in the resID parameter to supplement whatever 'hdlg' resource might already be associated with the next dialog box or alert box that you display. HMSetDialogResID supplements the help messages specified by a HelpItem item in the next dialog or alert box's item list ('DITL') resource. Specify -1 in the resID parameter to reset or clear a previous call to the HMSetDialogResID function.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the HMSetDialogResID function are

Trap macro	Selector
_Pack14	$010C

RESULT CODES

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

SEE ALSO

You typically use HMSetDialogResID in conjunction with the HMGetDialogResID function, which is described in the following section.