Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Collapse the table of content
Expand the table of content


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 characters) of the string to be copied to lpStr. If the string is longer than nMaxCount, it is truncated.


A reference to a CString.

Specifies the actual number of characters 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.

Header: afxwin.h

Community Additions

© 2015 Microsoft