EGE基础：输入篇

EGE专栏：EGE专栏

  EGE中的输入是基于 头文件中是 sys_edit 类的。这个类提供一个输入框，可以用来输入。

  缺点是sys_edit 类中检测是否获得焦点的 isfocus() 失效，那创建多个输入框时，就不可以通过回车来获取输入内容，因为不知道焦点在哪个输入框。   如果能检测焦点，那输入后回车就可以判断焦点在哪个输入框，然后获取该输入框的内容。现在不能检测，那就只能 通过添加按钮 的方式，当点击某个按钮时，就获取对应的输入框的内容。

  使用前需要先包含 sys_edit.h头文件。sys_edit.h头文件是放在ege文件夹下，所以使用#include   sys_edit.h 头文件需要在graphics.h 或ege.h之后包含，不能放在它们的前面。

  包含 sys_edit.h 头文件如下所示：

  sys_edit 类 定义在EGE的 sys_edit.h 头文件中，可能有些人按照的是别人的教程安装的EGE，所以头文件路径不正确，显示 No such File or Directory 。现在统一按照EGE安装包中的文件放置。

  可以看到，EGE安装包中，在include 目录下有两个头文件和一个ege文件夹，ege文件夹中有五个头文件，这些都是EGE自带的控件。所以复制头文件时，直接把include文件夹中的文件全选，复制到安装目录的inlcude目录即可。

  需要包含 头文件，需要注意的是， sys_edit.h 头文件需要在graphics.h 或ege.h之后包含，不能放在它们的前面。

  输入框使用前需要创建并进行一些设置，设置示例如下所示。

  下面是具体的使用步骤。

  先创建 sys_edit 对象

  然后调用成员函数 create() 来创建输入框。

函数声明：

  函数参数为 bool 型，控制输入框是多行输入框还是单行输入框。

参数: bool型

创建输入框

  设置输入框左上角在窗口上的位置坐标，单位为像素。

  设置输入框的宽高，单位为像素。

  这个宽度大小是包含输入框边框的，所以如果你正好设置为文字的高度，那么部分文字会被遮挡，输入框高度可以多加 8。

  这里是一些其它设置，可以根据需要进行设置

  设置后，输入的字符数量不会超过这个值。当输入框中字符数量达到最大长度后，其它字符无法输入到输入框中。(中文字符和英文字符都算做一个字符)

  设置相应输入框的文字字体，和全局字体无关。   参数是（height, width, “字体”）。(width为0时，表示文字在设置的高度下按照原比例所对应的宽度; width不为0时则强制字体变形为对应宽度。)

  可以控制输入框是否允许用户输入。设置为只读模式后，输入框不允许用户输入。(输入框默认为允许输入)

  创建好后， 需要调用成员函数visible() 设置输入框可见，否则是看不到输入框的，因为输入框创建后默认是隐藏的(设置完成后再进行显示)。   (如果你用的是19.01版本的EGE, 那应该是 visable() 函数，别问visable是什么单词，问就是visible)

参数:(bool)

可设置输入框获取焦点。输入框获取焦点后，输入框将会有光标闪烁，此时用户可以进行输入。

  输入框内容的获取需要调用成员函数 gettext() 。

  其中，参数maxLen 表示字符缓冲区所占内存的大小 (单位为字节)。字符缓冲区可以是char型，也可以是宽字符类型。

  要获取输入框内容，首先需要创建一个字符数组或宽字符数组作为缓冲区，用于存储字符串。   请根据输入的字符数预留好足够的空间大小，如果最大输入N个字符，缓冲区请至少预留2 * (N +1 )个字节的空间大小(汉字占两个字节，加上末尾’\0’字符)

使用示例：

  这样就获取到了输入框的内容。输入的内容保存在char数组strBuffer[ ]中。

  输入框是可以输入汉字的，但汉字在GB2312编码下正常会占两个字节，如果使用用char数组，将占用两个char。使用 printf() 也是可以正常输出的。   按一次回车键会输入回车符和换行符两个字符。

  如果你想要不管什么内容，一个字符都占用一个字符变量的大小，那可以使用宽字符类型 wchar_t 。 (宽字符类型占用两个字节)

