CEdit::SetCueBanner
Legt den Text fest, der während der Text-Hinweis oder Tipp, in einem Bearbeitungssteuerelement angezeigt wird, wenn das Steuerelement leer ist.
BOOL SetCueBanner(
LPCWSTR lpszText
);
BOOL SetCueBanner(
LPCWSTR lpszText,
BOOL fDrawWhenFocused = FALSE
);
Parameter
[in] lpszText
Zeiger auf eine Zeichenfolge, die den Hinweis enthält, um im Bearbeitungssteuerelement anzuzeigen.[in] fDrawWhenFocused
Wenn false, das Hinweisbanner nicht gezeichnet wird, wenn der Benutzer im Bearbeitungssteuerelement klickt und Steuerelement den Fokus gibt.Wenn true, das Hinweisbanner gezeichnet wird, auch wenn das Steuerelement den Fokus besitzt.Das Hinweisbanner wird wenn der Benutzer beginnt, per das Steuerelement zugeordnet.
Der Standardwert ist false.
Rückgabewert
true, wenn die Methode erfolgreich ist; andernfalls false.
Hinweise
Diese Methode sendet die EM_SETCUEBANNER Meldung, die im Windows SDK beschrieben wird.Weitere Informationen finden Sie unter Edit_SetCueBannerTextFocused das Makro.
Anforderungen
Header: afxwin.h
Dieses Steuerelement ist in Windows XP und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Build-Anforderungen für Windows Vista-gemeinsame Regelungen beschrieben.
Beispiel
Im folgenden Beispiel wird die CEdit::SetCueBanner-Methode veranschaulicht.
m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);