PB GetText()函数

 

GetText函数

   返回数据窗口控件中 悬浮在当前行列之上的编辑框中的文本。在用户修改数据窗口中某项的值时，实际上首先在悬浮 在当前项上的编辑框中进行修改 ， 当用户移动输入焦点或程序中使用 AcceptText()函数接收用户输入时，用户修改的数据通过有效性规则验证后放入数据窗口的主缓冲区中。

语法：

　　dwcontrol.GetText( )

参数：

　　dwcontrol 数据窗口控件名

返回值：

　　String 函数执行成功时返回悬浮在数据窗口dwcontrol 当前行列之上的编辑框中的文本，该文本值或许能、或许不能通过各种有效性检查，即或许可以接收为当前项的值，或许不能接收。如果数据窗口中没有当前项，则GetText()函数返回空字符串 "" ，如果dwcontrol 的值为NULL ，则GetText()函数返回NULL。

用法：

　　显示在数据窗口中的各个数据项的值保存在数据窗口的主缓冲区中。当用户编辑某项的值时，系统自动把该值传送到 漂浮 在该项之上的编辑框中，供用户进行修改。当用户移动输入焦点或程序中使用 AcceptText()函数接收用户输入后 用户修改的数据通过有效性规则验证时放入数据窗口的主缓冲区中。

　　在数据窗口控件的ItemChanged 或ItemError 事件中不需要调用GetText()函数来得到编辑框中用户输入或修改的内容 ，此时，可以使用这些事件的data 参数得到该内容；要得到数据窗口缓冲区中某项的值 ， 使用与相应列的数据类型相匹配的 GetItem 系列函数 。

示例：

　　下面的语句得到数据窗口控件中 漂浮 在当前数据项之上的编辑框的内容并将其保存在变量LName 中

　　string LName

　　LName = dw_employee.GetText()

　　程序例:

　　 #include <conio.h>

　　char buffer[4096];

　　int main(void)

　　{

　　int i;

　　clrscr();

　　for (i = 0; i <= 20; i++)

　　cprintf("Line #%d\r\n", i);

　　gettext(1, 1, 80, 25, buffer);

　　gotoxy(1, 25);

　　cprintf("Press any key to clear screen...");

　　getch();

　　clrscr();

　　gotoxy(1, 25);

　　cprintf("Press any key to restore screen...");

　　getch();

　　puttext(1, 1, 80, 25, buffer);

　　gotoxy(1, 25);

　　cprintf("Press any key to quit...");

　　getch();

　　return 0;

　　}