Поле со списком (элементы управления Windows)

Статья
06/03/2023

В этом разделе содержатся сведения о элементах программирования, используемых с полями со списком. Поле со списком — это уникальный тип элемента управления, определенный классом CO МБ OBOX, который объединяет большую часть функциональных возможностей поля списка и элемента управления редактирования.

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

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

Функции

Раздел	Содержимое
DlgDirListComboBox	Заменяет содержимое поля со списком именами подкаталогов и файлов в указанном каталоге. Список имен можно отфильтровать, указав набор атрибутов файла. Список имен может включать сопоставленные буквы диска.
DlgDirSelectComboBoxEx	Извлекает текущий выбор из поля со списком, заполненного с помощью функции DlgDirListComboBox. Выбор интерпретируется как буква диска, файл или имя каталога.
GetComboBoxInfo	Извлекает сведения о указанном поле со списком.

Макросы

Раздел	Содержимое
ComboBox_AddItemData	Добавляет данные элемента в список в поле со списком в указанном расположении. Этот макрос можно использовать или явно отправить сообщение CB_ADDSTRING.
ComboBox_AddString	Добавляет строку в список в поле со списком. Если поле со списком не имеет стиля CBS_SORT , строка добавляется в конец списка. В противном случае строка вставляется в список и отсортирован список. Этот макрос можно использовать или явно отправить сообщение CB_ADDSTRING.
ComboBox_DeleteString	Удаляет элемент в указанном расположении в списке в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_DELETESTRING.
ComboBox_Dir	Добавляет имена в список, отображаемый полем со списком. Макрос добавляет имена каталогов и файлов, которые соответствуют указанной строке и набору атрибутов файла. Он также может добавлять сопоставленные буквы дисков в список в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_DIR.
ComboBox_Enable	Включает или отключает элемент управления со списком.
ComboBox_FindItemData	Находит первый элемент в списке со списком с указанными данными элемента. Этот макрос можно использовать или явно отправить сообщение CB_FINDSTRING.
ComboBox_FindString	Находит первую строку в списке со списком, который начинается с указанной строки. Этот макрос можно использовать или явно отправить сообщение CB_FINDSTRING.
ComboBox_FindStringExact	Находит первую строку в списке со списком, который точно соответствует указанной строке, за исключением того, что поиск не учитывает регистр. Этот макрос можно использовать или явно отправить сообщение CB_FINDSTRINGEXACT.
ComboBox_GetCount	Возвращает количество элементов в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_GETCOUNT.
ComboBox_GetCueBannerText	Возвращает текст баннера подсказки, отображаемый в элементе управления редактированием поля со списком. Используйте этот макрос или явно отправьте сообщение CB_GETCUEBANNER.
ComboBox_GetCurSel	Возвращает индекс выбранного элемента в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_GETCURSEL.
ComboBox_GetDroppedControlRect	Извлекает координаты экрана поля со списком в раскрывающемся состоянии. Этот макрос можно использовать или явно отправить сообщение CB_GETDROPPEDCONTROLRECT.
ComboBox_GetDroppedState	Определяет, отображается ли раскрывающийся список в элементе управления со списком. Этот макрос можно использовать или явно отправить сообщение CB_GETDROPPEDSTATE.
ComboBox_GetExtendedUI	Определяет, использует ли поле со списком пользовательский интерфейс по умолчанию или расширенный пользовательский интерфейс. Этот макрос можно использовать или явно отправить сообщение CB_GETEXTENDEDUI.
ComboBox_GetItemData	Возвращает определенное приложением значение, связанное с указанным элементом списка в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_GETITEMDATA.
ComboBox_GetItemHeight	Извлекает высоту элементов списка в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_GETITEMHEIGHT.
ComboBox_GetLBText	Возвращает строку из списка в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_GETLBTEXT.
ComboBox_GetLBTextLen	Возвращает длину строки в списке в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_GETLBTEXTLEN.
ComboBox_GetMinVisible	Возвращает минимальное количество видимых элементов в раскрывающемся списке поля со списком.
ComboBox_GetText	Извлекает текст из элемента управления со списком.
ComboBox_GetTextLength	Возвращает количество символов в тексте поля со списком.
ComboBox_InsertItemData	Вставляет данные элемента в список в поле со списком в указанном расположении. Этот макрос можно использовать или явно отправить сообщение CB_INSERTSTRING.
ComboBox_InsertString	Добавляет строку в список в поле со списком в указанном расположении. Этот макрос можно использовать или явно отправить сообщение CB_INSERTSTRING.
ComboBox_LimitText	Ограничивает длину текста, который пользователь может ввести в элемент управления редактированием поля со списком. Этот макрос можно использовать или явно отправить сообщение CB_LIMITTEXT.
ComboBox_ResetContent	Удаляет все элементы из списка и редактирует элемент управления со списком. Этот макрос можно использовать или явно отправить сообщение CB_RESETCONTENT.
ComboBox_SelectItemData	Выполняет поиск списка в поле со списком для элемента с указанными данными элемента. Если найден соответствующий элемент, выбран элемент. Этот макрос можно использовать или явно отправить сообщение CB_SELECTSTRING.
ComboBox_SelectString	Выполняет поиск списка в поле со списком для элемента, начинающегося с символов в указанной строке. Если найден соответствующий элемент, выбран элемент. Этот макрос можно использовать или явно отправить сообщение CB_SELECTSTRING.
ComboBox_SetCueBannerText	Задает текст баннера подсказки, отображаемый для элемента управления редактированием поля со списком.
ComboBox_SetCurSel	Задает выбранный элемент в поле со списком. Этот макрос можно использовать или явно отправлять сообщение CB_SETCURSEL.
ComboBox_SetExtendedUI	Выбирает пользовательский интерфейс по умолчанию или расширенный пользовательский интерфейс для поля со списком с CBS_DROPDOWN или стилем CBS_DROPDOWNLIST. Этот макрос можно использовать или явно отправить сообщение CB_SETEXTENDEDUI.
ComboBox_SetItemData	Задает определяемое приложением значение, связанное с указанным элементом списка в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_SETITEMDATA.
ComboBox_SetItemHeight	Задает высоту элементов списка или поля выбора в поле со списком. Этот макрос можно использовать или явно отправить сообщение CB_SETITEMHEIGHT.
ComboBox_SetMinVisible	Задает минимальное количество видимых элементов в раскрывающемся списке поля со списком.
ComboBox_SetText	Задает текст поля со списком.
ComboBox_ShowDropdown	Отображает или скрывает список в поле со списком. Этот макрос можно использовать или явно отправлять сообщение CB_SHOWDROPDOWN.

