| 1 | ; File name : menudlg.asm
|
|---|
| 2 | ; Project name : Menu library
|
|---|
| 3 | ; Created date : 17.11.2009
|
|---|
| 4 | ; Last update : 4.12.2009
|
|---|
| 5 | ; Author : Tomi Tilli
|
|---|
| 6 | ; Description : ASM library to menu system.
|
|---|
| 7 | ; Contains functions for displaying input dialogs.
|
|---|
| 8 |
|
|---|
| 9 | ;--------------- Equates -----------------------------
|
|---|
| 10 |
|
|---|
| 11 | ; Dialog init and return variables.
|
|---|
| 12 | ; This is an expanded MSGVARS struct.
|
|---|
| 13 | struc DLGVARS
|
|---|
| 14 | .msgVars resb MSGVARS_size
|
|---|
| 15 |
|
|---|
| 16 | ; Dialog parameters for different dialogs
|
|---|
| 17 | .wCXPrm:
|
|---|
| 18 | .wPrmBase: ; Numeric base for DWORD dialog (10=dec, 16=hex...)
|
|---|
| 19 | .wBuffLen resb 2 ; Buffer length for string dialog (with STOP included)
|
|---|
| 20 | .dwBuffPtr resb 4 ; Far pointer to buffer to receive string
|
|---|
| 21 |
|
|---|
| 22 | ; Return variables for different dialogs
|
|---|
| 23 | .dwReturn:
|
|---|
| 24 | .dwRetDW: ; DWORD inputted by user
|
|---|
| 25 | .wRetLen resb 4 ; Length of string inputted by user (chars without STOP)
|
|---|
| 26 | .fSuccess resb 1 ; Was data inputted successfully by user
|
|---|
| 27 | resb 1 ; Alignment
|
|---|
| 28 | endstruc
|
|---|
| 29 |
|
|---|
| 30 |
|
|---|
| 31 | ;-------------- Private global variables -------------
|
|---|
| 32 | ; Section containing initialized data
|
|---|
| 33 | ;SECTION .data
|
|---|
| 34 |
|
|---|
| 35 | g_strYN: db "Y/N: ",STOP ; For asking Y/N input
|
|---|
| 36 |
|
|---|
| 37 |
|
|---|
| 38 | ;-------------- Public functions ---------------------
|
|---|
| 39 | ; Section containing code
|
|---|
| 40 | SECTION .text
|
|---|
| 41 |
|
|---|
| 42 | ;--------------------------------------------------------------------
|
|---|
| 43 | ; Displays dialog.
|
|---|
| 44 | ;
|
|---|
| 45 | ; MenuDlg_Show
|
|---|
| 46 | ; Parameters:
|
|---|
| 47 | ; BL: Dialog width with borders included
|
|---|
| 48 | ; CX: Word parameter for dialog event handler
|
|---|
| 49 | ; DX: Offset to dialog event handler
|
|---|
| 50 | ; SS:BP: Ptr to MENUVARS
|
|---|
| 51 | ; DS:SI Pointer parameter for dialog event handler
|
|---|
| 52 | ; ES:DI: Ptr to STOP terminated string to display
|
|---|
| 53 | ; Returns:
|
|---|
| 54 | ; DX:AX: User inputted data
|
|---|
| 55 | ; CF: Set if user data inputted successfully
|
|---|
| 56 | ; Cleared is input cancelled
|
|---|
| 57 | ; Corrupts registers:
|
|---|
| 58 | ; BX, CX
|
|---|
| 59 | ;--------------------------------------------------------------------
|
|---|
| 60 | ALIGN JUMP_ALIGN
|
|---|
| 61 | MenuDlg_Show:
|
|---|
| 62 | ; Create stack frame
|
|---|
| 63 | eENTER DLGVARS_size, 0
|
|---|
| 64 | sub bp, DLGVARS_size ; Point to DLGVARS
|
|---|
| 65 |
|
|---|
| 66 | ; Initialize menu variables
|
|---|
| 67 | mov [bp+MENUVARS.bWidth], bl ; Menu width
|
|---|
| 68 | mov WORD [bp+MENUVARS.wTopDwnH], 0100h ; Title and Info size
|
|---|
| 69 | mov [bp+MENUVARS.fnEvent], dx ; Store handler offset
|
|---|
| 70 | mov [bp+MSGVARS.wStrOff], di ; Store far ptr...
|
|---|
| 71 | mov [bp+MSGVARS.wStrSeg], es ; ...to string to display
|
|---|
| 72 | mov [bp+DLGVARS.wCXPrm], cx ; Store word parameter
|
|---|
| 73 | mov [bp+DLGVARS.dwBuffPtr], si ; Store far pointer...
|
|---|
| 74 | mov [bp+DLGVARS.dwBuffPtr+2], ds ; ...parameter
|
|---|
| 75 |
|
|---|
| 76 | ; Enter menu
|
|---|
| 77 | call MenuMsg_GetLineCnt ; Get message line count to CX
|
|---|
| 78 | mov ax, CNT_SCRN_ROW-4 ; Load max line count without borders and info
|
|---|
| 79 | MIN_U ax, cx ; String lines to display to AX
|
|---|
| 80 | add al, 4 ; Add borders for dlg height
|
|---|
| 81 | mov [bp+MENUVARS.bHeight], al ; Store dialog height
|
|---|
| 82 | call MenuCrsr_GetCenter ; Get X and Y coordinates to DX
|
|---|
| 83 | xor ax, ax ; Selection timeout (disable)
|
|---|
| 84 | mov bl, FLG_MNU_NOARRW ; Menu flags
|
|---|
| 85 | call Menu_Init ; Returns only after dlg closed
|
|---|
| 86 | call MenuCrsr_Hide ; Hide cursor again
|
|---|
| 87 |
|
|---|
| 88 | ; Return
|
|---|
| 89 | mov ax, [bp+DLGVARS.dwReturn] ; Load return loword
|
|---|
| 90 | mov dx, [bp+DLGVARS.dwReturn+2] ; Load return hiword
|
|---|
| 91 | mov bl, [bp+DLGVARS.fSuccess] ; Load success flag
|
|---|
| 92 | add bp, DLGVARS_size ; Point to old BP
|
|---|
| 93 | eLEAVE ; Destroy stack frame
|
|---|
| 94 | rcr bl, 1 ; Move success flag to CF
|
|---|
| 95 | ret
|
|---|
| 96 |
|
|---|
| 97 |
|
|---|
| 98 | ;-------------- Private functions ---------------------
|
|---|
| 99 |
|
|---|
| 100 | ;--------------------------------------------------------------------
|
|---|
| 101 | ; DWORD input dialog event handler.
|
|---|
| 102 | ;
|
|---|
| 103 | ; MenuDlg_DWEvent
|
|---|
| 104 | ; Parameters:
|
|---|
| 105 | ; BX: Callback event
|
|---|
| 106 | ; CX: Selected menuitem index
|
|---|
| 107 | ; DX: Event parameter (event specific)
|
|---|
| 108 | ; SS:BP: Ptr to DLGVARS
|
|---|
| 109 | ; Returns:
|
|---|
| 110 | ; AH: Event specific or unused
|
|---|
| 111 | ; AL: 1=Event processed
|
|---|
| 112 | ; 0=Event not processed (default action if any)
|
|---|
| 113 | ; Corrupts registers:
|
|---|
| 114 | ; BX, CX, DX
|
|---|
| 115 | ;--------------------------------------------------------------------
|
|---|
| 116 | ALIGN JUMP_ALIGN
|
|---|
| 117 | MenuDlg_DWEvent:
|
|---|
| 118 | cmp bx, EVNT_MNU_UPD ; Update strings?
|
|---|
| 119 | jne MenuDlg_JmpToMsgEvnt ; If not, use message handler
|
|---|
| 120 | test dl, MFL_UPD_NFO ; Update info strings?
|
|---|
| 121 | jz MenuDlg_JmpToMsgEvnt ; If not, use message handler
|
|---|
| 122 |
|
|---|
| 123 | ; Get user input instead of drawing info strings
|
|---|
| 124 | call MenuCrsr_Show ; Show cursor during input
|
|---|
| 125 | mov cx, [bp+DLGVARS.wPrmBase] ; Load numeric base to CX
|
|---|
| 126 | eMOVZX dx, [bp+MENUVARS.bWidth] ; Load dialog width
|
|---|
| 127 | sub dx, 4 ; Subtract borders for max char count
|
|---|
| 128 | call Keys_PrintGetUint ; Get DWORD
|
|---|
| 129 | mov [bp+DLGVARS.dwRetDW], ax ; Store return loword
|
|---|
| 130 | mov [bp+DLGVARS.dwRetDW+2], dx ; Store return hiword
|
|---|
| 131 | rcl BYTE [bp+DLGVARS.fSuccess], 1 ; Set or clear success flag
|
|---|
| 132 |
|
|---|
| 133 | ; Exit menu
|
|---|
| 134 | ALIGN JUMP_ALIGN
|
|---|
| 135 | MenuDlg_ExitHandler:
|
|---|
| 136 | or BYTE [bp+MENUVARS.bFlags], FLG_MNU_EXIT
|
|---|
| 137 | mov ax, 1
|
|---|
| 138 | ret
|
|---|
| 139 |
|
|---|
| 140 | ALIGN JUMP_ALIGN
|
|---|
| 141 | MenuDlg_JmpToMsgEvnt:
|
|---|
| 142 | jmp MenuMsg_MsgEvent
|
|---|
| 143 |
|
|---|
| 144 |
|
|---|
| 145 | ;--------------------------------------------------------------------
|
|---|
| 146 | ; Y/N dialog event handler.
|
|---|
| 147 | ;
|
|---|
| 148 | ; MenuDlg_YNEvent
|
|---|
| 149 | ; Parameters:
|
|---|
| 150 | ; BX: Callback event
|
|---|
| 151 | ; CX: Selected menuitem index
|
|---|
| 152 | ; DX: Event parameter (event specific)
|
|---|
| 153 | ; SS:BP: Ptr to DLGVARS
|
|---|
| 154 | ; Returns:
|
|---|
| 155 | ; AH: Event specific or unused
|
|---|
| 156 | ; AL: 1=Event processed
|
|---|
| 157 | ; 0=Event not processed (default action if any)
|
|---|
| 158 | ; Corrupts registers:
|
|---|
| 159 | ; BX, CX, DX
|
|---|
| 160 | ;--------------------------------------------------------------------
|
|---|
| 161 | ALIGN JUMP_ALIGN
|
|---|
| 162 | MenuDlg_YNEvent:
|
|---|
| 163 | cmp bx, EVNT_MNU_UPD ; Update strings?
|
|---|
| 164 | jne MenuDlg_JmpToMsgEvnt ; If not, use message handler
|
|---|
| 165 | test dl, MFL_UPD_NFO ; Update info strings?
|
|---|
| 166 | jz MenuDlg_JmpToMsgEvnt ; If not, use message handler
|
|---|
| 167 |
|
|---|
| 168 | ; Draw info string
|
|---|
| 169 | push ds
|
|---|
| 170 | push cs
|
|---|
| 171 | pop ds
|
|---|
| 172 | mov dx, g_strYN ; Y/N string in DS:DX
|
|---|
| 173 | PRINT_STR
|
|---|
| 174 | pop ds
|
|---|
| 175 |
|
|---|
| 176 | ; Wait for user input
|
|---|
| 177 | call MenuCrsr_Show ; Show cursor during input
|
|---|
| 178 | call Keys_PrintGetYN
|
|---|
| 179 | mov [bp+DLGVARS.dwReturn], ax ; Store return char
|
|---|
| 180 | rcl BYTE [bp+DLGVARS.fSuccess], 1 ; Set or clear Y/N flag
|
|---|
| 181 | jmp MenuDlg_ExitHandler
|
|---|
| 182 |
|
|---|
| 183 |
|
|---|
| 184 | ;--------------------------------------------------------------------
|
|---|
| 185 | ; String dialog event handler.
|
|---|
| 186 | ;
|
|---|
| 187 | ; MenuDlg_StrEvent
|
|---|
| 188 | ; Parameters:
|
|---|
| 189 | ; BX: Callback event
|
|---|
| 190 | ; CX: Selected menuitem index
|
|---|
| 191 | ; DX: Event parameter (event specific)
|
|---|
| 192 | ; SS:BP: Ptr to DLGVARS
|
|---|
| 193 | ; Returns:
|
|---|
| 194 | ; AH: Event specific or unused
|
|---|
| 195 | ; AL: 1=Event processed
|
|---|
| 196 | ; 0=Event not processed (default action if any)
|
|---|
| 197 | ; Corrupts registers:
|
|---|
| 198 | ; BX, CX, DX
|
|---|
| 199 | ;--------------------------------------------------------------------
|
|---|
| 200 | ALIGN JUMP_ALIGN
|
|---|
| 201 | MenuDlg_StrEvent:
|
|---|
| 202 | cmp bx, EVNT_MNU_UPD ; Update strings?
|
|---|
| 203 | jne MenuDlg_JmpToMsgEvnt ; If not, use message handler
|
|---|
| 204 | test dl, MFL_UPD_NFO ; Update info strings?
|
|---|
| 205 | jz MenuDlg_JmpToMsgEvnt ; If not, use message handler
|
|---|
| 206 |
|
|---|
| 207 | ; Get string from user
|
|---|
| 208 | push es
|
|---|
| 209 | push di
|
|---|
| 210 | call MenuCrsr_Show ; Show cursor during input
|
|---|
| 211 | mov bx, .VerifyChar ; Load offset to char verify function
|
|---|
| 212 | mov dx, [bp+DLGVARS.wBuffLen] ; Load buffer length
|
|---|
| 213 | mov di, [bp+DLGVARS.dwBuffPtr] ; Load buffer offset
|
|---|
| 214 | mov es, [bp+DLGVARS.dwBuffPtr+2]; Load buffer segment
|
|---|
| 215 | call Keys_GetStrToBuffer ; Get string from user
|
|---|
| 216 | mov [bp+DLGVARS.wRetLen], ax ; Store string length
|
|---|
| 217 | rcl BYTE [bp+DLGVARS.fSuccess], 1 ; Set or clear success flag
|
|---|
| 218 | pop di
|
|---|
| 219 | pop es
|
|---|
| 220 | jmp MenuDlg_ExitHandler
|
|---|
| 221 | ALIGN JUMP_ALIGN
|
|---|
| 222 | .VerifyChar:
|
|---|
| 223 | stc ; Set CF to allow all chars
|
|---|
| 224 | ret
|
|---|
