CWnd::GetDlgItemText

Syntax

int GetDlgItemText( int nID, LPSTR lpStr, int nMaxCount ) const;

Parameters

nID

Specifies the integer identifier of the dialog-box item whose caption or text is to be retrieved.

lpStr

Points to the buffer to receive the text.

nMaxCount

Specifies the maximum length (in bytes) of the string to be copied to lpStr. If the string is longer than nMaxCount, it is truncated.

Remarks

Retrieves the caption or text associated with a control in a dialog box. 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.

Return Value

Specifies the actual number of bytes copied to the buffer. The value is 0 if no text is copied.

See Also

CWnd::GetDlgItem, CWnd::GetDlgItemInt, ::GetDlgItemText, WM_GETTEXT