Введение в программирование
       

Класс CListBox


Элемент управления List Box "окно списка", называемый иногда просто списком, используется для работы с информацией, отображаемой в виде списка. Окно списка может быть реализовано как список с единичным или с множественным выбором.

Окно списка можно связать как с переменной типа CString, так и с объектом класса CListBox.

Свойство Selection позволяет устанавливать тип списка:

  • Single (по умолчанию) - пользователь может выделить только один элемент списка
  • Multiple - пользователь может одновременно выделить несколько элементов списка. Выделение элементов (или снятие выделения) осуществляется при щелчке или двойном щелчке мыши.
  • Extended - пользователь может одновременно выделить несколько элементов списка. Выделение элементов (или снятие выделения) осуществляется перемещением мыши при нажатой кнопке.
  • None - пользователь не может выделить ни одного элемента списка.

Класс CListBox предоставляет широкий набор методов для работы со списком, включая следующие:

  • GetCount - метод возвращает количество элементов в окне списка.
  • SetTopIndex - метод прокручивает окно списка к указанному элементу, отображая его первым видимым элементом.

Например:

extern CListBox* pmyListBox; // Определение первым видимым элементом списка // элемента,расположенного посередине списка pmyListBox->SetTopIndex(pmyListBox->GetCount()/2);

  • GetText- метод возвращает строку по указанному индексу элемента списка.

    Например:

    extern CListBox* pmyListBox; CString str, str2; int n; for (int i=0;i < pmyListBox->GetCount();i++) { n = pmyListBox->GetTextLen( i ); pmyListBox->GetText( i, str.GetBuffer(n) ); str.ReleaseBuffer(); // Дампинг всех элементов списка (#ifdef _DEBUG ) str2.Format(_T("item %d: %s\r\n"), i, str.GetBuffer(0)); afxDump << str2; }

  • SetCurSel- метод выделяет указанный элемент списка и при необходимости прокручивает окно списка так, чтобы выделенный элемент стал видимым.
  • GetSelCount - метод возвращает общее количество выделенных элементов в окне списка с множественным выбором.
  • AddString - метод добавляет в окно списка новый элемент, содержащий указанную строку.
  • DeleteString - метод удаляет из окна списка строку с соответствующим индексом.
  • InsertString - метод вставляет в указанное место окна списка новый элемент, содержащий заданную строку.
  • FindString - метод выполняет поиск указанной строки в окне списка.
  • ResetContent - метод удаляет все элементы окна списка.



Содержание раздела