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

", 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;

}