Класс окна списка

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

Когда пользователь щелкает мышью над окном списка, окно списка получает фокус ввода. Родительское окно может предоставить управляющему (listbox control) окну списка фокус ввода с помощью вызова функции:

SetFocus(hwndList);

Если окно списка имеет фокус ввода, то для выбора пунктов списка также могут использоваться клавиши управления курсором, буквенные клавиши и клавиша <Spacebar>. Управляющее окно списка посылает сообщения WM_COMMAND своему родительскому окну. Значение параметров сообщения lParam и wParam то же, что и для кнопок управления и управляющих окон редактирования:

LOWORD (wParam) Идентификатор дочернего окна

HIWORD (wParam) Код уведомления

lParam Описатель дочернего окна

Ниже перечисляются коды уведомления и их значения:

LBN_ERRSPACE -2

LBN_SELCHANGE 1

LBN_DBLCLK 2

LBN_SELCANCEL 3

LBN_SELFOCUS 4

LBN_KILLFOCUS 5

Окно списка посылает своему родительскому окну коды LBN_SELCHANGE и LBN_DBLCLK только в том случае, если в стиль дочернего окна включен идентификатор LBS_NOTIFY. Код LBN_ERRSPACE показывает, что превышен размер памяти, отведенный для списка. Код LBN_SELCHANGE показывает, что был изменен текущий выбор; эти сообщения имеют место, когда пользователь перемещает подсветку по списку, изменяет состояние выборки с помощью клавиши <Spacebar> или выбирает нужный элемент списка с помощью щелчка мыши. Код LBN_DBLCLK показывает, что на данном пункте списка имел место двойной щелчок мыши. (Значение кодов уведомления для LBN_SELCHANGE и LBN_DBLCLK соответствует количеству щелчков мыши.)

Если вы используете стиль LBS_SORT (или, если вы располагаете строки в списке в том порядке, в котором вы хотите, чтобы они появлялись), то простейшим способом заполнить список будет использование сообщения LB_ADDSTRING:

SendMessage(hwndList, LB_ADDSTRING, 0,(LPARAM) szString);

Если вы не используете стиль LBS_SORT, то можете вставить строку в ваш список, задав индекс и используя сообщение LB_INSERTSTRING:

SendMessage(hwndList, LB_INSERTSTRING, iIndex,(LPARAM) szString);

Удалить строку из списка можно с помощью сообщения LB_DELETESTRING, указав значение индекса:

SendMessage(hwndList, LB_DELETESTRING, iIndex, 0);

Полностью очистить список можно с помощью сообщения LB_RESETCONTENT:

SendMessage(hwndList, LB_RESETCONTENT, 0, 0);

Оконная процедура окна списка обновляет окно, если к списку добавляется или из списка удаляется элемент. Если вам известно число строк, которые необходимо добавить или удалить, то вам может понадобиться временно приостановить это обновление, сбросив флаг обновления окна:

SendMessage(hwndList, WM_SETREDRAW, FALSE, 0);

После окончания работы по изменению списка, вам следует восстановить флаг обновления окна:

SendMessage(hwndList, WM_SETREDRAW, TRUE, 0);

После того, как вы вставили в список несколько элементов, вы можете определить количество элементов в списке:

iCount = SendMessage(hwndList, LB_GETCOUNT, 0, 0);

Некоторые другие вызовы различаются для списков с единичной выборкой и для списков с множественной выборкой. Сначала рассмотрим список с единичной выборкой. Обычно вы разрешаете пользователю выбирать из списка. Но если вы хотите выделить элемент, выбираемый по умолчанию, то можете использовать такой вызов:

SendMessage(hwndList, LB_SETCURSEL, iIndex, 0);

При установки в качестве iIndex значения —1, выборка для всех элементов отменяется. Вы также можете выбирать элемент списка на основе его первых символов:

iIndex = SendMessage(hwndList, LB_SELECTSTRING, iIndex,(LPARAM) szSearchString);

Величина iIndex, заданная в качестве параметра lParam функции SendMessage, является номером пункта, с которого начинается поиск пункта, начальные символы которого заданы в szSearchString. При значении iIndex равном —1, поиск начинается с начала списка. Возвращаемым значением функции SendMessage является индекс выбранного элемента или LB_ERR, если в списке нет элементов, с начальными символами из строки szSearchString.

Когда вы получаете от окна списка сообщение WM_COMMAND (или в любое другое время), с помощью сообщения LB_GETCURSEL вы можете определить индекс текущего выбранного элемента: iIndex = SendMessage(hwndList, LB_GETCURSEL, 0, 0); Если возвращаемое значение функции SendMessage равно LB_ERR, то это означает отсутствие выбранных элементов.

Вы можете определить длину строки любого элемента списка:

iLength = SendMessage(hwndList, LB_GETTEXTLEN, iIndex, 0);

Копировать выбранную строку в буфер можно следующим образом:

iLength = SendMessage(hwndList, LB_GETTEXT, iIndex,(LPARAM) szBuffer);

Больщинство сообщений от элементов управления получает само диалоговое окно и их необходимо как-либо обрабатывать. Из этого следует, что у диалогового окна должна быть своя оконная функция. Пример взаимодействия между элементами управления:

if(SendMessage(hCType, CB_GETCURSEL, 0, 0)!= 0)

EnableWindow(GetDlgItem(hDlg, IDC_BSetData), TRUE);