血常规控件使用说明.doc

血常规控件使用说明作者： 曾 庆 国 日期： 2011-1-18 一、DLL说明：1.1 MFC基础库支持Vs2003运行的基础库，包括 mfc71.dll mfvcr71.dll mfvcp71.dll1.2 PCOMM动态库用于串口操作1.3 BloodRoutineIMDLL动态库血常规接口管理层DLL，采集数据并处理，提供接口方法使控件可以获取19项基本数据、WBC波形、RBC波形以及PLT波形。二、安装注册说明使用控件之前请运行控件目录下 控件注册.bat注册控件，单击运行后若未提示成功，请先检查各dll是否存在，若不存在，请下载最新控件；若全部存在，请联系相关技术人员；三、配置文件说明血常规控件已按规范更改，主要包括： 1、提供规范化的采集和显示接口 2、将xml文件格式按新定义的标准解析/保存 3、保留原有初始化串口方法的同时，在配置文件中增加血常规硬件类型和串口配置项 4、配置文件中增加显示顺序配置项，支持自定义19项血常规基础数据的显示顺序 5、支持自定义窗体、自定义配色方案、自定义字体。配置文件格式如下：/=/文件名：UIConfig.ini/说 明：界面定义配置文件/作 者：zengqingguo/日 期：2010-1-4/公 司：深圳中科强华科技有限公司/备 注：/ 1、该文件为新体检包界面定义文件，包括界面元素的位置、大小、颜色等信息/ 2、其中Nomal Setting为通用格式定义，其中定义了所有通用的设置，如默认字体/ 大小、颜色、标题栏(即姓名栏)的大小及颜色、背景颜色等信息/ 3、其他功能界面主要定义UI元素的位置信息，以及有特殊要求的UI元素格式定义/ 4、所有UI元素的大小、位置均可按比例定义，其真实值为(当前水平/垂直分辨率*比例)，/ 也可按实际像素点个数来定义/ 5、对按钮元素的位置定义，起始位置(x,y)必须定义，宽和高若无定义，则取默认宽和高/ /注意事项：/ 1、颜色定义格式为RGB(r,g,b);若未非Color Setting选项中的定义，也可直接使用其中定义/ 的关键字，如Nomal Setting 中的BgColor定义即为COLOR_GRAY/ 2、字体大小为非负整数/ 3、各UI元素(除按钮)的区域定义格式为(左,上,右,下),即左上和右下的两个顶点的(x,y)坐标/ 4、按钮元素的区域定义为(左,上,宽,高)，若宽、高未定义，则取默认宽度和高度/ (见Nomal Setting -BtnWidth/BtnHeight)/ 5、区域定义可取比例小数和实际像素点数两种情况，但是针对按钮元素，须保证默认宽、高与/ 顶点格式的一致性，若不一致，必须指定宽、高，否则可能导致无法看到该按钮/ 6、比例只能为小数，不能为分数!/版本历史：记录文件修改历史/ 1、2010-12-14 新建 by zengqingguo/ 2、2010-12-15 修改 by zengqingguo 按钮区域定义增加自定义宽、高的功能/=Color Setting /1、颜色定义 格式RGB(r,g,b)COLOR_WHITE = RGB(255,255,255); /白色COLOR_BLACK = RGB(0,0,0); /黑色COLOR_RED = RGB(255,0,0); /红色COLOR_GREEN = RGB(0,255,0); /绿色COLOR_BLUE = RGB(0,0,255); /蓝色COLOR_YELLOW = RGB(255,255,0); /黄色COLOR_GRAY = RGB(55,55,55); /灰色 COLOR_SKYBLUE = RGB(64, 64, 255); /天蓝色COLOR_PINK = RGB(255, 0, 156); /粉红COLOR_PT = RGB(175, 238, 238); /苍白的绿宝石色COLOR_WHITEBLUE = RGB(222,235,252);/背景色 苍白的淡蓝色Nomal Setting /2、通用格式定义BgColor = COLOR_WHITEBLUE /背景颜色 或者直接写RGB(55,55,55) InfoBarBgColor = RGB(211,227,255)/信息框背景色ContentBgColor = COLOR_GRAY/RGB(255,255,220); /内容区域背景色WaveBgColor = COLOR_GRAY/波形背景色TextColor = COLOR_BLACK /字体默认颜色TextFontSize = 12 /默认字体大小TitleColor=COLOR_WHITE /标题颜色TiTleFontSize=16 /标题(姓名栏)字体大小，由于界面风格需统一，将大小定义放在此处BtnBgColor = COLOR_WHITEBLUE /按钮背景色BtnTextColor = COLOR_PINK /按钮字体颜色BtnWidth=0.1 /按钮默认宽度BtnHeight=0.05 /按钮默认高度WindowRect=0,0,1024,768 /弹出窗体的位置CenterPos = 1 /是否居中 1:是 其他否TitleRect=0.02,0.02,0.6,0.1 /标题区域定义 , left top right bottomPath Setting /保存基目录设置xmlPath = D:imagepath /xml保存根目录Com SettingHardwareType = 1 /设备类型 1：美思康 2：优利特Com = 1 /串口号View Setting /自定义19项基础数据显示顺序/基础项数据排列, 119分别代表WBC,Lymph#,Mid#,Gran#,Lymph%,Mid%,Gran%,/RBC,HGB,MCHC,MCV,MCH,RDW_CV,RDW_SD,HCT,PLT,MPV,PDW,PCT ViewArrange = 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19四、控件使用说明4.1 采集接口定义/=/函数名：GatherBloodroutine/说明：调用控件，进行血常规采集/作者：zengqingguo/日期：2011-1-17/入参：sXml为一个标准格式的XML文件的字符串,详细定义参考sample.xml/返回值：为BSTR，格式同参数sXml相同，只是把相应的检查结果补充完整/修改记录：/=BSTR GatherBloodroutine(LPCTSTR sXml);4.2 显示接口定义/=/函数名：ViewBloodroutine/说明：调用控件，进行血常规显示/作者：zengqingguo/日期：2011-1-17/入参：sXml为一个标准格式的XML文件的字符串,详细定义参考sample.xml/ sPath为血常规文件保存路径/返回值：调用成功返回true,失败返回false/修改记录：/=VARIANT_BOOL ViewBloodrou