头文件包含

宽字符数组

宽字符串要使用 L" " 来表示, 而不是 " "

获取输入框内容到宽字符数组缓存中：

buffSize是缓存区大小，这个要设置正确，设置的值可以小于缓存区大小，这样缓冲区有剩余部分不使用，但是不能超出缓冲区大小，否则输入框内容多时会出现写入内容越界，容易造成程序崩溃。

  获取宽字符数组长度可以使用 wcslen() 函数， 这个函数在头文件wchar.h 中声明。(即 wide char string length 的缩写)

  使用xyprintf() 输出宽字符串时, 格式字符串也要用 L" " 表示，否则可能会输出不完整。

使用 settext() 来设置输入框的内容

调用 settext("") 即可把输入框内容清空(即把内容设为空字符串)

获取输入框位置

获取输入框大小

  调用 editBox.visible(false) 就能将设置为不可见。

  如果焦点在输入框上时输入框隐藏，此时焦点仍在输入框上，除非用户点击了窗口，否则用户还是能通过按键继续输入。   如果想隐藏输入框的同时不允许用户继续输入，可以同时将输入框设置为只读。

  当输入框恢复可见时，不要忘记设置允许输入。

  如果已经不需要输入框了，可以调用 destroy() 将输入框销毁。这样输入框就没了。

  销毁后，如果想再次输入，需要按照以上流程重新创建。

  需要注意的是，EGE 19.01及之前版本函数名是 destory。如果编译错误，说找不到destroy，请改成 editBox.destory()

  sys_edit对象会在超出所在块后自动销毁。 所以一般情况下不需要调用。

  对于一个变量，生命周期从程序执行到变量初始化处开始，程序执行到超出变量作用域后结束。   如果变量是创建在块内，那么运行超出这个块后，这个变量将被销毁。这个在循环中很常见。一个循环需要多次执行语句块，所以会多次进入块、退出块的操作。因此定义在块中局部变量，会被多次创建和销毁。   按如下代码所示，输入框会被多次创建和销毁，而输入框创建后默认是隐藏的，如果在输入框生命周期中将输入框设置为可见，那么输入框会在不断地创建、使用和销毁过程中闪烁，并且无法输入内容。

  所以在输入框的使用过程中，应该保证不超出输入框的生命周期范围之外。输入框应该定义在帧循环之外。按如下所示，循环过程中

  那如果同一个输入框在不同的函数里使用怎么办？此时就不能定义成函数的局部变量，应该使用动态分配或者定义成全局变量，保证使用过程一直在输入框的生命周期内。

下面来做个输入框示例（宽字符型wchar_t 和 字符型 char 分别做个示例）

  这里简单做个输入框输入的示例，按下回车便会在窗口上显示内容。对于char型和wchar_t型，使用上没有多大的区别，仅仅只是字符串存储上的不同。

多个输入框就创建多个sys_edit对象，分别对其初始化即可。

  较多情况下，输入框的样式基本都是一样的，只是大小，位置不同，这时可以将配置输入框的函数封装，只留下位置和大小参数。   如果觉得输入框需要各种不同的样式，可以自己定义一个包含各种设置参数的结构体，当做参数传入即可。(EGE的输入框也没提供什么样式，小搞一下就行)

  因为你在输入框输入的时候会产生按键消息，所以当你退出循环后，因为存有按键消息，getch()会直接从按键消息队列里面获取，而不会阻塞，所以如果后面就是closegraph(),看到窗口闪一下就关闭了。   对于有输入框的程序，可以考虑是否需要使用 flushkey() 清空消息队列。

