Поле со списком (элементы управления Windows)
В этом разделе содержатся сведения о элементах программирования, используемых с полями со списком. Поле со списком — это уникальный тип элемента управления, определенный классом 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, соответствующие константы стиля окна и сочетание следующих стилей полей со списком. |