 |
Dialog |
Function (ROM Call 0x30) |
Shows and activates a dialog box given a pointer to a dialog structure.
Dialog works exactly like DialogDo, except instead of the
handle, a pointer to the dialog structure is given as the parameter.
DialogDo internally calls HeapDeref,
then passes returned pointer to Dialog function. This function is manly used
internally in TIOS. Its advantage compared to DialogDo is
in the fact that the complete dialog structure may be given as a static pre-filled
array of butes, and you can give the pointer to such structure to Dialog function.
It will save a lot of memory, because you need not to call DialogNew,
a lot of functions like DialogAddText etc. But note that
the dialog structure is an extremely complicated variable-shape structure, so if you
don't know EXACTLY what you are doing, avoid this function!
Uses: HeapGetLock, HeapLock, HeapUnlock, ER_catch, ER_success, ER_throwVar, ERD_dialog, EV_captureEvents, EV_eventLoop, EV_paintWindows, EV_restorePainting, EV_suspendPainting, DrawStrWidth, DrawStrWidthP, FontCharWidth, FontGetSys, FontSetSys, alphaLockOff, alphaLockOn, GKeyIn, restoreAlphaLock, OSWriteLinkBlock, memset, MenuEnd, MenuOn, MenuPopup, MenuUpdate, ST_eraseHelp, strlen, CU_restore, CU_stop, OSSetSR, OSTimerRestart, XR_stringPtr, TE_close, TE_focus, TE_open, TE_openFixed, TE_select, TE_shrinkWrap, TE_unfocus, clear_error_context, sf_width, RectWinToScr, WinActivate, WinAttr, WinCharXY, WinClose, WinFill, WinFont, WinOpen, WinRect, WinStrXY, _du16u16, ROM Call 0x41C, ROM Call 0x41D, ROM Call 0x41E, ROM Call 0x471, ROM Call 0x4D7, ROM Call 0x5C6
Used by: DialogDo, cmd_clrtable, EV_defaultHandler, handleRclKey, MO_modeDialog, HomeExecute, LIO_Receive, TE_handleEvent, GT_DE_Init_Conds, GT_Format, GZ_SetFactors, SP_Define, ROM Call 0x45E, ROM Call 0x5F1
See also: DialogDo