Sets the textual cue, or tip, that is displayed by the edit control to prompt the user for information.


wParam [in]

TRUE if the cue banner should show even when the edit control has focus; otherwise, FALSE. FALSE is the default behavior—the cue banner disappears when the user clicks in the control.

lParam [in]

A pointer to a Unicode string that contains the text to display as the textual cue.

Return value

If the message succeeds, it returns TRUE. Otherwise it returns FALSE.


An edit control that is used to begin a search may display "Enter search here" in gray text as a textual cue. When the user clicks the text, the text goes away and the user can type.

You cannot set a cue banner on a multiline edit control or on a rich edit control.

Note  To use this API, you must provide a manifest specifying Comclt32.dll version 6.0. For more information on manifests, see Enabling Visual Styles.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]



See also