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

char buffer[4096];

int main(void)

{

int i;

clrscr( );

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

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

gotoxy(1, 25);

getch( );

clrscr( );

gotoxy(1, 25);

getch( );

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

gotoxy(1, 25);

getch( );

return 0;

}

2012年12月28日，gettext 0.18.2 发布，国际化语言支持库