Свойство

Описание

MultiColumn

Selectedlndices Selectedltem

Selectedltems SelectionMode

Sorted

Text

Checkedlndices

Checkedltems

CheckOnClick

ThreeDCheckBoxes

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

Коллекция, содержащая начинающиеся с нуля индексы выбранных элементов списка

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

Коллекция, содержащая все элементы, выбранные в текущий момент времени

Перечисление ListSelectionMode в списке позволяет выбирать один из четырех режимов выбора:

None - ни один элемент не может быть выбран

One - только один элемент может быть выбран в каждый конкретный момент времени

Multisimple - возможен выбор нескольких элементов. При использовании этого стиля при щелчке на элементе он становится выбранным и остается таким даже в случае щелчка на другом элементе до повторного щелчка на нем

MultiExtended - возможен выбор нескольких элементов. Для осуществления выбора можно использовать клавиши <Ctrl>, <Shift> и клавиши со стрелками. В отличие от режима Multisimple, простой щелчок на одном элементе, а затем щелчок на другом будет приводить к выбору только второго элемента, на котором был выполнен щелчок

Когда значение этого свойства установлено равным true, элемент управления ListBox выполняет упорядочение содержащихся в нем элементов по алфавиту

Со свойствами Text мы встречались при рассмотрении многих элементов управления, но это работает иначе, чем все ранее рассмотренные. При установке свойства Text элемента управления ListBox он выполняет поиск элемента, который соответствует указанному тексту, и выбирает его. При получении свойства Text возвращенным значением является первый выбранный элемент списка. Использование этого свойства невозможно, если значение свойства SelectionMode равно None.

(Только для CheckedListBox.) Это свойство - коллекция, содержащая индексы всех элементов в CheckedListBox, которые находятся в состоянии

Checked или Indeterminate

(Только для CheckedListBox.) Это СВОЙСТВО - коллекция, содержащая все элементы в CheckedListBox, которые находятся в состоянии Checked или Indeterminate

(Только для CheckedListBox.) Если значение этого свойства - true, элемент будет изменять свое состояние при каждом щелчке на нем

(Только для CheckedListBox.) Устанавливая это свойство, можно выбирать для использования плоские и обычные элементы управления CheckBox

Окончание табл. 15.14

Методы элемента управления ListBox

Чтобы эффективно работать со списком, нужно знать ряд методов, которые можно вызывать. Наиболее часто используемые методы описаны в табл. 15.15. Если не указано иное, эти методы принадлежат обоим классам ListBox и CheckedListBox.

Таблица 15.15. Часто используемые события классов ListBox и CheckedListBox Метод Описание

ClearSelected () Очищает все выборки в элементе управления ListBox

Findstring () Находит в элементе управления ListBox первую строку, начинаю-

щуюся с указанной строки (например, Findstring ( а ) найдет в ListBox первую строку, начинающуюся с символа а )

FindStringExact () Подобен методу Findstring, НО ВСЯ строка должна совпадать с

указанной

Getselected () Возвращает значение, указывающее то, выбран ли элемент

SetSeiected () Устанавливает или очищает выбор элемента

ToString () Возвращает элемент, выбранный в текущий момент времени

GetitemChecked () (Только для CheckedListBox.) Возвращает значение, указывающее

на то, выбран ли элемент

GetitemCheckstate () (Только для CheckedListBox.) Возвращает значение, указывающее

состояние установки флажка элемента

SetitemChecked () (Только для CheckedListBox.) Устанавливает указанный элемент в

состояние Checked

SetltemCheckState () (Только для CheckedListBox.) Устанавливает состояние установки

флажка элемента

События элемента управления ListBox

Обычно события, о которых требуется знать при работе с элементами управления ListBox или CheckedListBox, связаны также с выборками, выполняемыми пользователем. События элемента управления ListBox описаны в табл. 15.16.

Таблица 15.16. Часто используемые события классов ListBox и CheckedListBox Событие Описание

itemCheck (Только для CheckedListBox.) Происходит при изменении состоя-

ния установки флажка одного из элементов списка

SelectedindexChanged Происходит при изменении индекса выбранного элемента

В следующем практическом примере мы создадим оба элемента управления - ListBox и CheckedListBox. Пользователи могут установить флажки элементов в элементе управления CheckedListBox, а затем щелкнуть на кнопке, которая перемещает выбранные элементы в обычный список ListBox.

Практическое занятие Работа С Элементом управления ListBox

Создайте диалоговое окно следующим образом.

1. Создайте новое Windows-приложение List Boxes в каталоге С: \BegVCSharp\ ChapterlS.

2. Добавьте в форму элементы управления ListBox, CheckedListBox и Button и измените их имена, как показано на рис. 15.16.

а- LUt Boxte

□ checkedLislBoxPossiblcVaJue

lisBoxS elected

buHonMove

Puc. 15.16. Форма приложения List Boxes

3. Измените значение свойства Text кнопки на Move.

4. Измените значение свойства CheckOnClick элемента управления CheckedListBox на true.

Описание полученных результатов

Мы начнем с пррверки свойства Count коллекции Checkedltems. Его значение будет больше нуля, если любые элементы в коллекции выбраны. Затем мы очищает все элементы в списке listBoxSelected и циклически просматриваем коллекцию Checkedltems, добавляя каждый элемент в список listBoxSelected. И, наконец, мы удаляем все флажки в CheckedListBox.

Теперь лишь нужно, чтобы список CheckedListBox содержал какие-то элементы для перемещения. Элементы можно добавлять в представлении Design View, выбирая свойство Items в окне Properties и добавляя элементы, как показано на рис. 15.17.

Элементы можно также добавлять в коде - например, в конструкторе формы:

Stiiiifj Collection Editoi

tnter the strings In the collection (one per Йпв):

Three

Four

Five

Seven

Eight

Nine

Caned

Puc. 15.17. Элементы добавляются в редакторе строковых коллекций