Некоторые методы класса cListBox

1. Метод для очистки содержимое списка, делает его пустым:

void ResetContent();

2. Метод для добавления элемента в список:

int AddString( LPCSTR lpszItem);

Добавляет строку lpszItem в список и сортирует его, если при создании включено свойство Sort. В противном случае элемент добавляется в конец списка.

3. Метод для удаления элемента из списка:

int DeleteString( UINT nIndex);

Удаляет из списка элемент с индексом nIndex. Индексация элементов начинается с 0.

4. Метод для получения индекса элемента, выбранного пользователем: int GetCurSel() const;

5. Метод для программной установки отмеченного элемента списка: int SetCurSel( int nSelect);

Отмечает элемент с индексом nSelect как выбранный элемент списка. Если значение параметра равно -1, список не будет содержать отмеченных элементов.

6. Методы для копирования содержания определенного элемента в буфер: int GetText( int nIndex, LPSTR lpszBuffer) const;

или void GetText( int nIndex, CString& rString) const;

Копирует элемент с индексом nIndex в буфер.

7. Метод для организации прокрутки списка в окне так, чтобы элемент с индексом nIndex был видимым:

int SetTopIndex( int nIndex);

8. Метод для организации поиска в списке:

int FindString( int nStartAfter, LPCSTR lpszItem) const;

Организует поиск в списке и возвращает в качестве результата индекс элемента списка, префикс которого совпадает со строкой lpszItem. Результат не зависит от регистра, в котором набирались символы сравниваемых строк.

Параметр nStartAfter задает начало поиска, но поиск идет по всему списку. Он начинается от элемента, следующего за nStartAfter, до конца списка и затем продолжается от начала списка до элемента с индексом nStartAfter. В качестве результата выдается первый найденный элемент, удовлетворяющий условиям поиска. Если такого нет, результат получает значение LB_ERR. Этот метод отличается от предыдущего тем, что теперь не префикс элемента должен совпадать со строкой lpszFind, а сам текст элемента: int FindStringExact( int nIndexStart, LPCSTR lpszFind) const; Поиск по-прежнему не чувствителен к регистру, в котором набираются символы.

С помощью класса CListbox можно создавать одноколоночные и многоколоночные списки, имеющие вертикальную (для одноколоночных списков) и горизонтальную (для многоколоночных списков) полосу просмотра. Список может быть как с одиночным выбором, так и с множественным. Последний позволяет пользователю выбирать более одного пункта списка.

Окно списка посылает сообщение WM_COMMAND своему родительскому окну, когда в списке выбирается какой-либо пункт. Родительское окно может определить, какой пункт списка выбран.

Рассмотрим стили окон списков.

В окна списка почти всегда включают идентификатор стиля LBS_NOTIFY, что позволяет родительскому окну получать от окна списка сообщение WM_COMMAND. Если приложение желает иметь возможность сортировать элементы списка, ему необходимо использовать в окне списке и другой часто используемый идентификатор стиля – LBS_SORT. По умолчанию, в списке допускается выбор только одного пункта. Если необходимо создать список с возможностью выборки сразу нескольких пунктов, то следует использовать стиль LBS_MULTIPLESEL. По умолчанию, оконная процедура окна списка выводит только список элементов без какой-либо рамки вокруг. Рамку можно добавить с помощью стиля WS_BORDER. Для прокрутки содержимого с помощью мыши и вертикальной полосы прокрутки следует использовать стиль WS_VSCROLL. Стиль LBS_STANDARD включает в себя наиболее часто используемые стили списка. Он определяется как комбинация

(LBS_NOTIFY|LBS_SORT|WS_VSCROLL|WS_BORDER)

Также можно пользоваться стилями WS_SIZEBOX и WS_CAPTION, которые дают возможность менять размер окна и перемещать его по рабочей области родительского окна. Когда пользователь щелкает мышью над окном списка, окно списка получает фокус ввода. Если окно списка имеет фокус ввода, то для выбора пунктов можно пользоваться как мышью, так и клавиатурой. При работе со списком, выраб-тся уведомляющие сообщения (notification) от списка. Сообщения: LBN_ERRSPACE - превышен размер памяти, отведенный для списка. LBN_SELCHANGE - изменен текущий выбор (подсветка перемещается по списку); LBN_DBLCLK - на пункте списка имел место двойной щелчок мышью. Окно списка посылает коды уведомления LBN_SELCHANGE и LBN_DBLCLK только в том случае, если в стиль дочернего окна включен идентификатор LBS_NOTIFY. LBN_KILLFOCUS - Потеря фокуса. LBN_SELCANCEL - Выбор с элемента снимается. LBN_SETFOCUS - Получение фокуса.