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;
}