GetDlgItemText是C++中的函式,調用這個函式以獲得與對話框中的控制項相關的標題或文本。GetDlgItemText成員函式將文本拷貝到lpStr指向的位置並返回拷貝的位元組的數目。
基本介紹
- 外文名:GetDlgItemText
- 函式說明:CWnd類的成員函式
- 編譯語言:C++
- 學科:計算機學
函式說明,函式原型,參數說明,參數,返回值,系統要求,
函式說明
CWnd類的成員函式。
函式原型
int GetDlgItemText( HWND hDlg , int nID, LPTSTR lpStr, int nMaxCount) const;
int GetDlgItemText( int nID, CString& rString) const;
參數說明
參數
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兩種版本