Глава 6. Работа со списками в Visual Studio 2005
Для изучения работы со списками нам вполне подойдет предыдущий проект решения, все что сделаем — удалим коды в обработчиках событий нажатия кнопок и контролы (Рис.1.).
Рис.1. Проект решения
Параграф 1. Работа со списками в ListBox
1.1. Основные свойства ListBox
Поместим на форму контрол ListBox и рассмотрим его свойства.
Как и ранее, здесь будут рассмотрены только свойства о которых не упоминалось в предыдущих параграфах или которых нет у ранее использованных нами контролов.
Свойство DataSource, DisplayMember и ValueMember определяет имя таблицы или массива, поля и значения которых отображаются в списке при работе с базами данных. Тоесть, заполнить ComboBox можно используя не только Add метод, но и DataSource, DisplayMember, и ValueMember свойства. Подробно речь об этом будет вестись при рассмотрении вопросов, связанных с работой с базами данных. Свойтво DataSource может быть использовано при загрузке ListBox из массивов.
Свойство HorizontalExtent устанавливает ширину в пикселях для Scrollbar при значении свойтва HorizontalScrollbar true. Если ширина ListBox меньшая чем значение этого свойства, горизонтальная полоса прокрутки включена. Если ширина ListBox равна или большая чем это значение, горизонтальная полоса прокрутки скрыта.
Свойство IntegralHeight позволяет задать вертикальный размер списка. Если его значение true,то вертикальный размер кратен числу отображаемых элементов и в окне не будет показыватья частично отображаемые элементы списка.
Свойство ItemHeight позволяет задать вертикальный размер элемента списка.
Свойство MultiColumn позволяет разместить элементы списка в несколько колонок, число которых изменяется в зависимости от числа элементов колонок, но при этом выход элементов за вертикальные границы окна не происходит (как результат — нет и не может быть вертикальной прокрутки).
Свойство SelectionMode определяет режим селективного выбора строк и может иметь значения:
None — выборка пунктов зкрыта — при попытке выбора программно возбуждается прерывание, по клику мышкой строка не выделяется;
One — одновременно может быть выбран только один пунт как мышкой так и пограммно. Следуюший код покажет выбранной, при значении свойства SelectionMode установленным в One, только строку 3 (2, если считать строки от 0, как они реально нумерованы в ListBox):
MultiSimple — может быть выделено несколько пунктов списка, в предыдущем коде 3.
MultiExtended — может быть выделено несколько пунктов списка, в предыдущем коде 3, пользователю доступны клавиши Shift, Cntrl и стрелки для выделения.
Отметим, что при выделении в режимах MultiSimple и MultiExtend ноер индекса выделенного пункта не соответствует порядку выделения строк, а только их порядку в списе. Если к предыдущему коду добавить следующие строки, то несмотря на то, что поменяны местами индексы для вывода — вывод строк будет все равно последовательный (меню View\Output).
Свойство Sorted позволяет отсортировать список, наприер код:
выведет список в виде:
Свойство UseTabStop показывает возможность использовать в элементах списка символы табуляции.
Номера опций отстоят от слова «Опция» на расстоянии, определяемом табуляцией при listBox1.UseTabStops = true; и будут отображены слитно со словом, а сам символ табуляции как нечитаемый, при listBox1.UseTabStops = false.
1.2. Операции над списками ListBox
И так, на заготовку проекта добавим (если еще это не сделано) контрол ListBox, устанавливаем его размеры и свойства в соответствиии с приведенным выше их описанием. Можно оставить и принятые по умолчанию, так как они не влияют на примеры, которые будут приводиться ниже. Свойство SelectionMode установим в MultiExtend, подберем размеры и приложение готово к экспериментам.
Основное свойство ListBox — свойство Items. Оно является просто коллекцией объектов типа строки, тоесть свойство ListBox.Items имеет тип ListBox.ObjectCollection.
1.2.1. Добавление строк в ListBox
Для задания свойства Items на этапе разработки необходимо кликнуть на многоточии рядом с ним в окне Properties и, тем самым, вызвать String Collection Editor. В нем можно ввести необходимые тексты строк, которые после нажатия кнопки «OK» появятся в окне контрола.
Для добавления строк программно можно воспользовться методом Add (уже использованном нами выше).
Чтобы показать, как можно заносить в контрол данные из массива строк, приведем следующий код:
В ListBox пункты добавляются вниз, чтобы изменить порядок добавления пунктов можно воспользоваться методом ListBox.ObjectCollection Insert():
В этом сучае последовательноть расположения пунктов изменилась на противоположную.
Метод Insert позволяет вставить новый пункт в любое место списка.
Если все пункты списка известны, то достаточно для их отображения выполнить следующий код ипользующий метод свойства Items AddRange:
Еще один способ добавления строк — через создание массива системных объектов:
И последний пример, с использоанием cвойтва DataSource, однако следует помнить, что при ипользовании данного cпособа источник данных только отображается в контроле и, поэтому, удалить из контрола пункт не удастся:
1.2.2. Доступ к строкам в ListBox
Для показа доступа к строкам запишем в код обработчика для кнопки 2 следующий код:
После нажатия кнопки 1, выделения мышкой любой из оценок и нажатия кнопки 2, текст пункта будет отображаться в заглавии формы (Почему именно сюда — в свойтво Text — очень мало кода, чтобы посмотреть при отладке значение переменной, часто это гораздо быстрее чем любой другой способ).
Этот же эффект можно достичь и используя свойство Text:
Это означает, что свойство Text хранит только содержимое текста выбранного пункта. Кроме того при выборе нескольких пунктов (Selection Mode MultiSimple или MultiExtendet) в свойтве Tеxt хранится текст только одного пункта — верхнего.
Для того чтобы получить номер выбранной строки списка, изменим обработчик кода нажатия кнопки 2 на следующий:
При выполнении можем видеть в заголовке формы номера индексов.
Следующий код, демонстрирующий возможность использования свойства Items — Count, выведет в заголовок имена всех пунктов списка:
Следующий код также показывает возможность извлечения текста строки, выбранной кликом мышки, с использовнием обработчиков событий. Создадим обработчик события listBox1_MouseDown (напомним — вкладка Events окна Proporties, двойной клик в поле события) и поместим в него следующий код:
Для определения индекса и действий над пунктом списка можно воспользоваться методом FindString, возвращающим индекс пункта с найденным текстом:
1.2.3. Удаление пунктов из списка
Для удаления пунктов из списка можно воспользоватьсяя одним из следующих способов:
Возможность удаления повторяющихся строк можно продемонстрировать на кодах следующих обработчиков:
1.2.4. Изменяем цвет и шрифт пунктов списка
Для изменения цвет пунктов контрола воспользуемся изменением цвета при их отрисовке. Для этого установим свойство DrawMode ListBox в OwnerDrawFixed. После этого создадим обработчик события DrawItem для ListBox и поместим туда следующий код:
После запуска решения результат видим на Рис.2.
Рис.2. Изменения цвета пунктов списков
Изменения шрифта потребует дополнительных затрат, связанных с тем, что это изменение ведет к изменению размеров ячейки поля окна для пункта списка и, как результат, — Windows каким то образом должен быть оповещен, где какой пункт списка отрисован в окне. Для этого, поимо обработчика обытия DrawItem, необходимо создать обработчик события MeasureItem. Код обработчика события нажатия кнопки 1 практически не меняем, за исключением того, что необходимо сделать так, чтобы событие MeasureItem вызывлось для каждого пункта перерисовки списка (DrawMode д.б. OwnerDrawVariable):
Тогда иходный код для обработчиков DrawItem и MeasureItem может быть cледующим:
Результат релизации данного решения представлен на Рис.3.
Рис.3. Изменения шрифтов пунктов ListBox
1.2.5. Загрузка ListBox из файлов
Специальных методов для работы с файлами в ListBox нет, поэтому можно поступить анлогично тоу, как это делалось при загрузке TextBox.
Проверим в заголовке наличие кода using System.IO; и пишем в обработчике события нажатия кнопки 1 следующий код:
Код не требует пояснений — почти его точную копию мы уже видели при загрузки компонента TextBox.
Для записи в файл можно воспользоваться следующим кодом:
Другие возможности работы с файлами будут показаны при рассмотрении параграфа «Загрузка ComboBox из файлов».
Параграф 2. Работа со списками в ComboBox
2.1. Основные свойства ComboBox
Как и ранее, убираем из проекта коды всех обработчиков событий нажатия кнопок, все функции относящиеся к ListBox и сам контрол ListBox и помещаем на форму контрол ComboBox.
Рассмотрим его свойства (те, с которыми мы еще не встречались ранее):
Свойство DropDownStyle — определяет интерфейс с пользователем (стиль и возожность достута к текстовому полю ComboBox). При значении свойства DropDown это выпадающий список с возможностью изменения текстового поля, при DropDownList — доступ к текстовому полю закрыт. При значении свойства Simple список постоянно открыт (естетвенно отсутствует кнопка раскрытия списка), а редактирование поля Text разрешено.
Программная смена DropDownStyle выглядит несколько иначе, чем простое присваивание значения:
Свойство DropDownWidth — определяет ширину раскрывающейся части поля со списком. DropDownWidth не может быть меньшая чем ширина ComboBox. На Рис.3. (см. ниже) видно, как влияет свойство DropDownWidth на вид выпадающего списка при значении свойства DropDownWidth более размера контрола.
Других cвойств, отличных от войтв контрола ListBox у ComboBox нет, но приутствют все остльные его свойтва. Это означает, что ComboBox по существу тот же ListBox, но имеющий для свойства Text отдельное поле и имеющий возможноть отображать пункты списка как выпадающие. Поэтому, далее, практически повторены уже используемые при рассмотрении контрола ListBox коды, в которых учтены лишь незначительные особенности ComboBox.
2.2. Операции над списками в ComboBox
2.2.1. Добавление строк в ComboBox
Для задания свойства Items на этапе разработки необходимо кликнуть на многоточии рядом с ним в окне Proporties и, тем самым, вызвать String Collection Editor. В нем можно ввести необходимые тексты строк, которые после нажатия кнопки «OK» появятся в окне контрола.
Для добавления строк программно можно воспользовться одним из ледующих методов:
2.2.2. Доступ к строкам в ComboBox
Особенностью ComboBox, отличющей его от ListBox, является то, что выбранный текст визуально можно посмотреть в окошечке Text, в oстальном отличия по дотупу к пунктам списка между контролми нет. Напомним рассмотренные методы:
2.2.3. Удаление пунктов из списка
Для удаления пунктов из списка воспользуемся одним из способов:
Следующий пример демонстрирует возможность множественного удаления повторяющихся строк в списке при использовании метода FindStringExact, который ищет указанную строку с указанного индекса или начала списка и, при нахождении, возвращает ее индекс.
Этот код можно использовать для выборки пунктов из списка в некоторый отобранный список, например в другой ListBox, ComboBox или TextBox.
2.2.4. Изменяем цвет пунктов списка
В обработчике события нажатия кнопки 1 пишем код инициализации списка
Так как DrawMode =OwnerDrawVariable, то мы можем выполнить перерисовку по своему усмотрению содержимого ComboBox, как это уже делалоь выше. Создаем событие для ComboBox comboBox1_DrawItem, в котором и отображаем пункты требуемыми цветами и шрифтами:
И последнее, необходимо сообщить Windows размеры пунктов — для этого создадим для контрола обрботчик события MeasureItem, который при стиле OWNERDRAWVARIABLE вызываетя при отрисовки каждого элемента в списке (иначе только один раз).
Результт выполнения показан на Рис.4.
Рис.4. Изменения цвета и шрифтов пунктов списков
2.2.5. Загрузка ComboBox из файлов
Ряд возможнотей по загрузке спиков из фйлов и их сохранению в файлах были рассмотрены несколько ранее в параграфе «Загрузка ListBox из файлов»(они полностью подходят и для ComboBox), здесь мы только добавим несколько других возможностей.
Как и ранее создадим список (используем все тоже решение и, как и ранее, только меняем коды обработчиков событий):
Запишем созданный список в файл (не забудем включить в заголовок код using System.IO;) непосредственно используя StreamWriter.
В директории . \bin\debug\ будет создан фйл a.txt в который загружены строки созданного списка.
Для того, чтобы в этом убедиться и поазать возможность загрузки пунктов списка из файла, допишем код обработчика нажатия кнопки 2:
После реализации решения спиок будет загружен из файла, причем в окно Text будет выведен последний пункт списка.
Параграф 3. Возможности выделения в ListBox и ComboBox
При всей схожести свойств контролов возможности выделения части текста пункта в них несколько различны. Это различие основано на том, что у ListBox нет свойств SelectionStart и SelectionLength. Рассмотрим пример загрузки контролов и програмной cелекции(естественно добавив в проект решения контрол ListBox):
Результат выполнения этого кода представлен на Рис.5.
Рис.5. Возможности прогрмной селекции в ComboBox и ListBox
Параграф 4. Особенности ипользования контрола CheckedListBox
Контрол CheckedListBox по набору свойств почти полностью соответствует ListBox. Среди уникальных войств (которых нет у ListBox):
Свойство ChekOnClick при значении true разрешает выбор пункта списка и пометку его галочкой.
Свойство ThreeDCheckBoxes позволяет менять внешний вид окошечек для пометки с плоского на утопленный.
Других отличительных от ListBox свойств, отображеых в оне Proporties у CheckedListBox нет. Все это говорит о том, что принципы работы со списками у них одни и теже, одни и теже и методы. И, естетвенно, у CheckedListBox должны быть, и еть, свойства для хранения информации о помеченных пунктах списка.
Так у CheckedListBox есть метод GetItemCheckState(), позволяющий определить помечен ли пунт списка. Следующий код выведет в cвойство Text окна «Checked» если пункт первый списка помечен галочкой и «Uncecked» в противном случае.
Заметим, что, как и ранее, перед проверкой стояния флжка методом GetItemCheckState() можно определить индекс конкретного пункта, например:
Вся совоупность индексов помеченных пунктов хранится в свойстве CheckedIndices, как коллекция (совокупность чиел, начинающихся с 0) и, проверяя наличие номера индекса в коллекции, можно определить помечен ли тот или иной пункт. Для демонтрации использования этого свойства вновь преобразуем проект решения. Убираем из проекта коды всех обработчиков событий нажатия кнопок, все функции относящиеся к ListBox и ComboBox и сами эти контролы и помещаем на форму контрол CheckedListBox (впрочем, Вы, скорее всего, это уже сделали). В обработчик нажатия кнопки 1 пишем код заполнения спика (как и ожидалось — он не отличется от уже ипользовавшихся ранее):
Следующий код выведет в свойство Text номера всех помеченных пунктов, как показано на Рис.6.
Рис.6. Определение помеченных индексов в СheckedListBox
Свойство CheckedItems также является коллекцией помеченных пунктов, но не их номеров, а названий в виде объектов типа строка. Следующий код выведет в свойство Text формы уже не номера пунутов, а их текст(Рис.7.):
Рис.7. Определение текста помеченных индексов в СheckedListBox
Молчанов Владислав 25.07.2004г.
Адаптировано к VS 2005 11.11.2006г.