CEdit::SetCueBanner
Задает текст, который отображается как очередь текста или совет в элементе управления "Поле ввода", когда элемент пуст.
BOOL SetCueBanner(
LPCWSTR lpszText
);
BOOL SetCueBanner(
LPCWSTR lpszText,
BOOL fDrawWhenFocused = FALSE
);
Параметры
[входящий] lpszText
Указатель на строку, которая содержит очередь для отображения в элементе управления "Поле ввода".[входящий] fDrawWhenFocused
Если false, баннер очереди не нарисовано, когда пользователь щелкает мышью внутри элемента управления "Поле ввода" и дает элементу управления фокус.Если true, баннер очереди нарисовано, то даже в том случае, если элемент управления имеет фокус. Баннер очереди исчезает при запуске пользователя для ввода в элемент управления.
Значение по умолчанию — false.
Возвращаемое значение
true если метод выполнен успешно; в противном случае false.
Заметки
Этот метод отправляет сообщение EM_SETCUEBANNER, которое описано в Windows SDK. Дополнительные сведения см. в разделе Edit_SetCueBannerTextFocused макрос.
Требования
заголовок: afxwin.h
Этот элемент управления поддерживается в Windows XP и более поздних версиях.
Дополнительные требования для этого метода см. в Требования к сборке для использования стандартных элементов управления в Windows Vista.
Пример
В следующем примере демонстрируется использование метода CEdit::SetCueBanner.
m_cedit.SetCueBanner(_T("First, enter text here..."), TRUE);