Export (0) Print
Expand All
1 out of 3 rated this helpful - Rate this topic

EM_SETCUEBANNER message

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

Parameters

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.

Remarks

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.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

See also

Edit_SetCueBannerText

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.