Freigeben über


Edit_SetCueBannerTextFocused Makro (commctrl.h)

Legt den Text fest, der als Texthinweis oder Tipp für ein Bearbeitungssteuerelement angezeigt wird. Sie können dieses Makro verwenden oder die EM_SETCUEBANNER Nachricht explizit senden.

Syntax

BOOL Edit_SetCueBannerTextFocused(
   HWND    hwnd,
   LPCWSTR lpcwText,
   BOOL    fDrawFocused
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Bearbeitungssteuerelement.

lpcwText

Typ: LPCWSTR-

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Text enthält, der als textbezogener Hinweis festgelegt werden soll.

fDrawFocused

Typ: BOOL-

Legt fest, ob der Hinweistext gezeichnet wird, wenn das Steuerelement den Tastaturfokus hat.

Rückgabewert

Typ: BOOL-

Wenn das Makro 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 Textmarker an. fDrawFocused Steuerelemente, wenn der Hinweistext ausgeblendet wird. Wenn fDrawFocused-FALSE-ist, wird der Hinweistext ausgeblendet, wenn das Bearbeitungssteuerelement den Fokus erhält. Wenn fDrawFocused-TRUEist, wird der Hinweistext ausgeblendet, wenn der Benutzer Text in das Bearbeitungssteuerelement eingibt.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- commctrl.h

Siehe auch

Konzeptionelle

EM_SETCUEBANNER

Bearbeiten von Steuerelementen

Edit_SetCueBannerText

Referenz-