本文主要是介绍【第3版emWin教程】第13章 emWin6.x数值显示,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
教程不断更新中: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.2.1 函数GUI_DispDec()
13.2.2 函数GUI_DispDecAt()
13.2.3 函数GUI_DispDecMin()
13.2.4 函数GUI_DispDecShift()
13.2.5 函数GUI_DispSDec()
13.2.6 函数GUI_DispSDecShift()
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:\n",0,0);GUI_DispFloat (f,9);GUI_GotoX(100);GUI_DispFloat (-f,9);GUI_DispStringAt("GUI_DispFloatFix:\n",0,20);GUI_DispFloatFix (f,9,2);GUI_GotoX(100);GUI_DispFloatFix (-f,9,2);GUI_DispStringAt("GUI_DispSFloatFix:\n",0,40);GUI_DispSFloatFix (f,9,2);GUI_GotoX(100);GUI_DispSFloatFix (-f,9,2);GUI_DispStringAt("GUI_DispFloatMin:\n",0,60);GUI_DispFloatMin (f,3);GUI_GotoX(100);GUI_DispFloatMin (-f,3);GUI_DispStringAt("GUI_DispSFloatMin:\n",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函数配合文本函数显示即可,简单好用。
这篇关于【第3版emWin教程】第13章 emWin6.x数值显示的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!