Сообщения

Раздел	Содержимое
CB_ADDSTRING	Добавляет строку в поле списка поля со списком. Если поле со списком не имеет стиля CBS_SORT , строка добавляется в конец списка. В противном случае строка вставляется в список, а список отсортирован.
CB_DELETESTRING	Удаляет строку в списке поля со списком.
CB_DIR	Добавляет имена в список, отображаемый полем со списком. Сообщение добавляет имена каталогов и файлов, которые соответствуют указанной строке и набору атрибутов файла. CB_DIR также можно добавить в список сопоставленные буквы дисков.
CB_FINDSTRING	Ищет поле со списком поля со списком для элемента, начинающегося с символов в указанной строке.
CB_FINDSTRINGEXACT	Находит первую строку списка в поле со списком, которое соответствует строке, указанной в параметре lParam .
CB_GETCOМБ OBOXINFO	Возвращает сведения об указанном поле со списком.
CB_GETCOUNT	Возвращает количество элементов в поле со списком.
CB_GETCUEBANNER	Возвращает текст баннера подсказки, отображаемый в элементе управления редактированием поля со списком. Отправьте это сообщение явным образом или с помощью макроса ComboBox_GetCueBannerText.
CB_GETCURSEL	Приложение отправляет сообщение CB_GETCURSEL , чтобы получить индекс выбранного в данный момент элемента, если таковой имеется, в списке поля со списком.
CB_GETDROPPEDCONTROLRECT	Приложение отправляет CB_GETDROPPEDCONTROLRECT сообщение, чтобы получить координаты экрана поля со списком в состоянии удаления.
CB_GETDROPPEDSTATE	Определяет, удаляется ли поле со списком поля со списком.
CB_GETDROPPEDWIDTH	Возвращает минимальную допустимую ширину (в пикселях) списка поля со списком с CBS_DROPDOWN или стилем CBS_DROPDOWNLIST.
CB_GETEDITSEL	Возвращает начальные и конечные позиции символов текущего выделения в элементе управления редактированием поля со списком.
CB_GETEXTENDEDUI	Определяет, имеет ли поле со списком пользовательский интерфейс по умолчанию или расширенный пользовательский интерфейс.
CB_GETHORIZONTALEXTENT	Получает ширину (в пикселях), которую поле списка можно прокручивать по горизонтали (ширина прокрутки). Это применимо только в том случае, если в списке есть горизонтальная полоса прокрутки.
CB_GETITEMDATA	Приложение отправляет CB_GETITEMDATA сообщение в поле со списком, чтобы получить предоставленное приложением значение, связанное с указанным элементом в поле со списком.
CB_GETITEMHEIGHT	Определяет высоту элементов списка или поля выбора в поле со списком.
CB_GETLBTEXT	Возвращает строку из списка поля со списком.
CB_GETLBTEXTLEN	Возвращает длину в символах строки в списке поля со списком.
CB_GETLOCALE	Возвращает текущий языковой стандарт поля со списком. Языковой стандарт используется для определения правильного порядка сортировки отображаемого текста для полей со списком с CBS_SORT стилем и текстом, добавленным с помощью сообщения CB_ADDSTRING.
CB_GETMINVISIBLE	Возвращает минимальное количество видимых элементов в раскрывающемся списке поля со списком.
CB_GETTOPINDEX	Приложение отправляет сообщение CB_GETTOPINDEX , чтобы получить отсчитываемый от нуля индекс первого видимого элемента в поле со списком. Изначально элемент с индексом 0 находится в верхней части списка, но если содержимое поля списка было прокручено, другой элемент может находиться в верхней части.
CB_INITSTORAGE	Приложение отправляет сообщение CB_INITSTORAGE перед добавлением большого количества элементов в поле со списком. Это сообщение выделяет память для хранения элементов списка.
CB_INSERTSTRING	Вставляет данные строки или элемента в список поля со списком. В отличие от сообщения CB_ADDSTRING, сообщение CB_INSERTSTRING не приводит к сортировке списка с CBS_SORT стилем.
CB_LIMITTEXT	Ограничивает длину текста, который пользователь может ввести в элемент управления редактированием поля со списком.
CB_RESETCONTENT	Удаляет все элементы из списка и редактирует элемент управления со списком.
CB_SELECTSTRING	Выполняет поиск списка поля со списком для элемента, начинающегося с символов в указанной строке. Если найден соответствующий элемент, он выбирается и копируется в элемент управления редактирования.
CB_SETCUEBANNER	Задает текст баннера подсказки, отображаемый для элемента управления редактированием поля со списком.
CB_SETCURSEL	Приложение отправляет сообщение CB_SETCURSEL , чтобы выбрать строку в списке поля со списком. При необходимости список прокрутит строку в представление. Текст в элементе управления редактированием поля со списком изменяется на отражение нового выделения, а любой предыдущий выбор в списке удаляется.
CB_SETDROPPEDWIDTH	Приложение отправляет сообщение CB_SETDROPPEDWIDTH, чтобы задать максимальную допустимую ширину (в пикселях) списка поля со списком с CBS_DROPDOWN или CBS_DROPDOWNLIST стилем.
CB_SETEDITSEL	Приложение отправляет сообщение CB_SETEDITSEL , чтобы выбрать символы в элементе управления редактированием поля со списком.
CB_SETEXTENDEDUI	Приложение отправляет сообщение CB_SETEXTENDEDUI, чтобы выбрать пользовательский интерфейс по умолчанию или расширенный пользовательский интерфейс для поля со списком с CBS_DROPDOWN или CBS_DROPDOWNLIST стилем.
CB_SETHORIZONTALEXTENT	Приложение отправляет сообщение CB_SETHORIZONTALEXTENT , чтобы задать ширину в пикселях, с помощью которой поле списка можно прокручивать по горизонтали (ширина прокрутки). Если ширина поля списка меньше этого значения, горизонтальная полоса прокрутки горизонтально прокручивает элементы в списке. Если ширина поля списка равна или больше этого значения, горизонтальная полоса прокрутки скрыта или, если поле со списком имеет стиль CBS_DISABLENOSCROLL , отключено.
CB_SETITEMDATA	Приложение отправляет сообщение CB_SETITEMDATA , чтобы задать значение, связанное с указанным элементом в поле со списком.
CB_SETITEMHEIGHT	Приложение отправляет сообщение CB_SETITEMHEIGHT , чтобы задать высоту элементов списка или поле выбора в поле со списком.
CB_SETLOCALE	Приложение отправляет CB_SETLOCALE сообщение, чтобы задать текущий языковой стандарт поля со списком. Если поле со списком содержит стиль CBS_SORT и строки добавляются с помощью CB_ADDSTRING, языковой стандарт поля со списком влияет на сортировку элементов списка.
CB_SETMINVISIBLE	Приложение отправляет сообщение CB_SETMINVISIBLE , чтобы задать минимальное количество видимых элементов в раскрывающемся списке поля со списком.
CB_SETTOPINDEX	Приложение отправляет сообщение CB_SETTOPINDEX , чтобы убедиться, что определенный элемент отображается в списке поля со списком. Система прокручивает содержимое поля списка, чтобы в верхней части списка отображался указанный элемент или достигнут максимальный диапазон прокрутки.
CB_SHOWDROPDOWN	Приложение отправляет сообщение CB_SHOWDROPDOWN для отображения или скрытия списка поля со списком с CBS_DROPDOWN или стилем CBS_DROPDOWNLIST.

