source: xtideuniversalbios/trunk/Assembly_Library/Src/Menu/Dialog/DialogString.asm @ 596

; Project name  :   Assembly Library
; Description   :   Displays word input dialog.

;
; XTIDE Universal BIOS and Associated Tools
; Copyright (C) 2009-2010 by Tomi Tilli, 2011-2013 by XTIDE Universal BIOS Team.
;
; This program is free software; you can redistribute it and/or modify
; it under the terms of the GNU General Public License as published by
; the Free Software Foundation; either version 2 of the License, or
; (at your option) any later version.
;
; This program is distributed in the hope that it will be useful,
; but WITHOUT ANY WARRANTY; without even the implied warranty of
; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
; GNU General Public License for more details.
; Visit http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
;

; Section containing code
SECTION .text

;--------------------------------------------------------------------
; DialogString_GetStringWithIoInDSSI
;   Parameters:
;       DS:SI:  Ptr to STRING_DIALOG_IO
;       SS:BP:  Ptr to parent MENU
;   Returns:
;       Nothing
;   Corrupts registers:
;       AX, BX, CX, DX, DI
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
DialogString_GetStringWithIoInDSSI:
    mov     bx, StringEventHandler
    mov     BYTE [si+STRING_DIALOG_IO.bUserCancellation], TRUE
    jmp     Dialog_DisplayWithDialogInputInDSSIandHandlerInBX


;--------------------------------------------------------------------
; StringEventHandler
;   Common parameters for all events:
;       BX:         Menu event (anything from MENUEVENT struct)
;       SS:BP:      Ptr to DIALOG
;   Common return values for all events:
;       CF:         Set if event processed
;                   Cleared if event not processed
;   Corrupts registers:
;       All
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
StringEventHandler:
    jmp     [cs:bx+.rgfnEventHandlers]


ALIGN JUMP_ALIGN
.InitializeMenuinitFromDSSI:
    xor     ax, ax
    jmp     Dialog_EventInitializeMenuinitFromDSSIforSingleItemWithHighlightedItemInAX


ALIGN JUMP_ALIGN
.IdleProcessing:
    xor     cx, cx                      ; Item 0 is used as input line
    call    MenuText_AdjustDisplayContextForDrawingItemFromCX
    call    GetStringFromUser
    call    MenuInit_CloseMenuWindow
    stc
    ret


ALIGN WORD_ALIGN
.rgfnEventHandlers:
istruc MENUEVENT
    at  MENUEVENT.InitializeMenuinitFromDSSI,   dw  .InitializeMenuinitFromDSSI
    at  MENUEVENT.ExitMenu,                     dw  Dialog_EventExitMenu
    at  MENUEVENT.IdleProcessing,               dw  .IdleProcessing
    at  MENUEVENT.ItemHighlightedFromCX,        dw  Dialog_EventNotHandled
    at  MENUEVENT.ItemSelectedFromCX,           dw  Dialog_EventNotHandled
    at  MENUEVENT.KeyStrokeInAX,                dw  Dialog_EventNotHandled
    at  MENUEVENT.RefreshTitle,                 dw  Dialog_EventRefreshTitle
    at  MENUEVENT.RefreshInformation,           dw  Dialog_EventRefreshInformation
    at  MENUEVENT.RefreshItemFromCX,            dw  Dialog_EventNotHandled
iend


;--------------------------------------------------------------------
; GetStringFromUser
;   Parameters
;       SS:BP:  Ptr to DIALOG
;   Returns:
;       Nothing (User input stored to STRING_DIALOG_IO)
;   Corrupts registers:
;       AX, CX, DX, SI, DI
;--------------------------------------------------------------------
ALIGN JUMP_ALIGN
GetStringFromUser:
    lds     si, [bp+DIALOG.fpDialogIO]
    mov     cx, [si+STRING_DIALOG_IO.wBufferSize]
    les     di, [si+STRING_DIALOG_IO.fpReturnBuffer]
    mov     dx, [si+STRING_DIALOG_IO.fnCharFilter]
    test    dx, dx
    jnz     SHORT .CharacterFilterFunctionInDX
    mov     dx, Char_CharIsValid

.CharacterFilterFunctionInDX:
    call    Keyboard_ReadUserInputtedStringToESDIWhilePrinting
    jz      SHORT .UserCancellation

    mov     BYTE [si+STRING_DIALOG_IO.bUserCancellation], FALSE
    mov     [si+STRING_DIALOG_IO.wReturnLength], cx
.UserCancellation:
    ret