Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize


Call this member function to retrieve the title or text associated with a control in a dialog box.

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


Specifies the integer identifier of the control whose title is to be retrieved.
Points to the buffer to receive the control's title or text.
Specifies the maximum length (in bytes) of the string to be copied to lpStr. If the string is longer than nMaxCount, it is truncated.
A reference to a CString.

Return Value

Specifies the actual number of bytes copied to the buffer, not including the terminating null character. The value is 0 if no text is copied.


The GetDlgItemText member function copies the text to the location pointed to by lpStr and returns a count of the number of bytes it copies.

See Also

CWnd Overview | Class Members | Hierarchy Chart | CWnd::GetDlgItem | CWnd::GetDlgItemInt | GetDlgItemText | WM_GETTEXT

© 2015 Microsoft