HMSetDialogResID

Set the resource ID for the 'hdlg' template

#include <Balloons.h> Help Manager

short resID; resource ID of the 'hdlg' resource

You can set the resource ID for the 'hdlg' template used to display the

next dialog box using the HMSetDialogResID function.

resID specifies the resource ID of the 'hdlg' resource to use when

displaying the next dialog box or alert box. This supplements

whatever 'hdlg' resource might already be associated with that dialog

box or alert box by a helpItem item in its 'DITL'. Specify -1 in the

resID parameter to reset or clear a previous call to the

Returns: an Error Code.

noErr (0) No error

memFullErr (-108) Not enough room in heap zone

Notes: You can supplement whatever 'hdlg' resources may be

specified in 'DITL' resources by using the HMSetDialogResID

function. The resource you specify in the HMSetDialogResID

function adds to any help that already exists in the form of an 'hdlg'

resource for the next dialog box or alert box to be displayed. If you

create dialog boxes or alert boxes on the fly, you can use an 'hdlg'

resource to provide help balloons for items in a template, and you

can use the HMSetDialogResID function to provide help balloons

for items that you add to your dialog box template. For complete

details, see the section en titled

functions when displaying nested dialog boxes. For example, you can

save the 'hdlg' resource of the current dialog box, set a new 'hdlg'

resource, display the new dialog box, and then restore the setting of the

previous 'hdlg' resource when you close the second dialog box.

Referenced by (7):