Notifications

Раздел	Содержимое
CBN_CLOSEUP	Код уведомления CBN_CLOSEUP отправляется при закрытии списка поля со списком. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_DBLCLK	Код уведомления CBN_DBLCLK отправляется, когда пользователь дважды щелкает строку в списке поля со списком. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_DROPDOWN	Код уведомления CBN_DROPDOWN отправляется, когда появится поле со списком поля со списком. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_EDITCHANGE	Код уведомления CBN_EDITCHANGE отправляется после того, как пользователь принял действие, которое могло изменить текст в элементе управления редактированием поля со списком. В отличие от кода уведомления CBN_EDITUPDATE, этот код уведомления отправляется после обновления системы экрана. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_EDITUPDATE	Код уведомления CBN_EDITUPDATE отправляется, когда часть элемента управления редактирования поля со списком будет отображать измененный текст. Этот код уведомления отправляется после форматирования текста элемента управления, но перед отображением текста. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_ERRSPACE	Код уведомления CBN_ERRSPACE отправляется, если поле со списком не может выделить достаточно памяти для выполнения конкретного запроса. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_KILLFOCUS	Код уведомления CBN_KILLFOCUS отправляется, когда поле со списком теряет фокус клавиатуры. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_SELCHANGE	Код уведомления CBN_SELCHANGE отправляется, когда пользователь изменяет текущий выбор в поле со списком. Пользователь может изменить выбор, щелкнув в списке или с помощью клавиш со стрелками. Родительское окно поля со списком получает это уведомление в виде сообщения WM_COMMAND с CBN_SELCHANGE в слове высокого порядка параметра wParam.
CBN_SELENDCANCEL	Код уведомления CBN_SELENDCANCEL отправляется, когда пользователь выбирает элемент, но затем выбирает другой элемент управления или закрывает диалоговое окно. Он указывает, что первоначальный выбор пользователя должен игнорироваться. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_SELENDOK	Код уведомления CBN_SELENDOK отправляется, когда пользователь выбирает элемент списка или выбирает элемент, а затем закрывает список. Он указывает, что выбор пользователя должен обрабатываться. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
CBN_SETFOCUS	Код уведомления CBN_SETFOCUS отправляется, когда поле со списком получает фокус клавиатуры. Родительское окно поля со списком получает этот код уведомления через сообщение WM_COMMAND .
WM_COMPAREITEM	Система отправляет сообщение WM_COMPAREITEM , чтобы определить относительное положение нового элемента в отсортированный список отсортированного поля со списком или списком, нарисованным владельцем. Всякий раз, когда приложение добавляет новый элемент, система отправляет это сообщение владельцу поля со списком или списка, созданного с помощью стиля CBS_SORT или LBS_SORT .
WM_DRAWITEM	Сообщение WM_DRAWITEM отправляется в родительское окно нарисованной владельцем кнопки, поля со списком, списка или меню при изменении визуального аспекта кнопки, поля со списком, списка или меню.
WM_MEASUREITEM	Сообщение WM_MEASUREITEM отправляется в окно владельца поля со списком, списка, элемента управления представлением списка или элемента меню при создании элемента управления или меню.

Структуры

Раздел	Содержимое
CO МБ OBOXINFO	Содержит сведения о состоянии поля со списком.
COMPAREITEMSTRUCT	Предоставляет идентификаторы и данные, предоставленные приложением, для двух элементов в отсортированного, нарисованного владельцем списка или поля со списком.
DRAWITEMSTRUCT	Предоставляет необходимые сведения о окне владельца, чтобы определить способ рисования элемента управления или элемента меню, нарисованного владельцем. Окно владельца элемента управления или элемента меню владельца получает указатель на эту структуру в качестве параметра lParam сообщения WM_DRAWITEM.
MEASUREITEMSTRUCT	Сообщает системе измерений элемента управления или элемента меню, нарисованного владельцем. Это позволяет системе правильно обрабатывать взаимодействие пользователей с элементом управления.

Константы

Раздел	Содержимое
Стили полей со списком	Чтобы создать поле со списком с помощью функции CreateWindow или CreateWindowEx, укажите класс CO МБ OBOX, соответствующие константы стиля окна и сочетание следующих стилей полей со списком.

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