[41] | 1 | ; Project name : Assembly Library
|
---|
| 2 | ; Description : Defines for Menu library.
|
---|
| 3 | %ifndef MENU_INC
|
---|
| 4 | %define MENU_INC
|
---|
| 5 |
|
---|
| 6 | ;--------------------------------------------------------------------
|
---|
[525] | 7 | ; Menu Library users need to use these macros since it will provide
|
---|
[41] | 8 | ; compatibility with future library versions.
|
---|
| 9 | ;
|
---|
| 10 | ; CALL_MENU_LIBRARY
|
---|
[525] | 11 | ; JMP_MENU_LIBRARY
|
---|
[41] | 12 | ; Parameters:
|
---|
| 13 | ; %1: Function to call (functionName from MENU_LIB)
|
---|
| 14 | ; BP: Menu handle
|
---|
| 15 | ; Registers: Depends on function to call
|
---|
| 16 | ; Returns:
|
---|
| 17 | ; Depends on function to call
|
---|
| 18 | ; Corrupts registers:
|
---|
| 19 | ; AX (unless used as a return register), DI
|
---|
| 20 | ;--------------------------------------------------------------------
|
---|
| 21 | %macro CALL_MENU_LIBRARY 1
|
---|
[205] | 22 | %ifidn %1, CloseMenuIfExitEventAllows
|
---|
| 23 | call MenuInit_CloseMenuIfExitEventAllows
|
---|
| 24 | %elifidn %1, Close
|
---|
[41] | 25 | call MenuInit_CloseMenuWindow
|
---|
| 26 | %elifidn %1, SetUserDataFromDSSI
|
---|
| 27 | call MenuInit_SetUserDataFromDSSI
|
---|
| 28 | %elifidn %1, GetUserDataToDSSI
|
---|
| 29 | call MenuInit_GetUserDataToDSSI
|
---|
| 30 | %elifidn %1, SetTitleHeightFromAL
|
---|
| 31 | call MenuInit_SetTitleHeightFromAL
|
---|
[48] | 32 | %elifidn %1, GetHighlightedItemToAX
|
---|
| 33 | call MenuInit_GetHighlightedItemToAX
|
---|
[41] | 34 | %elifidn %1, SetTotalItemsFromAX
|
---|
| 35 | call MenuInit_SetTotalItemsFromAX
|
---|
| 36 | %elifidn %1, SetInformationHeightFromAL
|
---|
| 37 | call MenuInit_SetInformationHeightFromAL
|
---|
| 38 | %elifidn %1, SetTimeoutValueFromAX
|
---|
| 39 | call MenuTime_SetSelectionTimeoutValueFromAX
|
---|
| 40 | %else
|
---|
[177] | 41 | mov di, %1
|
---|
[41] | 42 | call Menu_FunctionFromDI
|
---|
| 43 | %endif
|
---|
| 44 | %endmacro
|
---|
| 45 |
|
---|
[525] | 46 | %macro JMP_MENU_LIBRARY 1
|
---|
| 47 | %ifidn %1, CloseMenuIfExitEventAllows
|
---|
| 48 | jmp MenuInit_CloseMenuIfExitEventAllows
|
---|
| 49 | %elifidn %1, Close
|
---|
| 50 | jmp MenuInit_CloseMenuWindow
|
---|
| 51 | %elifidn %1, SetUserDataFromDSSI
|
---|
| 52 | jmp MenuInit_SetUserDataFromDSSI
|
---|
| 53 | %elifidn %1, GetUserDataToDSSI
|
---|
| 54 | jmp MenuInit_GetUserDataToDSSI
|
---|
| 55 | %elifidn %1, SetTitleHeightFromAL
|
---|
| 56 | jmp MenuInit_SetTitleHeightFromAL
|
---|
| 57 | %elifidn %1, GetHighlightedItemToAX
|
---|
| 58 | jmp MenuInit_GetHighlightedItemToAX
|
---|
| 59 | %elifidn %1, SetTotalItemsFromAX
|
---|
| 60 | jmp MenuInit_SetTotalItemsFromAX
|
---|
| 61 | %elifidn %1, SetInformationHeightFromAL
|
---|
| 62 | jmp MenuInit_SetInformationHeightFromAL
|
---|
| 63 | %elifidn %1, SetTimeoutValueFromAX
|
---|
| 64 | jmp MenuTime_SetSelectionTimeoutValueFromAX
|
---|
| 65 | %else
|
---|
| 66 | mov di, %1
|
---|
| 67 | jmp Menu_FunctionFromDI
|
---|
| 68 | %endif
|
---|
| 69 | %endmacro
|
---|
| 70 |
|
---|
[177] | 71 | %if 0
|
---|
| 72 | ;;;
|
---|
| 73 | ;;; struc no longer needed with direct call to function
|
---|
| 74 | ;;;
|
---|
| 75 |
|
---|
[41] | 76 | ; Menu library functions
|
---|
| 77 | struc MENU_LIB
|
---|
| 78 | .DisplayWithHandlerInBXandUserDataInDXAX resb 2
|
---|
[205] | 79 | .SendExitMenuEvent:
|
---|
[41] | 80 | .Close:
|
---|
| 81 | .RefreshWindow resb 2
|
---|
| 82 |
|
---|
| 83 | .SetUserDataFromDSSI:
|
---|
| 84 | .GetUserDataToDSSI:
|
---|
| 85 |
|
---|
| 86 | .SetTitleHeightFromAL:
|
---|
[48] | 87 | .ClearTitleArea resb 2
|
---|
[41] | 88 | .RefreshTitle resb 2
|
---|
| 89 |
|
---|
[48] | 90 | .GetHighlightedItemToAX:
|
---|
[41] | 91 | .HighlightItemFromAX resb 2
|
---|
| 92 | .SetTotalItemsFromAX:
|
---|
| 93 | .RefreshItemFromAX resb 2
|
---|
| 94 |
|
---|
| 95 | .SetInformationHeightFromAL:
|
---|
[48] | 96 | .ClearInformationArea resb 2
|
---|
[41] | 97 | .RefreshInformation resb 2
|
---|
| 98 |
|
---|
[370] | 99 | %ifndef EXCLUDE_FROM_XTIDECFG
|
---|
[60] | 100 | .StartSelectionTimeoutWithTicksInAX resb 2
|
---|
[370] | 101 | %endif
|
---|
[41] | 102 |
|
---|
| 103 | %ifdef INCLUDE_MENU_DIALOGS
|
---|
| 104 | .StartProgressTaskWithIoInDSSIandParamInDXAX resb 2
|
---|
| 105 | .SetProgressValueFromAX resb 2
|
---|
| 106 |
|
---|
| 107 | .DisplayMessageWithInputInDSSI resb 2
|
---|
| 108 | .GetSelectionToAXwithInputInDSSI resb 2
|
---|
| 109 | .GetWordWithIoInDSSI resb 2
|
---|
| 110 | .GetStringWithIoInDSSI resb 2
|
---|
| 111 | .GetFileNameWithIoInDSSI resb 2
|
---|
[54] | 112 | .GetDriveWithIoInDSSI resb 2
|
---|
[41] | 113 | %endif
|
---|
| 114 | endstruc
|
---|
[177] | 115 | %endif
|
---|
[41] | 116 |
|
---|
| 117 | ; Menu initialization parameters
|
---|
| 118 | struc MENUINIT
|
---|
| 119 | .wItems resb 2 ; Number of items in menu
|
---|
[52] | 120 | .wHighlightedItem resb 2 ; Index for highlighted item
|
---|
[41] | 121 |
|
---|
| 122 | .wTitleAndInfoLines:
|
---|
| 123 | .bTitleLines resb 1 ; Number of title lines
|
---|
| 124 | .bInfoLines resb 1 ; Number of information lines
|
---|
| 125 |
|
---|
| 126 | .wWidthAndHeight:
|
---|
| 127 | .bWidth resb 1 ; Menu width in characters
|
---|
| 128 | .bHeight resb 1 ; Menu height in characters
|
---|
| 129 | endstruc
|
---|
| 130 |
|
---|
| 131 |
|
---|
| 132 | ; All menu parameters
|
---|
| 133 | struc MENU
|
---|
| 134 | .menuInit resb MENUINIT_size ; Must be first
|
---|
| 135 | .fnEventHandler resb 2 ; Offset to Menu event handler
|
---|
| 136 | .dwUserData resb 4 ; User specified data
|
---|
| 137 |
|
---|
| 138 | .bFlags resb 1 ; Menu flags
|
---|
[45] | 139 | resb 1
|
---|
[41] | 140 | .wTimeoutCounter resb 2
|
---|
| 141 | .wFirstVisibleItem resb 2 ; Index for first visible item on the menu
|
---|
| 142 | endstruc
|
---|
| 143 |
|
---|
| 144 | ; Flags for MENU.wFlags
|
---|
| 145 | FLG_MENU_EXIT EQU (1<<0) ; Close and exit menu
|
---|
| 146 | FLG_MENU_NOHIGHLIGHT EQU (1<<1) ; Never highlight items
|
---|
| 147 | FLG_MENU_USER_HANDLES_SCROLLING EQU (1<<2)
|
---|
[60] | 148 | FLG_MENU_TIMEOUT_COUNTDOWN EQU (1<<3) ; Timeout countdown in progress
|
---|
[41] | 149 |
|
---|
| 150 |
|
---|
| 151 | MENU_VERTICAL_BORDER_LINES EQU 5 ; Title top and bottom + Info top and bottom + bottom shadow
|
---|
| 152 | MENU_HORIZONTAL_BORDER_LINES EQU 3 ; Left + Right borders + Right shadow
|
---|
| 153 | MENU_TEXT_ROW_OFFSET EQU 1
|
---|
| 154 | MENU_TEXT_COLUMN_OFFSET EQU 2
|
---|
[105] | 155 | MENU_TIMEOUT_STRING_CHARACTERS EQU 19
|
---|
[62] | 156 | MENU_TIMEOUT_SECONDS_FOR_HURRY EQU 3
|
---|
[41] | 157 |
|
---|
[44] | 158 | SCROLL_TRACK_CHARACTER EQU BLOCK_EVEN_BACKGROUND_AND_FOREGROUND
|
---|
| 159 | SCROLL_THUMB_CHARACTER EQU BLOCK_FULL_FOREGROUND
|
---|
[41] | 160 |
|
---|
[592] | 161 | ;NO_ITEM_SELECTED EQU -1
|
---|
[41] | 162 | NO_ITEM_HIGHLIGHTED EQU -1
|
---|
[48] | 163 | NO_TIMEOUT_USED EQU 0
|
---|
[41] | 164 |
|
---|
| 165 |
|
---|
| 166 | ; Keyboard keys (scan codes) used by menu library
|
---|
[178] | 167 | ;MENU_KEY_ENTER EQU 1Ch
|
---|
| 168 | ;MENU_KEY_ESC EQU 01h
|
---|
[41] | 169 | MENU_KEY_UP EQU 48h
|
---|
| 170 | MENU_KEY_DOWN EQU 50h
|
---|
| 171 | MENU_KEY_PGUP EQU 49h
|
---|
| 172 | MENU_KEY_PGDN EQU 51h
|
---|
| 173 | MENU_KEY_HOME EQU 47h
|
---|
| 174 | MENU_KEY_END EQU 4Fh
|
---|
| 175 |
|
---|
| 176 |
|
---|
| 177 | %endif ; MENU_INC
|
---|