教程不断更新中：http://www.armbbs.cn/forum.php?mod=viewthread&tid=98429
第13章 emWin6.x数值显示
本章节为大家讲解emWin的数值显示，含二进制，十进制，十六进制和浮点数值的显示，这些函数的调用相对比较容易，但是调用时，要了解这些函数的使用注意事项。
学习本章节，务必保证已经学习了第9章或者第10章以及第11章。本章节提供的模拟器演示代码都是可以在模拟器上面运行的，使用方法是将SWIPELIST_Demo.c文件里面的所有内容删掉并将本章节提供的代码复制到SWIPELIST_Demo.c文件即可运行。
13.1 初学者重要提示
13.2 显示十进制数值
13.3 显示十六进制和二进制数值
13.4 显示浮点数值
13.5 总结
13.1 初学者重要提示
- 就当前的使用经验来说，数值显示函数在项目中使用不太方便，主要是因为数值显示函数要注意的事项较多，每次使用都需要查看不同函数的不同注意事项。大部分情况下，我们都是使用C标准库中的sprintf函数将数值转换成字符串，然后通过上个章节讲解的文本显示函数来显示。这种方式简单好用，实际项目中比较推荐。
- 数值显示的所有API函数在emWin手册中都有讲解，下图是中文版手册里面API函数的位置
下图是是英文版手册里面API函数的位置：
- 数值显示涉及到的函数较多，初学者不需要将这些函数都掌握，会使用几个常用的函数即可。以后项目中需要用到其它函数功能了，再查阅emWin手册并了解其用法后实际测试即可。
- 数值显示就是一些API函数的调用，没有多深的技术需要掌握，对于这一点，初学者要明白。
- 如果时间充裕，可以自行在模拟器上面测试几个教程中没有用到的函数练练手。
13.2 显示十进制数值
13.2.1 函数GUI_DispDec()
函数原型：
void GUI_DispDec(I32 v, /* 数值 */ U8 Len) /* 数值的位数 */
函数描述：
函数GUI_DispDec用于显示十进制数值。
- 第1个参数是要显示的数值，范围是32位有符号数，最小值-2^31，最大值2^31 – 1。
- 第2个参数是要显示数值的位数，如果是负数的话，前面的负号也算在内。
使用这个函数要注意以下问题：
- 使用此函数时，数值的首位不能是0，是0的话显示会出现错误。显示负数的话，负号也要算在数值位数里面。
- 设置的数值位数大于实际显示的数值位数，前面会补0。
- 设置的数值位数小于实际显示的数值位数，会出现错误。
使用举例：
在emWin模拟器上面运行如下代码：
#include "GUI.h" void MainTask(void) { /* 初始化 */ GUI_Init(); /* 设置数值显示字体 */ GUI_SetFont(&GUI_Font24B_ASCII); GUI_GotoXY(0, 0); GUI_DispDec(-123, 4); GUI_GotoXY(0, 30); GUI_DispDec(012, 4); GUI_GotoXY(0, 60); GUI_DispDec(1234, 7); /* 设置的显示位数为2，小于实际的数值位数，导致错误，所以未显示 */ GUI_GotoXY(0, 90); GUI_DispDec(1234, 2); while (1) { GUI_Delay(10); } }
实际显示效果如下：
13.2.2 函数GUI_DispDecAt()
函数原型：
void GUI_DispDecAt(I32 v, /* 数值 */ I16P x, /* x坐标位置 */ I16P y, /* y坐标位置 */ U8 Len);/* 数值的位数 */
函数描述：
函数GUI_DispDecAt用于显示十进制数值，相比函数GUI_DispDec的区别就是可以设置数值的显示位置。
- 第1个参数是要显示的数值，范围是32位有符号数，最小值-2^31，最大值2^31 – 1。
- 第2个参数是数值显示X坐标位置。
- 第3个参数是数值显示Y坐标位置。
- 第4个参数是要显示数值的位数，如果是负数的话，前面的负号也算在内。
使用这个函数要注意以下问题：
- 使用此函数时，数值的首位不能是0，是0的话显示会出现错误。显示负数的话，负号也要算在数值位数里面。
- 设置的数值位数大于实际显示的数值位数，前面会补0。
- 设置的数值位数小于实际显示的数值位数，会出现错误。
使用举例：
在emWin模拟器上面运行如下代码：
#include "GUI.h" void MainTask(void) { /* 初始化 */ GUI_Init(); /* 设置数值显示字体 */ GUI_SetFont(&GUI_Font24B_ASCII); GUI_DispDecAt(-123, 0, 0, 5); GUI_DispDecAt(045, 0, 30, 3); GUI_DispDecAt(345, 0, 60, 5); /* 设置的显示位数为2，小于实际的数值位数，导致错误，所以未显示 */ GUI_DispDecAt(345, 0, 90, 2); while (1) { GUI_Delay(10); } }
实际显示效果如下：
13.2.3 函数GUI_DispDecMin()
函数原型：
void GUI_DispDecMin(I32 v); /* 要显示的数值 */
函数描述：
函数GUI_DispDecMin用于显示十进制数值，使用时不需要指定显示的位数。
- 第1个参数是要显示的数值，范围是32位有符号数，最小值-2^31，最大值2^31 – 1。
使用这个函数要注意以下问题：
- 使用这个函数不需要指定长度，会自动的使用最少的位数显示，如果显示数值的位数不一样，使用这个函数是无法对齐显示的。
- 这个函数的参数首位也不可以是0，是0的话也会出现错位。
使用举例：
在emWin模拟器上面运行如下代码：
#include "GUI.h" void MainTask(void) { /* 初始化 */ GUI_Init(); /* 设置数值显示字体 */ GUI_SetFont(&GUI_Font24B_ASCII); GUI_GotoXY(0, 0); GUI_DispDecMin(-33232); GUI_GotoXY(0, 30); GUI_DispDecMin(0032); GUI_GotoXY(0, 60); GUI_DispDecMin(00330); GUI_GotoXY(0, 90); GUI_DispDecMin(5980); while (1) { GUI_Delay(10); } }
实际显示效果如下：
13.2.4 函数GUI_DispDecShift()
函数原型：
void GUI_DispDecShift(I32 v, /* 数值 */ U8 Len, /* 数值的位数 */ U8 Shift); /* 小数点右侧显示的位数 */
函数描述：
函数GUI_DispDecShift用于显示十进制数值，支持带小数点显示，且小数点位置可调整。
- 第1个参数是要显示的数值，范围是32位有符号数，最小值-2^31，最大值2^31 – 1。
- 第2个参数是要显示数值的位数，最大可以填10。
- 第3个参数设置小数点右侧显示的位数。
使用这个函数要注意以下问题：
- 使用此函数时，数值的首位不能是0，是0的话显示会出现错误。负号和小数点都要算在数值位数内，最大可以显示9个字符出来。
- 设置的数值位数大于实际显示的数值位数，前面会补0。
- 设置的数值位数小于实际显示的数值位数，会出现错误。
使用举例：
在emWin模拟器上面运行如下代码：
#include "GUI.h" void MainTask(void) { /* 初始化 */ GUI_Init(); /* 设置数值显示字体 */ GUI_SetFont(&GUI_Font24B_ASCII); GUI_GotoXY(0,0); /* 由于设置了显示位数是4，而实际的显示12.34，即5个字符， 使用错误，导致此选项没有显示出来。 */ GUI_DispDecShift(1234,4,2); GUI_GotoXY(0,30); GUI_DispDecShift(01234,6,2); GUI_GotoXY(0,60); GUI_DispDecShift(-1234,6,2); GUI_GotoXY(0,90); GUI_DispDecShift(1234,5,2); GUI_GotoXY(0,120); /* 由于设置了显示位数是9，而实际的显示1234567.89，即10个字符， 使用错误，导致此选项没有显示出来。 */ GUI_DispDecShift(123456789,9,2); GUI_GotoXY(0,150); GUI_DispDecShift(12345678,9,2); while (1) { GUI_Delay(10); } }
实际显示效果如下：
13.2.5 函数GUI_DispSDec()
函数原型：
void GUI_DispSDec(I32 v, /* 数值 */ U8 Len); /* 数值的位数 */
函数描述：
函数GUI_DispSDec用于显示十进制数值，类似GUI_DispDec，区别是不管是正数还是负数，都带符号。
- 第1个参数是要显示的数值，范围是32位有符号数，最小值-2^31，最大值2^31 – 1。
- 第2个参数是要显示数值的位数，不管是正数还是负数，符号都算在内。
使用这个函数要注意以下问题：
- 使用此函数时，数值的首位不能是0，是0的话显示会出现错误。
- 设置的数值位数大于实际显示的数值位数，前面会补0。
- 设置的数值位数小于实际显示的数值位数，会出现错误。
使用举例：
在emWin模拟器上面运行如下代码：
#include "GUI.h" void MainTask(void) { /* 初始化 */ GUI_Init(); /* 设置数值显示字体 */ GUI_SetFont(&GUI_Font24B_ASCII); GUI_GotoXY(0, 0); GUI_DispSDec(-1234, 6); GUI_GotoXY(0, 30); GUI_DispSDec(1234, 5); /* 设置的数值位数3, 小于实际显示的数值位数，导致显示错误 */ GUI_GotoXY(0, 60); GUI_DispSDec(1234, 3); GUI_GotoXY(0, 90); GUI_DispSDec(0234, 5); while (1) { GUI_Delay(10); } }
实际显示效果如下：
13.2.6 函数GUI_DispSDecShift()
函数原型：
void GUI_DispSDecShift(I32 v, /* 数值 */ U8 Len, /* 数值的位数 */ U8 Shift); /* 小数点右侧显示的位数 */
函数描述：
函数GUI_DispSDecShift用于显示十进制数值，类似GUI_DispDecShift，区别是不管是正数还是负数，都带符号。
- 第1个参数是要显示的数值，范围是32位有符号数，最小值-2^31，最大值2^31 – 1。
- 第2个参数是要显示数值的位数，最大可以填10。
- 第3个参数设置小数点右侧显示的位数。
使用这个函数要注意以下问题：
- 使用此函数时，数值的首位不能是0，是0的话显示会出现错误。正号，负号和小数点都要算在数值位数内，最大可以显示9个字符出来。
- 设置的数值位数大于实际显示的数值位数，前面会补0。
- 设置的数值位数小于实际显示的数值位数，会出现错误。
使用举例：
在emWin模拟器上面运行如下代码：
#include "GUI.h" void MainTask(void) { /* 初始化 */ GUI_Init(); /* 设置数值显示字体 */ GUI_SetFont(&GUI_Font24B_ASCII); GUI_GotoXY(0, 0); GUI_DispSDecShift(02345, 7, 3); GUI_GotoXY(0, 30); GUI_DispSDecShift(345, 6, 2); /* 设置的数值位数3, 小于实际显示的数值位数，导致显示错误 */ GUI_GotoXY(0, 60); GUI_DispSDecShift(12345, 3, 3); GUI_GotoXY(0, 90); GUI_DispSDecShift(-1234, 6, 3); while (1) { GUI_Delay(10); } }
实际显示效果如下：
13.3 显示十六进制和二进制数值
二进制和十六进制主要有以下四个函数，相对比较简单。
- void GUI_DispBin(U32 v, U8 Len);
显示二进制数值，设置的显示位数大于实际的数值位数，前面补零，小于的话，设置的位数是多少个就显示几个。
- void DispBinAt(U32 v, I16P y, I16P x, U8 Len);
支持设置二进制数的显示坐标位置，设置的显示位数大于实际的数值位数，前面补零，小于的话，设置的位数是多少个就显示几个。
- void GUI_DispHex(U32 v, U8 Len);
显示十六进制数值，设置的显示位数大于实际的数值位数，前面补零，小于的话，设置的位数是多少个就显示几个。
- void GUI_DispHexAt(U32 v, I16P x, I16P y, U8 Len);
支持设置二进制数的显示坐标位置，设置的显示位数大于实际的数值位数，前面补零，小于的话，设置的位数是多少个就显示几个。
---------------------------------------------------------------------------------------------------------
在emWin模拟器上面运行如下代码：
#include "GUI.h" void MainTask(void) { /* 初始化 */ GUI_Init(); /* 设置数值显示字体 */ GUI_SetFont(&GUI_Font24B_ASCII); /* 设置显示数值 */ GUI_GotoXY(0,140); GUI_DispBin(0x08,8); GUI_GotoX(100); GUI_DispBin(0x88,9); GUI_GotoX(200); GUI_DispBin(0x08,6); GUI_GotoX(300); GUI_DispBin(0x08,2); GUI_DispBinAt(0x55,0,160,8); GUI_DispBinAt(0x55,100,160,7); GUI_DispBinAt(0x05,200,160,4); GUI_DispBinAt(0x05,300,160,16); ; while (1) { GUI_Delay(10); } }
实际显示效果如下：
13.4 显示浮点数值
浮点数值显示主要有以下五个函数：
- void GUI_DispFloat(float v, char Len);
浮点数值显示，要显示的浮点数前面不可以是0，浮点数的小数点也要算在显示位数里面，如果要显示的浮点数是负数，负号也是要显示出来的。
- void GUI_DispFloatFix (float v, char Len, char Decs);
浮点数值显示，与函数GUI_DispFloat的区别是支持设置小数点后面数值的位数，其余相同。
- void GUI_DispFloatMin(float f, char Fract);
浮点数值显示，与函数GUI_DispFloat的区别是支持设置显示最少的字符数，其余相同。
- void GUI_DispSFloatFix(float v, char Len, char Decs);
浮点数值显示，与函数GUI_DispFloat的区别是支持设置小数点后面数值的位数，且不管是显示正数还是显示负数，都带符号位，其余相同。
- void GUI_DispSFloatMin(float f, char Fract);
浮点数值显示，与函数GUI_DispFloat的区别是支持设置显示最少的字符数，且不管是显示正数还是显示负数，都带符号位，其余相同。
---------------------------------------------------------------------------------------------------------
在emWin模拟器上面运行如下代码：
#include "GUI.h" void MainTask(void) { float f = 123.45678f; /* 初始化 */ GUI_Init(); /* 设置数值显示字体 */ GUI_SetFont(&GUI_Font8x8); /* 设置显示数值 */ GUI_Clear(); GUI_DispStringAt("GUI_DispFloat: ",0,0); GUI_DispFloat (f,9); GUI_GotoX(100); GUI_DispFloat (-f,9); GUI_DispStringAt("GUI_DispFloatFix: ",0,20); GUI_DispFloatFix (f,9,2); GUI_GotoX(100); GUI_DispFloatFix (-f,9,2); GUI_DispStringAt("GUI_DispSFloatFix: ",0,40); GUI_DispSFloatFix (f,9,2); GUI_GotoX(100); GUI_DispSFloatFix (-f,9,2); GUI_DispStringAt("GUI_DispFloatMin: ",0,60); GUI_DispFloatMin (f,3); GUI_GotoX(100); GUI_DispFloatMin (-f,3); GUI_DispStringAt("GUI_DispSFloatMin: ",0,80); GUI_DispSFloatMin (f,3); GUI_GotoX(100); GUI_DispSFloatMin (-f,3); GUI_SetFont(&GUI_Font6x8); GUI_DispStringAt("Press any key",0, 240-8); ; while (1) { GUI_Delay(10); } }
实际显示效果如下：
13.5 总结
数值显示就为大家讲解这么多，数值显示属于emWin的基本功能，初学者要多练练这些相关的函数，实践出真知。如果觉得这些函数用起来不顺手，就使用sprintf函数配合文本函数显示即可，简单好用。