-
GetDlgItemText
鎖定
GetDlgItemText是C++中的函數,調用這個函數以獲得與對話框中的控件相關的標題或文本。GetDlgItemText成員函數將文本拷貝到lpStr指向的位置並返回拷貝的字節的數目。
- 外文名
- GetDlgItemText
- 函數説明
- CWnd類的成員函數
- 編譯語言
- C++
- 學 科
- 計算機學
GetDlgItemText函數説明
CWnd類的成員函數。
GetDlgItemText函數原型
int GetDlgItemText( HWND hDlg , int nID, LPTSTR lpStr, int nMaxCount) const;
int GetDlgItemText( int nID, CString& rString) const;
GetDlgItemText參數説明
GetDlgItemText參數
nID 指定了要獲取其標題的控件的整數標識符。 lpStr 指向要接收控件的標題或文本的緩衝區。 nMaxCount 指定了要拷貝到lpStr的字符串的最大長度(以字節為單位)。如果字符串比nMaxCount要長,它將被截斷。 rString 對一個CString對象的引用。 |
GetDlgItemText返回值
如果函數調用成功,返回值為拷貝到緩衝區中的 TCHAR 字符個數(不包括結束空字符)。
如果函數調用失敗,返回值為 0 。要獲取更多錯誤信息,請調用 GetLastError 函數。
説明
如果字符串的長度大於緩衝區的長度,則會被截斷,並以空字符結束。
GetDlgItemText 函數向控件發送一條 WM_GETTEXT 消息。
在 ANSI 版本中,長度指的是字節數,在 Unicode 版本中,長度指的是字符的個數。
GetDlgItemText系統要求
動態鏈接庫:user32.dll
頭文件:在Winuser.h中定義,需包含Windows.h文件
庫文件:User32.lib
最低操作系統:Windows 95, Windows NT 3.1
Unicode:實現為ANSI和Unicode兩種版本