EM_SETCUEBANNER Nachricht

Legt den Texthinweis oder tipp fest, der vom Bearbeitungssteuerelement angezeigt wird, um den Benutzer zur Eingabe von Informationen aufzufordern.

Parameter

wParam [in]

TRUE , wenn das Hinweisbanner auch dann angezeigt werden soll, wenn das Bearbeitungssteuerelement den Fokus hat; andernfalls FALSE. FALSE ist das Standardverhalten, bei dem das Hinweisbanner ausgeblendet wird, wenn der Benutzer auf das Steuerelement klickt.

lParam [in]

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Text enthält, der als Texthinweis angezeigt werden soll.

Rückgabewert

Wenn die Nachricht erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE zurückgegeben.

Bemerkungen

Ein Bearbeitungssteuerelement, das zum Starten einer Suche verwendet wird, zeigt möglicherweise "Suche hier eingeben" in grauem Text als Texthinweis an. Wenn der Benutzer auf den Text klickt, verschwindet der Text, und der Benutzer kann eingeben.

Sie können kein Cue-Banner für ein Mehrzeilen-Bearbeitungssteuerelement oder ein Rich-Edit-Steuerelement festlegen.

Hinweis

Um diese API verwenden zu können, müssen Sie ein Manifest bereitstellen, das Comclt32.dll Version 6.0 angibt. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h

Siehe auch

Edit_SetCueBannerText