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( )

程序例:

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;

}

2012年12月28日，gettext 0.18.2 發佈，國際化語言支持庫