Export (0) Print
Expand All
Expand Minimize

CWnd::GetWindowText

Copies the CWnd caption title (if it has one) into the buffer pointed to by lpszStringBuf or into the destination string rString.

int GetWindowText(
   LPTSTR lpszStringBuf,
   int nMaxCount 
) const;
void GetWindowText(
   CString& rString 
) const;

Parameters

lpszStringBuf
Points to the buffer that is to receive the copied string of the window's title.
nMaxCount
Specifies the maximum number of characters to be copied to the buffer. If the string is longer than the number of characters specified in nMaxCount, it is truncated.
rString
A CString object that is to receive the copied string of the window's title.

Return Value

Specifies the length, in bytes, of the copied string, not including the terminating null character. It is 0 if CWnd has no caption or if the caption is empty.

Remarks

If the CWnd object is a control, the GetWindowText member function copies the text within the control instead of copying the caption.

This member function causes the WM_GETTEXT message to be sent to the CWnd object.

Example

See the example for CWnd::SetWindowText.

See Also

CWnd Overview | Class Members | Hierarchy Chart | CWnd::SetWindowText | WM_GETTEXT | CWnd::GetWindowTextLength

Show:
© 2014 Microsoft