功能:返回数据窗口控件中 悬浮在当前行列之上的编辑框中的文本。在用户修改数据窗口中某项的值时,实际上首先在悬浮 在当前项上的编辑框中进行修改, 当用户移动输入焦点或程序中使用 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++)
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;
}