DialogNew Function (ROM Call 0x34)

dialogs.h

HANDLE DialogNew (short width, short height, DialogNew_t UserFunc);

Creates a new dialog box which can interact with the user program.

DialogNew acts like DialogNewSimple, but accepts a pointer to the user function UserFunc as third parameter. This function is called (as far as I know):

Such a user function allows interaction between execution of dialog boxes and the user program, and allows creation of dialog boxes which dynamically change thier properties during execution. I still don't know all the possibilities of such interaction, but what I know is quite enough for creating very complex dialog boxes.

Whenever the user function is called, two parameters (one short and one long, I will call them x and y for simplicity) are passed to it. What I know about them at the moment is: After pressing ENTER in a request box or after execution of a pulldown menu, all items in the dialog will be recreated (and user function will be called for each item accordingly). This allows creating dialogs in which execution of various options in pulldown menus makes some other items in the dialog dimmed or active again.


Uses: HeapAlloc, memset
Used by: DialogNewSimple, DlgMessage, VarNew, VarOpen, VarSaveAs, cmd_dialog, cmd_request, EV_defaultHandler, HomeExecute