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

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 發布，國際化語言支持庫。