CComboBox::GetCueBanner

Gets the cue text that is displayed for a combo box control.

CString GetCueBanner() const;
BOOL GetCueBanner(
     LPTSTR lpszText, 
     int cchText
) const;

Parameters

Parameter

Description

[out] lpszText

Pointer to a buffer that receives the cue banner text.

[in] cchText

Size of the buffer that the lpszText parameter points to.

Return Value

In the first overload, a CString object that contains the cue banner text if it exists; otherwise, a CString object that has zero length.

-or-

In the second overload, true if this method is successful; otherwise, false.

Remarks

Cue text is a prompt that is displayed in the input area of the combo box control. The cue text is displayed until the user provides input.

This method sends the CB_GETCUEBANNER message, which is described in the Windows SDK.

Requirements

Header: afxwin.h

This method is supported in Windows Vista and later.

Additional requirements for this method are described in Build Requirements for Windows Vista Common Controls.

See Also

Reference

CComboBox Class

Hierarchy Chart

CComboBox::SetCueBanner

CB_GETCUEBANNER

Other Resources

CComboBox Members