HMGetDialogResID

Return the resource ID for the 'hdlg' template

#include <Balloons.h> Help Manager

short *resID; the resource ID of the 'hdlg' resource

You can use the HMGetDialogResID function to get the resource ID

of the 'hdlg' resource that will be used by the next dialog box as a

result of a previous call to the HMSetDialogResID function.

resID the resource ID of the last 'hdlg' resource that was previously set by

calling the HMSetDialogResID function. If the 'hdlg' resource

currently in use was not set by calling the HMSetDialogResID

function, the HMGetDialogResID function returns a result code of

resNotFound.

Returns: an Error Code.

noErr (0) No error

memFullErr (-108) Not enough room in heap zone

resNotFound (-192) Unable to read resource

Notes: If the 'hdlg' resource currently in use has not been overridden by a call to

HMSetDialogResID, the HMGetDialogResID function returns a result

code of resNotFound.

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 (5):