Linux前台开发文档.doc

前台界面编写说明第 I 条菜单编写说明3第 II 条界面编写说明3节 2.01控件设计说明3一、object_list有以下类型子元素31.UIW_STRING：用于显示和收集包含文字和数字的字符串。32F_String:格式化字符串用于显示和收集需要特殊格式的字符串。例如：电话号码和邮政编码等。43UIW_TEXT:54UIW_DATE:55UIW_TIME:66. UIW_BIGNUM:7UIW_BUTTON：7特殊说明：当此UIW_BUTTON控件发送消息时，有几个特殊的value值列示如下：8UIW_HZ_LIST:8i.共有属性说明：9script_list10b)业务逻辑编写说明(script_list语句编写说明)10语句编写基本原则10script_list语句可用函数有以下几种：11a)控件ID使用方法：11b)Disable：使该控件从窗口上隐藏。12c)Enable：将隐藏的控件显示出来。12d)DisableUp：使该控件的内容不上送。12e)EnableUp：使该控件的内容恢复上送。13f)Query ：发送请求信息，得到应答在窗口控件上显示出来；13g)ShowMessageWin ：发送请求信息，得到应答在窗口上的消息窗口中显示13h)PopMessageWin：发送请求信息，得到应答在新弹出的窗口上显示结果14i)PopNewWin：弹出新窗口14j)SetViewOnly ：使控件只读或可写。14k)ReadPin：从密码小键盘读密码，然后将读到的密码存入当前控件。14l)ReadMag：从磁条读写器读磁条信息，然后将读到的磁条信息存入控件全局变量C#INFMGNT2,C# INFMGNT 3。15m)ReadMagAcct：从磁条读写器读磁条信息，然后将读到的磁条信息存入控件全局变量C# INFMGNT2,C# INFMGNT 3，处理后取出帐号内容存入当前控件。15n)15o)curgoto：光标定位到指定的窗口ID15p)MessageBox：显示消息提示窗口15q)OutPut：文件输出，包括磁条、打印机输出16r)AddComboItem：给combox控件增加选项16s)deleteComboItem：从combox控件中删除选项16t)ShowVTLISTDetail：将vtlist控件中的信息显示在指定的窗口控件中16u)AddDetailToVTLIST：将窗口上与指定的vtlist控件明细字段同名的窗口控件的内容存入vtlist控件17v)UpdatePreviousWinField：根据当前窗口的内容或通讯返回包的内容，更新上一个窗口(从该窗口上弹出的本窗口)的某个控件的内容。17w)UpWinFieldFromPreWin：从上一个窗口取数据然后更新到当前窗口的控件上。17x)ShowOriginalWin：先发查询取回原交易信息，然后显示原交易窗口并显示原交易录入和回显的数据内容。注：原交易窗口名从后台返回。18y)DeleteVTLISTCurrentItem：删除当前窗口上的当前vtlist控件中的当前子项。18z)GetVTLISTCurrentItemData：从当前窗口的当前vtlist控件的当前子项取得相应parm的明细字段的内容。18aa)dlgWindowYesNo：弹出确认继续操作选项窗口。18bb)ClearFlds：清除窗口上指定控件的内容。19cc)SetValue:设置各种变量或控件的值。19dd)GetValue:取得各种变量或控件的值。19ee)SetPromptText 改变PROMPT控件显示的文本内容。19ff)PopCurVtWin：弹出一个新窗口，然后将当前VTLIST控件上的当前值更新到指定的新窗口的控件。19gg)Closeme:关闭指定窗口20hh)ReadPinAndSetTo:将从密码键盘读出的密码放入指定控件20ii)SetPromptText ：改变指定PROMPT控件显示的信息20jj)ExecScript：执行指定名称的script语句20kk)OutToDevice:将spool文件输出至外设。21ll)Auth：弹出授权窗口进行授权操作21c)Combox控件选项参数配置方法216打印配置文件编写说明22a)简介22b)打印配置文件结构说明22例：ybtkh.prt22注释部分23头部指令部分24文件体24a)段落分隔部分24b)段落体部分257通讯中的一些约定26第 I 条 菜单编写说明本程序采取xml格式存储菜单结构内容。建议使用xmlspy等能处理utf-8格式文件的软件进行菜单设计。例1：以上就是一个简单的菜单例子。A)是信息头，任何时候都不可以修改，包括大小写。B)是信息尾，同样任何时候都不可以修改，包括大小写。C) MenuItem是每个具体菜单项的元素名称，一级子元素为一级菜单，二级子元素为二级菜单，其余依次类推。注意：如果没有使用类似xmlspy等的xml编辑工具时，要注意元素的开始和结束必须成对出现。前台所用的菜单文件：menu.xml。第 II 条 界面编写说明节 2.01 控件设计说明界面设计也是采取xml格式，目前由于可视化设计还没有使用的版本，所以跟菜单的设计类似，需要使用xmlspy等能处理utf-8格式的软件进行处理。是信息头，任何时候都不可以修改，包括大小写。是信息尾，同样任何时候都不可以修改，包括大小写。里面只有一个也是唯一一个子元素为window，其下有且只有两个子元素object_list和script_list。一、 object_list有以下类型子元素1. UIW_STRING：用于显示和收集包含文字和数字的字符串。属性有：a) text：键入你想要在这个控件里显示的字符串。b) maxlength：定义此控件可以键入的最大字符数。c) stringID：这个域里的内容用来与其它控件进行区别。（唯一标识）d) stFlags：i. STF_LOWER_CASE：ii. STF_PASSWORD：iii. STF_UPPER_CASE：iv. STF_VARIABLE_NAME：e) woFlags：i. WOF_AUTO_CLEAR:ii. WOF_BORDER:iii. WOF_INVALID:iv. WOF_JUSTIFY_CENTER:v. WOF_JUSTIFY_RIGHT:vi. WOF_MINICELL:vii. WOF_MON_SELECTABLE:viii. WOF_UNANSWERED:ix. WOF_VIEW_ONLY:f) woAdvancedFlags:i. WOAF_NON_CURRENT:2 F_String:格式化字符串用于显示和收集需要特殊格式的字符串。例如：电话号码和邮政编码等。属性有：a) compressedText:b) editMask:c) deleteText:d) stringID:e) woFlags:i. WOF_AUTO_CLEAR:ii. WOF_BORDER:iii. WOF_INVALID:iv. WOF_JUSTIFY_CENTER:v. WOF_JUSTIFY_RIGHT:vi. WOF_MINICELL:vii. WOF_NON_SELECTABLE:viii. WOF_UNANSWERED:f) woAdvancedFlags:i. WOAF_NON_CURRENT:3 UIW_TEXT:1. 选项：a) Vertical Scroll Bar:b) Horizontal Scroll Bar:2. 属性：a) text:b) maxLength:i. stringed:ii. wnFlags:1. WNF_NO_WRAP:iii. woFlags:1. WOF_AUTO_CLEAR:2. WOF_BORDER:3. WOF_INVALID:4. WOF_MINICELL:5. WOF_NON_FIELD_REGION:6. WOF_NON_SELECTABLE:7. WOF_UNANSWERED:8. WOF_VIEW_ONLY:iv. woAdvancedFlags:1. WOAF_NON_CURRENT:4 UIW_DATE:属性：date:Range:stringID:dtFlags:DTF_FLPHA_MONTH:DTF_DASH:DTF_DAY_OF_WEEK:DTF_EUROPEAN_FORMAT:DTF_JAPANESE_FORMAT:DTF_MILITARY_FORMAT:DTF_SHORT_DAY:DTF_SHORT_MONTH:DTF_SHORT_YEAR:DTF_SLASH:DTF_SYSTEM:DTF_UPPER_CASE:DTF_US_FORMAT:DTF_ZERO_FILL:woFlags:WOF_AUTO_CLEAR:WOF_BORDER:WOF_INVALID:WOF_JUSTIFY_CENTER:WOF_JUSTIFY_RIGHT:WOF_MINICELL:WOF_NON_SELECTABLE:WOF_UNANSWERED:WOF_VIEW_ONLY:woAdvancedFlags:WOAF_NON_CURRENT:5 UIW_TIME:属性：a) time:b) range:c) stringID:d) tmFlags:i. TMF_COLON_SEPARATOR:ii. TMF_HUNDEREDTHS:iii. TMF_LOWER_CASE:iv. TMF_NO_HOURS:v. TMF_NO_MINUTES:vi. TMF_NO_SEPARATOR:vii. TMF_SECONDS:viii. TMF_SYSTEM:ix. TMF_TWELVE_HOUR:x. TMF_TWENTY_FOUR_HOUR:xi. TMF_UPPER_CASE:xii. TMF_ZERO_FILL:e) woFlags:i. WOF_AUTO_CLEAR:ii. WOF_BORDER:iii. WOF_INVALID:iv. WOF_JUSTIFY_CENTER:v. WOF_JUSTIFY_RIGHT:vi. WOF_MINICELL:vii. WOF_NON_SELECTABLE:viii. WOF_UNANSWERED:f) woAdvancedFlags:i. WOAF_NON_CURRENT:6.UIW_BIGNUM:属性：a) bignum:b) range:c) stringID:d) nmFlags:i. NMF_COMMAS:ii. NMF_CREDIT:iii. NMF_CURRENCY:iv. NMF_PERCENT:v. NMF_DECIMAL(0):vi. NMF_DECIMAL(1):vii. NMF_DECIMAL(2):viii. NMF_DECIMAL(3):ix. NMF_DECIMAL(4):x. NMF_DECIMAL(5):xi. NMF_DECIMAL(6):xii. NMF_DECIMAL(7):xiii. NMF_DECIMAL(8):xiv. NMF_DECIMAL(9):e) woFlags:i. WOF_AUTO_CLEAR:ii. WOF_BORDER:iii. WOF_INVALID:iv. WOF_JUSTIFY_CENTER:v. WOF_JUSTIFY_RIGHT:vi. WOF_MINICELL:vii. WOF_NON_SELECTABLE:viii. WOF_UNANSWERED:ix. WOF_VIEW_ONLY:f) woAdvancedFlags:i. WOAF_NON_CURRENT:UIW_BUTTON：属性有：a) text:b) value:c) stringID:d) btFlags:i. BTF_AUTO_SIZE:ii. BTF_CHECK_BOX:iii. BTF_DOUBLE_CLICK:iv. BTF_DOWN_CLICK:v. BTF_NO_TOGGLE:vi. BTF_NO_3D:vii. BTF_RADIO_BUTTON:viii. BTF_REPEAT:ix. BTF_SEND_MESSAGE:e) woFlags:i. WOF_BORDER:ii. WOF_JUSTIFY_CENTER:iii. WOF_JUSTIFY_RIGHT:iv. WOF_MINICELL:v. WOF_NON_FIELD_REGION:vi. WOF_NON_SELECTABLE:f) woAdvancedFlags:i. WOAF_NON_CURRENT:特殊说明：当此UIW_BUTTON控件发送消息时，有几个特殊的value值列示如下：5555：与后台通讯，执行output语句，有通讯成功提示，执行完后关闭当前窗口。5556：与后台通讯，不执行output语句，没有通讯成功提示，执行完后不关闭当前窗口。5557：与后台通讯，执行output语句，有通讯成功提示，执行完后不关闭当前窗口。UIW_HZ_LIST:属性：a) cellWidth:b) cellHeight:c) stringID:d) objects:e) Options:i. Horizontal Scroll Bar:f) wnFlags:i. WNF_AUTO_SELECT:ii. WNF_AUTO_SORT:iii. WNF_BITMAP_CHILDREN:iv. WNF_CONTINUE_SELECT:v. WNF_NO_WRAP:vi. WNF_SELECT_MULTIPLE:g) woFlags:i. WOF_BORDER:ii. WOF_MINICELL:iii. WOF_MON_FIELD_REGION:iv. WOF_NON_SELECTABLE:1) UIW_COMBO_BOX（列表框）：属性有：wnFlags、woFlags。2) UIW_PROMPT（提示信息）：属性有：text、woFlags。3) （数字框）：属性有：range、value、nmFlags、woFlags、Exportflag（如果有这个Exportflag属性并且值不未0时，组上传包时去掉小数点）。UIW_VT_LIST:属性：Fielddef: 例：transequ :trantype=20|RIGHT,acctnumb=16,curycode=2说明：字段名称“：”前面表示。转义别名：“：”后面“”前面，表示在窗口上显示此字段时按此名字到parm.ini里进行转义。字段长度：“”号后面，“|”号前面，字段的最大长度，超出部分将被自动截掉。字段显示类型：“|”号后面，下一个字段描述前面，该字段的显示类型，目前有：RIGHT（右对齐），DATE1（转成“YYYY/MM/DD”日期格式），DATE2(转成“YYYY年MM月DD日”格式)。i. 共有属性说明：1) text：初始化控件的时候在控件里显示的内容。2) maxlength：输入内容时可以输入的最大长度。3) value：在控件上按回车时触发该消息值。5555向后台发通讯然后处理返回结果。4) stFlags:STF_LOWER_CASE小写。STF_PASSWORD密码输入方式。STF_UPPER_CASE大写。5) btFlags:BTF_AUTO_SIZE自动调整尺寸。BTF_CHECK_BOX复选框。BTF_RADIO_BUTTON单选按钮。BTF_REPEAT重复输入。BTF_SEND_MESSAGE发送消息。6) wnFlags:WNF_AUTO_SELECT自动选择。WNF_AUTO_SORT自动排序。7) nmFlags: NMF_COMMAS逗号分隔。NMF_CREDIT信用卡格式。NMF_CURRENCY货币格式。NMF_DECIMAL(0)无小数位。NMF_DECIMAL(1)一位小数位。NMF_DECIMAL(2)两位小数位。NMF_DECIMAL(3)三位小数位。NMF_DECIMAL(4)四位小数位。NMF_DECIMAL(5)五位小数位。NMF_DECIMAL(6)六位小数位。NMF_DECIMAL(7)七位小数位。NMF_DECIMAL(8)八位小数位。NMF_DECIMAL(9)九位小数位。8) woFlags:WOF_AUTO_CLEAR自动清除。WOF_BORDER带边框。WOF_JUSTIFY_CENTER居中显示。WOF_JUSTIFY_RIGHT靠右显示。WOF_NON_SELECTABLE不可以操作。WOF_VIEW_ONLY只读。script_list 1) script_list有且只有一类子元素script，子元素script有 name、stringID、type和script几个属性。name属性表示script的种类。stringID属性表示在哪个控件上满足触发条件时才会触发该逻辑语句。Type属性表示该触发控件的控件类型。Script属性表示具体的逻辑语句，编写方法见下面“业务逻辑编写说明”。2) script根据name属性的不同分成以下几类：1. InitScript：初始化窗口的时候触发该逻辑语句。2. EnterScript：当在控件上按Enter键的时候触发该逻辑语句。3. BeforeTx：在向后台发通讯之前触发该逻辑语句。4. AfterTx：在后台返回执行结果后触发该逻辑语句。5. ChangeScript：控件内容发生变化时触发该逻辑语句，窗口初始化的时候同样触发该逻辑语句。6. DeleteScript：当按下delete键时触发该逻辑语句。7. QueryMoreDetail：当在vtlist控件上按下箭头或PAGE DN键时触发。8. reprbook：当打印prt文件的type属性为printcz时，如果返回包里的nxprflag字段的值为1，则触发该语句继续打印。主要用于打印存则未登折信息时使用。9. DestroyScript：当按ESC键或当前窗口执行完毕，将要退出时触发该逻辑语句。10. SpaceScript：当按下空格键时触发该逻辑语句。11. MessageChangeCurrent：当按下F7键时触发该逻辑语句，目前主要用于进行新旧帐号转换。逻辑语句设计方法参见下面说明。b) 业务逻辑编写说明(script_list语句编写说明)语句编写基本原则只有if else条件分支语句（用法参见c语言），可以使用常量、窗口ID和函数，每条语句都以分号结束，字符串常量要用"扩起来，如字符串test要写成"test"。例：if(CUSTNO=1) disable(TRANAM);else enable(TRANAM)可以使用算术表达式（不可以给窗口ID赋值）、逻辑表达式。目前支持的运算符包括：+加、-减、*乘、/除、=等于、!=不等于、大于、=大于等于、小于、要被更新的窗口控件ID|当前窗口控件ID要被更新的窗口控件ID.）2） 参数说明：a) 要更新控件内容的窗口ID：其实就是弹出当前窗口的上一个窗口的ID。b) 要被更新的窗口控件ID：要更新的控件ID.c) 当前窗口控件ID：更新时的数据内容来源于当前窗口，该参数指定从当前窗口的哪个控件取值。3） 例：UpdatePreviousWinField(opencurr1,r#custnumbcustnumb| r#custnumbcustnumb| r#custnumbcustnumb)w) UpWinFieldFromPreWin：从上一个窗口取数据然后更新到当前窗口的控件上。1） 用法：UpWinFieldFromPreWin（上一个窗口ID,上一个窗口中的数据来源控件ID当前窗口控件ID|上一个窗口中的数据来源控件ID当前窗口控件ID.）2） 参数说明：d) 当前窗口控件ID：当前窗口上要更新数据的控件ID。e) 上一个窗口ID：数据来源控件ID所在的窗口ID。f) 上一个窗口中的数据来源控件ID：数据来源控件ID。3） 例：UpWinFieldFromPreWin (CUST,KPCNSTCUST| KPCNSTCUST)x) ShowOriginalWin：先发查询取回原交易信息，然后显示原交易窗口并显示原交易录入和回显的数据内容。注：原交易窗口名从后台返回。1） 用法：ShowOriginalWin（查询时的处理码,需要上传的控件ID，回传需要显示的控件ID）2） 参数说明：a) 查询时的处理码：取原交易信息时使用的处理码。b) 需要上传的控件ID：取原交易信息时需要上传的控件ID.c) 回传需要显示的控件ID：原交易信息返回时需要在原交易窗口上显示出原交易信息的窗口ID。 3） 例：ShowOriginalWin(gtcnfmif,:affmsequ,all)y) DeleteVTLISTCurrentItem：删除当前窗口上的当前vtlist控件中的当前子项。1） 用法：DeleteVTLISTCurrentItem（没有参数）2） 例：DeleteVTLISTCurrentItem ()z) GetVTLISTCurrentItemData：从当前窗口的当前vtlist控件的当前子项取得相应parm的明细字段的内容。1） 用法：GetVTLISTCurrentItemData（明细字段名）2） 参数说明：明细字段名：vtlist空降中的明细字段名称，在fielddef中定义的字段名。3） 例：GetVTLISTCurrentItemData (acct)aa) dlgWindowYesNo：弹出确认继续操作选项窗口。1） 用法：dlgWindowYesNo（窗口标题内容，窗口提示信息内容）2） 参数说明：窗口标题内容：弹出的窗口的标题信息。窗口提示信息内容：在弹出的窗口中显示出来的信息内容。3） 例：dlgWindowYesNo (错误信息窗口，是否继续操作)bb) ClearFlds：清除窗口上指定控件的内容。1） 用法：ClearFlds（窗口ID）2） 参数说明：窗口ID要清除内容的窗口控件ID，多个要显示的控件ID用”|”分隔。3） 例：ClearFlds (acct|name)cc) SetValue:设置各种变量或控件的值。1） 用法：SetValue（变量名，变量值）2） 参数说明：变量名要设置内容的变量名或窗口ID。变量值要设置的内容。3） 例：SetValue (c#sysdate,"name")dd) GetValue:取得各种变量或控件的值。1） 用法：GetValue（变量名）2） 参数说明：变量名要取得内容的变量名或窗口ID。返回值取得的变量的内容。3） 例：GetValue (c#sysdate)ee) SetPromptText改变PROMPT控件显示的文本内容。1） 用法：SetPromptText（窗口PROMPT控件ID,新显示内容）2） 参数说明：窗口PROMPT控件ID名要改变显示内容的窗口PROMPT控件ID。新显示内容要显示的内容。3） 例：SetPromptText (a3,hello)ff) PopCurVtWin：弹出一个新窗口，然后将当前VTLIST控件上的当前值更新到指定的新窗口的控件。1）用法：PopCurVtWin（新窗口ID,VTLIST字段名:新窗口上的控件ID| VTLIST字段名:新窗口上的控件ID）2）参数说明：新窗口ID要弹出的新窗口名。VTLIST字段名当前窗口FIELDDEF中定义的明细字段名称。新窗口上的控件ID=新弹出的窗口上的控件ID。3）例：PopCurVtWin (1021,trandate:trandate1|transequ:transequ)gg) Closeme:关闭指定窗口1）用法：Closeme（窗口ID或空）2）参数说明：窗口ID要关闭的窗口名，如果没有则默认为当前窗口。3）例：Closeme (1021)或Closeme ()。hh) ReadPinAndSetTo:将从密码键盘读出的密码放入指定控件1）用法：ReadPinAndSetTo（窗口控件ID，读取次数）2）参数说明：窗口控件ID要将读到的密码放入的控件ID。读取次数读取密码的次数。2读取2次，其它读取一次。3）例：ReadPinAndSetTo (PSWD,2)或ReadPinAndSetTo (PSWD)。ii) SetPromptText ：改变指定PROMPT控件显示的信息1）用法：SetPromptText（PROMPT控件ID，新信息）2）参数说明：PROMPT控件ID要改变显示信息的PROMPT控件ID。新信息要显示出来的新的显示信息。3）例：SetPromptText (a1,密码)。jj) ExecScript：执行指定名称的script语句1）用法：ExecScript（script语句名）2）参数说明：script语句名想要执行的script语句的名称，