Поделиться через


CComboBox::SetCueBanner

Устанавливает текст очереди, отображаемый для элемента управления " поле со списком.

BOOL SetCueBanner(
     LPCTSTR lpszText
);

Параметры

Параметр

Описание

[in] lpszText

Указатель на null- завершенному буфер, содержащий текст подсказки.

Возвращаемое значение

Значение true, если метод выполнен успешно; в противном случае — значение false.

Заметки

Текст очереди приглашение, которое отображается в области ввода элемента управления " поле со списком.Текст отображается очереди до тех пор, пока пользователь не выполнит предоставление входных данных.

Этот метод отправляет сообщение CB_SETCUEBANNER, которое описано в Windows SDK.

Требования

заголовок: afxwin.h

Этот метод поддерживается в Windows Vista и более поздних версиях.

Дополнительные требования для этого метода см. в Требования построения для элементов управления Windows Vista общих.

Пример

В следующем примере кода определяется переменной m_combobox, которая используется для программного доступа к элементу управления поля со списком.Эта переменная используется в следующем примере.

    // Variable to access the combo box control
    CComboBox m_combobox;

В следующем примере кода задается заголовка очереди для элемента управления " поле со списком.

    // Add extra initialization here.

    // Add 20 items to the combo box. The Resource Editor
    // has already been used to set the style of the combo
    // box to CBS_SORT.
    CString str;
    for (int i = 1; i <= 20; i++)
    {
        str.Format(_T("Item %2d"), i); 
        m_combobox.AddString(str);
    }
    // Set the minimum visible item
    m_combobox.SetMinVisibleItems( 10 );
    // Set the cue banner
    m_combobox.SetCueBanner(_T("Select an item..."));

    // End of extra initialization.

См. также

Ссылки

Класс CComboBox

Диаграмма иерархии

CComboBox::GetCueBanner

CB_SETCUEBANNER