Important: The information in this document is obsolete and should not be used for new development.
Setting and Getting Information for Help ResourcesUsing the
HMScanTemplateItemsfunction, you can set help resources for menus, dialog boxes, or windows of your application that do not currently have help resources associated with them. You can also supplement the
'hdlg'resources currently associated with the menus and dialog boxes of your application by using the
HMSetDialogResIDfunction. You can use the
HMGetMenuResIDfunction to determine the
'hmnu'resource ID associated with a menu.
When you use the
HMSetDialogResIDfunction, you can supplement any
'hdlg'resources that are specified in item list (
'DITL') resources. The resource you specify in the
HMSetDialogResIDfunction adds to any help that already exists in the form of
'hdlg'resource for the next dialog box or alert box to be displayed. You can use an
'hdlg'resource (described in "Providing Help Balloons for Items in Dialog Boxes and Alert Boxes" on page 3-47) to provide help balloons for items common to several dialog boxes and alert boxes, and you can use the
HMSetDialogResIDfunction to provide help balloons for items that you add to individual dialog boxes and alert boxes.
You can use the
HMGetDialogResIDfunction 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
HMSetDialogResIDfunction. If the
'hdlg'resource currently in use has not been overridden by a call to
HMGetDialogResIDfunction returns a result code of
You can use the
HMSetDialogResIDfunctions when displaying nested dialog boxes (although, in general, you should close one dialog box before displaying another). 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.