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;

}

版本

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