#MmiUtil_InputText
#MmiUtil_InputLongText
#MmiUtil_InputNum
#MmiUtil_InputLongNum
#MmiUtil_InputPWD
#MmiUtil_InputAmount
#MmiUtil_InputBcdCode



##函数引用
```
#include "MmiUtil.h"

```

##函数声明
```
/* --------------------------------------------------------------------------
* FUNCTION NAME: MmiUtil_InputText
* DESCRIPTION:   输入字符串(字母和数字)
* PARAMETERS:
*   disp_line (in)  -- 提示信息显示行数
*   msgPrompt (in)  -- 提示信息
*   str       (out) -- 输出字符串
*   min       (in)  -- 输入数据最小长度
*   max       (in)  -- 输入数据最大长度
*   disp_mode (in)  -- 输入数据显示模式(参考DISP_FORMAT定义)
* RETURN:
*			返回值大于0:输入数据长度
*			返回值小于0:INPUT_FAILED/INPUT_TIMEOUT/INPUT_USERABORT
* NOTE:
* -------------------------------------------------------------------------*/
int MmiUtil_InputText(int disp_line, char * msgPrompt, char *str, usint min, usint max, int disp_mode);

/* --------------------------------------------------------------------------
* FUNCTION NAME: MmiUtil_InputLongText
* DESCRIPTION:   输入字符串(字母和数字)，最大长度#define MMI_INPUTTEXT_MAX 256
* PARAMETERS:
*   disp_line (in)  -- 提示信息显示行数
*   msgPrompt (in)  -- 提示信息
*   str       (out) -- 输出字符串
*   min       (in)  -- 输入数据最小长度
*   max       (in)  -- 输入数据最大长度
*   disp_mode (in)  -- 输入数据显示模式(参考DISP_FORMAT定义)
* RETURN:
*			返回值大于0:输入数据长度
*			返回值小于0:INPUT_FAILED/INPUT_TIMEOUT/INPUT_USERABORT
* NOTE:
* -------------------------------------------------------------------------*/
int MmiUtil_InputLongText(int disp_line, char * msgPrompt, char *str, usint min, usint max, int disp_mode);

/* --------------------------------------------------------------------------
* FUNCTION NAME: MmiUtil_InputNum
* DESCRIPTION:   输入数字字符串
* PARAMETERS:
*   disp_line (in)  -- 提示信息显示行数
*   msgPrompt (in)  -- 提示信息
*   str       (out) -- 输出数字串
*   min       (in)  -- 输入数据最小长度
*   max       (in)  -- 输入数据最大长度
*   disp_mode (in)  -- 输入数据显示模式(参考DISP_FORMAT定义)
* RETURN:
*			返回值大于0:输入数据长度
*			返回值小于0:INPUT_FAILED/INPUT_TIMEOUT/INPUT_USERABORT
* NOTE:
* -------------------------------------------------------------------------*/
int MmiUtil_InputNum(int disp_line, char *msgPrompt, char *str, usint min, usint max, int disp_mode);

/* --------------------------------------------------------------------------
* FUNCTION NAME: MmiUtil_InputLongNum
* DESCRIPTION:   输入数字字符串，最大长度#define MMI_INPUTTEXT_MAX 256
* PARAMETERS:
*   disp_line (in)  -- 提示信息显示行数
*   msgPrompt (in)  -- 提示信息
*   str       (out) -- 输出数字串
*   min       (in)  -- 输入数据最小长度
*   max       (in)  -- 输入数据最大长度
*   disp_mode (in)  -- 输入数据显示模式(参考DISP_FORMAT定义)
*			返回值大于0:输入数据长度
*			返回值小于0:INPUT_FAILED/INPUT_TIMEOUT/INPUT_USERABORT
* NOTE:
* -------------------------------------------------------------------------*/
int MmiUtil_InputLongNum(int disp_line, char *msgPrompt, char *str, usint min, usint max, int disp_mode);

/* --------------------------------------------------------------------------
* FUNCTION NAME: MmiUtil_InputPWD
* DESCRIPTION:   输入密码
* PARAMETERS:
*   disp_line (in)  -- 提示信息显示行数
*   msgPrompt (in)  -- 提示信息
*   pwd       (out) -- 输出密码
*   min       (in)  -- 输入数据最小长度
*   max       (in)  -- 输入数据最大长度
*   disp_mode (in)  -- 输入数据显示模式(参考DISP_FORMAT定义)
* RETURN:
*			返回值大于0:输入数据长度
*			返回值小于0:INPUT_FAILED/INPUT_TIMEOUT/INPUT_USERABORT
* NOTE:
* -------------------------------------------------------------------------*/
int MmiUtil_InputPWD(int disp_line, char *msgPrompt, char *pwd, usint min, usint max, int disp_mode);

/* --------------------------------------------------------------------------
* FUNCTION NAME: MmiUtil_InputAmount
* DESCRIPTION:   输入密码
* PARAMETERS:
*   disp_line (in)  -- 提示信息显示行数
*   msgPrompt (in)  -- 提示信息
*   amount    (out) -- 输出金额
*   min       (in)  -- 输入数据最小长度
*   max       (in)  -- 输入数据最大长度
*   disp_mode (in)  -- 输入数据显示模式(参考DISP_FORMAT定义)
* RETURN:
*			返回值大于0:输入数据长度
*			返回值小于0:INPUT_FAILED/INPUT_TIMEOUT/INPUT_USERABORT
* NOTE:
* -------------------------------------------------------------------------*/
int MmiUtil_InputAmount(int disp_line, char * msgPrompt, char *amount, usint min, usint max, int disp_mode);

/* --------------------------------------------------------------------------
* FUNCTION NAME: MmiUtil_InputBcdCode
* DESCRIPTION:   显示提示并输入BCD的字符串.
* PARAMETERS:
*   msgPrompt   (in)   -- 提示,可以为NULL.
*       BcdBuf    (out)  -- 输出缓冲in BCD
*       BcdBytes  (in)   -- 要输入的字节数(in BCD)最大100
*       IsDispOrg (in)   --是否显示原有信息
* RETURN:         >=0 输入的字节个数
* INPUT_OK/INPUT_USERABORT/INPUT_TIMEOUT/INPUT_FAILED
* NOTES:
* ------------------------------------------------------------------------ */
sint MmiUtil_InputBcdCode(int disp_line, char *msgPrompt, byte *BcdBuf,
                          usint BcdBytes, boolean IsDispOrg);
                          

```
##函数返回
```

```

##Sample
```
int demo( void )
{
        if( MmiUtil_InputNum( LINE2, ( char * ) "密钥索引(0-99)", cIndex, 1, 2, RIGHT_JST ) <= 0 )
		{
			return BANK_FAIL;
		}
        .....
}
```

##注意事项

```
1. MmiUtil_InputAmount函数需要注意，可能存在精度问题，例如atol,atof;
2. 
```

##延伸阅读
```
    char szKeyMask[MAX_ALPNUM_KEYS][9] =
    {
        "0- +%_", "1QZqz.\\", "2ABCabc&", "3DEFdef%",
        "4GHIghi*", "5JKLjkl/", "6MNOmno~", "7PRSprs^",
        "8TUVtuv[", "9WXYwxy]", "*,'\":", "#=:$?"
    };
    //看不懂有什么关联？再仔细想想....
```


