Important: The information in this document is obsolete and should not be used for new development.
HMGetDialogResID
You can use theHMGetDialogResID
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 theHMSetDialogResID
function.
FUNCTION HMGetDialogResID (VAR resID: Integer): OSErr;
resID
- The resource ID of the last
'hdlg'
resource set with theHMSetDialogResID
function.DESCRIPTION
TheHMGetDialogResID
function returns in itsresID
parameter the resource ID of the last'hdlg'
resource set with theHMSetDialogResID
function.You can use the
HMGetDialogResID
andHMSetDialogResID
functions when your application displays nested dialog boxes (although you should generally 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.If the
'hdlg'
resource currently in use was not set by a call to theHMSetDialogResID
function, theHMGetDialogResID
function returns a result code ofresNotFound
.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theHMGetDialogResID
function are
Trap macro Selector _Pack14 $0213 RESULT CODES
noErr 0 No error memFullErr -108 Not enough room in heap zone resNotFound -192 Unable to read resource SEE ALSO
You typically useHMGetDialogResID
in conjunction with theHMSetDialogResID
function, which is described on page 3-110.