下面先看一下出问题时情况：   这个程序在帧循环里仅仅只是检测回车键有没有按下，按下就退出循环，并且没有读取按键消息。那么这时消息队列里就会堆积一定数量的消息。退出循环后，程序就会读取队列里剩余的按键消息并计数。这样可以看到在退出循环后，会剩余多少个按键消息，这就是getch()不阻塞的原因。

  所以在输入框中输入完成后，可以考虑用 flushkey() 清空按键消息，或者在帧循环中处理按键消息。==

如下所示

  可能有人只会在控制台程序中使用 scanf() 获取数字输入，而对于从输入框获取到的字符串不知如何得到参数，因为它只给我们提供了获取字符串内容的gettext()。

  在控制台中获取输入，我们可能会这样：

  然后从控制台输入两个数据，就完成了变量的赋值。但其实呢，我们输入进控制台的，就是字符串， 只不过是 scanf() 函数 对这个字符串进行了解析，从里面提取出了我们想要的值。

  你可能见过这样的编程题：

函数填空   calculateN 函数的功能是计算出由字符串表示的数值。   函数参数为一个只包含十进制数字字符(‘0’~‘9’)的字符串，字符串长度最小为1，最大为5。字符串所对应的十进制数字为 N ( 0 ⩽ N ⩽ 9999 ) N(0 \leqslant N \leqslant 9999) N(0⩽N⩽9999)，要求计算出 N N N的值并返回。

我们可以写下这样的答案:

这样就能将字符串转成数字了。

  那标准库中有没有这样的函数能实现同样的效果呢？当然有， 头文件中的 atoi() 就能将十进制数字字符串转成相应的值。   所以函数可以改成如下所示：

  那对于更复杂的输入，想像 scanf() 一样从字符串读取各种数据呢？那就是同在 头文件中的 sscanf()。   sscanf() 可以和 scanf() 一样读取出各种不同的数据，区别仅仅是 scanf() 控制台的输入中读取，而 sscanf() 从字符串中读取。类似的，还有从文件中读取的 fscanf()。

函数声明：

  可以看到 sscanf() 前面多了一个字符串类型的 _Buffer 参数，对于从 输入框得到的字符串 ，我们可以将其传入 sscanf() 来获取我们需要的值。

  其中，strBuffer是字符数组首地址。   可以看到，除了前面多了个 strBuffer参数 ， 其它参数和 scanf() 是一样的。这和我们在控制台是一样的， 只不过scanf() 处理的是我们在控制台窗口输入的字符，而sscanf() 处理的是字符串中的内容。

  对于宽字符类型的字符串， 则可以使用 swscanf()。

  上面我们已经能通过 sys_edit::gettext()，获取输入框内容了，假设是存入strBuff 中，那么就可以用下面的方法获取输入的数字:

  可以看到, sscanf() 相比于 scanf() 除了字符串的来源不同，其它都是一样的，你可以输入小数,用 "%f ", 输入整数，用 “%d”, 输入两个数字，用 "%d %d"

  实现从输入框中获取输入的数字，然后计算平方值。

  要注意的是，因为输入框可以随便输入，输入的格式不一定正确，所以要好好利用 scanf 的返回值，返回值是读入的数值个数，如果和我们要读入的变量数不等，那就不操作，或者提示输入有误，直到输入正确。

  下面有很多判断的代码是 为了检测输入框内容是否要求,如果能确保格式符合要求，gettext() 后直接 ssanf() 就完成了。

  对话框样式是这个函数自己画的，不是很好看，可以自己画个背景其实。并且在ege20.08版本中出了点问题，导致对话框全黑。 (个人不建议使用)

功能：   使用对话框让用户输入一个字符串。   不过这个对话框不能自己设置样式。对话框其实都是自己画的，想要样式可以使用sys_edit 类，然后自己贴个对话框背景图。

函数声明：

参数：

返回值：   返回 true 表示输入有效，buf中的内容为用户所输入的数据，返回 false 表示输入无效，同时buf清空。

示例程序：

EGE专栏：EGE专栏