GetDlgItemText

in in CStrin

函式說明

CWnd類的成員函式。

函式原型

int GetDlgItemText( HWND hDlg , int nID, LPTSTR lpStr, int nMaxCount) const;
int GetDlgItemText( int nID, CString& rString) const;

參數說明

調用這個函式以獲得與對話框中的控制項相關的標題或文本。GetDlgItemText成員函式將文本拷貝到lpStr指向的位置並返回拷貝的位元組的數目。

參數

nID 指定了要獲取其標題的控制項的整數標識符。 lpStr 指向要接收控制項的標題或文本的緩衝區。 nMaxCount 指定了要拷貝到lpStr的字元串的最大長度（以位元組為單位）。如果字元串比nMaxCount要長，它將被截斷。 rString 對一個CString對象的引用。

返回值

如果函式調用成功，返回值為拷貝到緩衝區中的 TCHAR 字元個數（不包括結束空字元）。
如果函式調用失敗，返回值為 0 。要獲取更多錯誤信息，請調用 GetLastError 函式。
說明
如果字元串的長度大於緩衝區的長度，則會被截斷，並以空字元結束。
GetDlgItemText 函式向控制項傳送一條 WM_GETTEXT 訊息。
在 ANSI 版本中，長度指的是位元組數，在 Unicode 版本中，長度指的是字元的個數。

系統要求

動態程式庫：user32.dll
頭檔案：在Winuser.h中定義，需包含Windows.h檔案
庫檔案：User32.lib
最低作業系統：Windows 95, Windows NT 3.1
Unicode：實現為ANSI和Unicode兩種版本