Список

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

Общие сведения

Раздел Содержимое
Сведения о полях списка Описание функций списка.
Использование списков Объясняет, как выполнять задачи, связанные с полями списка.

Функции

Раздел Содержимое
DlgDirList Заменяет содержимое поля списка именами подкаталогов и файлов в указанном каталоге.
DlgDirSelectEx Извлекает текущий выбор из списка с одним выделением.
DrawInsert Рисует значок вставки в родительском окне указанного списка перетаскивания.
GetListBoxInfo Извлекает сведения об указанном поле списка.
LBItemFromPt Извлекает индекс элемента в указанной точке в поле списка.
MakeDragList Изменяет указанное поле с одним выделением в поле перетаскивания.

Сообщения

Раздел Содержимое
LB_ADDFILE Добавляет указанное имя файла в поле списка, содержащее список каталогов.
LB_ADDSTRING Добавляет строку в поле списка.
LB_DELETESTRING Удаляет строку в поле списка.
LB_DIR Добавляет имена в список, отображаемый полем списка.
LB_FINDSTRING Находит первую строку в поле списка, начинающееся с указанной строки.
LB_FINDSTRINGEXACT Находит первую строку списка, которая точно соответствует указанной строке, за исключением того, что поиск не учитывает регистр.
LB_GETANCHORINDEX Возвращает индекс элемента привязки, из которого начинается несколько выборок.
LB_GETCARETINDEX Извлекает индекс элемента с прямоугольником фокуса в списке с несколькими выделениями. Элемент может быть выбран или не выбран.
LB_GETCOUNT Возвращает количество элементов в поле списка.
LB_GETCURSEL Возвращает индекс текущего выбранного элемента, если таковой имеется, в поле с одним выделением.
LB_GETHORIZONTALEXTENT Получает ширину в пикселях, которую можно прокручивать по горизонтали (ширину прокрутки), если в списке есть горизонтальная полоса прокрутки.
LB_GETITEMDATA Возвращает определяемое приложением значение, связанное с указанным элементом списка.
LB_GETITEMHEIGHT Возвращает высоту элементов в списке.
LB_GETITEMRECT Возвращает размеры прямоугольника, ограничивающего элемент поля списка, как в настоящее время отображается в списке.
LB_GETLISТБ OXINFO Возвращает количество элементов на столбец в указанном поле списка.
LB_GETLOCALE Возвращает текущий языковой стандарт списка.
LB_GETSEL Возвращает состояние выделения элемента.
LB_GETSELCOUNT Возвращает общее количество выбранных элементов в списке с несколькими выборами.
LB_GETSELITEMS Заполняет буфер массивом целых чисел, указывающих номера элементов выбранных элементов в списке с несколькими выборками.
LB_GETTEXT Возвращает строку из поля списка.
LB_GETTEXTLEN Возвращает длину строки в поле списка.
LB_GETTOPINDEX Получает индекс первого видимого элемента в поле списка.
LB_INITSTORAGE Выделяет память для хранения элементов списка. Это сообщение используется перед добавлением большого количества элементов в поле списка.
LB_INSERTSTRING Вставка строковых или элементов данных в поле списка. В отличие от сообщения LB_ADDSTRING, сообщение LB_INSERTSTRING не приводит к сортировке списка сLBS_SORT стилем.
LB_ITEMFROMPOINT Получает отсчитываемый от нуля индекс элемента, ближайшего к указанной точке в списке.
LB_RESETCONTENT Удаляет все элементы из списка.
LB_SELECTSTRING Ищет поле списка для элемента, начинающегося с символов в указанной строке.
LB_SELITEMRANGE Выбирает или отменяет выбор одного или нескольких последовательных элементов в списке с несколькими выборами.
LB_SELITEMRANGEEX Выбирает один или несколько последовательных элементов в списке с несколькими выборами.
LB_SETANCHORINDEX Задает элемент привязки, из которого запускается несколько элементов выбора. Несколько элементов выбора охватывают все элементы из элемента привязки к элементу-элементу в виде курсора.
LB_SETCARETINDEX Задает прямоугольник фокуса элементу по указанному индексу в списке с несколькими выборами. Если элемент не отображается, он прокручивается в представление.
LB_SETCOLUMNWIDTH Задает ширину (в пикселях) всех столбцов в списке с несколькими столбцами.
LB_SETCOUNT Задает количество элементов в поле списка, созданном с помощью стиля LBS_NODATA и не созданного с помощью стиля LBS_HASSTRINGS.
LB_SETCURSEL При необходимости выбирает строку и прокручивает ее в представление.
LB_SETHORIZONTALEXTENT Задает ширину (в пикселях), по которой поле списка можно прокручивать по горизонтали (ширина прокрутки).
LB_SETITEMDATA Задает значение, связанное с указанным элементом в поле списка.
LB_SETITEMHEIGHT Задает высоту элементов в пикселях в поле списка.
LB_SETLOCALE Задает текущий языковой стандарт списка.
LB_SETSEL Выбирает строку в списке с несколькими выборами.
LB_SETTABSTOPS Задает позиции табуляции в списке.
LB_SETTOPINDEX Гарантирует, что указанный элемент в поле списка отображается.

Notifications

Раздел Содержимое
LBN_DBLCLK Уведомляет приложение о том, что пользователь дважды щелкнул элемент в списке.
LBN_ERRSPACE Уведомляет приложение о том, что поле списка не может выделить достаточно памяти для выполнения определенного запроса.
LBN_KILLFOCUS Уведомляет приложение о том, что поле списка потеряло фокус клавиатуры.
LBN_SELCANCEL Уведомляет приложение о том, что пользователь отменил выбор в списке.
LBN_SELCHANGE Уведомляет приложение о том, что выбор в поле списка изменился.
LBN_SETFOCUS Уведомляет приложение о том, что поле списка получило фокус клавиатуры.
WM_CHARTOITEM Отправляется по списку с LBS_WANTKEYBOARDINPUT стилем своему владельцу в ответ на сообщение WM_CHAR.
WM_CTLCOLORLISТБ OX Отправлено в родительское окно поля списка, прежде чем система рисует поле списка. Отвечая на это сообщение, родительское окно может задать цвета текста и фона поля списка с помощью указанного дескриптора контекста устройства отображения.
WM_DELETEITEM Отправляется владельцу поля списка или поля со списком, если поле списка или поле со списком уничтожено или когда элементы удаляются LB_DELETESTRING, LB_RESETCONTENT, CB_DELETESTRING или сообщение CB_RESETCONTENT.
WM_VKEYTOITEM Отправлено поле списка с стилем LBS_WANTKEYBOARDINPUT своему владельцу в ответ на сообщение WM_KEYDOWN.
DL_BEGINDRAG Уведомляет родительское окно списка перетаскивания о том, что пользователь щелкнул левую кнопку мыши на элементе.
DL_CANCELDRAG Указывает, что пользователь отменил операцию перетаскивания, нажав правую кнопку мыши или нажав клавишу ESC.
DL_DRAGGING Сигнализирует о том, что пользователь переместил мышь при перетаскивании элемента.
DL_DROPPED Сигнализирует о том, что пользователь выполнил операцию перетаскивания, выпустив левую кнопку мыши.

Структуры

Раздел Содержимое
DELETEITEMSTRUCT Содержит сведения об удаленном поле списка или элементе поля со списком.
DRAGLISTINFO Содержит сведения о событии перетаскивания. Указатель на DRAGLISTINFO передается в качестве параметра lParam сообщения списка перетаскивания.

Константы

Раздел Содержимое
Стили списка Описывает стили окон, определяющие элемент управления списком.