На этом шаге мы рассмотрим назначение, основные свойства и методы этого элемента.

Элемент управления ListBox (Список) создается с помощью кнопки Список (ListBox) (рисунок 1).

Рис.1. Список в форме

Элемент управления ListBox применяется для хранения списка значений. Из списка пользователь может выбрать одно или несколько значений, которые в последующем будут использоваться в тексте программы.

Приведем наиболее часто используемые свойства элемента управления ListBox.

Таблица 1. Основные свойства ListBox
Свойство Назначение

ListIndex Возвращает номер текущего элемента списка. Нумерация элементов списка начинается с нуля

ListCount Возвращает число элементов списка

TopIndex Возвращает элемент списка с наибольшим номером

ColumnCount Устанавливает число столбцов в списке

TextColumn Устанавливает столбец в списке, элемент которого возвращается свойством Text

Enabled Допустимые значения: True (запрещен выбор значения из списка пользователем) и False (в противном случае)

Text Возвращает выбранный в списке элемент

List Возвращает элемент списка, стоящий на пересечении указанных строки и столбца. Синтаксис:
List (Row, Column)

RowSource Устанавливает диапазон, содержащий элементы списка

ControlSource Устанавливает диапазон (ячейку), куда возвращается выбранный элемент из списка

MultiSelect Устанавливает способ выбора элементов списка. Допустимые значения:

fmMultiSelectSingle (выбор только одного элемента);
fmMultiSelectMulti (разрешен выбор нескольких элементов посредством либо щелчка, либо нажатием клавиши Пробел);
fmMultiSelectExtended (разрешено использование клавиши Shift при выборе ряда последовательных элементов списка).

Selected Допустимые значения: True (если элемент списка выбран) и False (в противном случае). Используется для определения выделенного текста, когда свойство MultiSelect имеет значение fmMultiSelectMulti или fmMultiSelectExtended.

ColumnWidths Устанавливает ширину столбцов списка. Синтаксис:
ColumnWidths = String
String — строка, устанавливающая ширину столбцов. В следующем примере устанавливается ширина каждого из трех столбцов списка:
With ListBox1 .ColumnCount = 3 .ColumnWidths = "20;30;30" End With

ColumnHeads Допустимые значения: True (выводятся заголовки столбцов раскрывающегося списка) и False (в противном случае)

ListStyle Допустимые значения:

fmListStylePlain (выбранный элемент из списка выделяется цветом);
fmListStyleOption (перед каждым элементом в списке располагается флажок и выбор элемента из списка соответствует установке этого флажка).

MatchEntry Выводит первый подходящий элемент из списка при наборе его имени на клавиатуре. Допустимые значения:

fmMatchEntryNone (режим вывода подходящего элемента в списке отключен);
fmMatchEntryFirstLetter (вводит подходящий элемент по набранной первой букве. В этом случае, предпочтительно, чтобы элементы списка были бы упорядочены в алфавитном порядке)
fmMatchEntryComplete (вводит подходящий элемент по полному набранному имени).

BoundColumn Устанавливает тип, возвращаемый свойством Value. А именно,

если свойство BoundColumn равно 0, то свойство Value возвращает индекс выбранной строки, т.е. в этом случае оно действует как свойство ListIndex;
если свойство BoundColumn принимает значение из диапазона от 1 до количества столбцов в списке, то свойство Value возвращает элемент из выбранной строки, стоящий в столбце, определенном свойством BoundColumn.

Таблица 1. **Основные свойства ListBox**
Свойство	Назначение
ListIndex	Возвращает номер текущего элемента списка. Нумерация элементов списка начинается с нуля
ListCount	Возвращает число элементов списка
TopIndex	Возвращает элемент списка с наибольшим номером
ColumnCount	Устанавливает число столбцов в списке
TextColumn	Устанавливает столбец в списке, элемент которого возвращается свойством Text
Enabled	Допустимые значения: True (запрещен выбор значения из списка пользователем) и False (в противном случае)
Text	Возвращает выбранный в списке элемент
List	Возвращает элемент списка, стоящий на пересечении указанных строки и столбца. Синтаксис: List (Row, Column)
RowSource	Устанавливает диапазон, содержащий элементы списка
ControlSource	Устанавливает диапазон (ячейку), куда возвращается выбранный элемент из списка
MultiSelect	Устанавливает способ выбора элементов списка. Допустимые значения: fmMultiSelectSingle (выбор только одного элемента); fmMultiSelectMulti (разрешен выбор нескольких элементов посредством либо щелчка, либо нажатием клавиши *Пробел); fmMultiSelectExtended (разрешено использование клавиши Shift* при выборе ряда последовательных элементов списка).
Selected	Допустимые значения: True (если элемент списка выбран) и False (в противном случае). Используется для определения выделенного текста, когда свойство MultiSelect имеет значение fmMultiSelectMulti или fmMultiSelectExtended.
ColumnWidths	Устанавливает ширину столбцов списка. Синтаксис: ColumnWidths = String String — строка, устанавливающая ширину столбцов. В следующем примере устанавливается ширина каждого из трех столбцов списка: With ListBox1 .ColumnCount = 3 .ColumnWidths = "20;30;30" End With
ColumnHeads	Допустимые значения: True (выводятся заголовки столбцов раскрывающегося списка) и False (в противном случае)
ListStyle	Допустимые значения: fmListStylePlain (выбранный элемент из списка выделяется цветом); fmListStyleOption (перед каждым элементом в списке располагается флажок и выбор элемента из списка соответствует установке этого флажка).
MatchEntry	Выводит первый подходящий элемент из списка при наборе его имени на клавиатуре. Допустимые значения: fmMatchEntryNone (режим вывода подходящего элемента в списке отключен); fmMatchEntryFirstLetter (вводит подходящий элемент по набранной первой букве. В этом случае, предпочтительно, чтобы элементы списка были бы упорядочены в алфавитном порядке) fmMatchEntryComplete (вводит подходящий элемент по полному набранному имени).
BoundColumn	Устанавливает тип, возвращаемый свойством Value. А именно, если свойство BoundColumn равно 0, то свойство Value возвращает индекс выбранной строки, т.е. в этом случае оно действует как свойство ListIndex; если свойство BoundColumn принимает значение из диапазона от 1 до количества столбцов в списке, то свойство Value возвращает элемент из выбранной строки, стоящий в столбце, определенном свойством BoundColumn.

Приведем наиболее часто используемые методы элемента управления ListBox.

Таблица 2. Основные методы ListBox
Метод Назначение

Clear Удаляет все элементы из списка

RemoveItem Удаляет из списка элемент с указанным номером. Синтаксис:
RemoveItem (index)
Параметр index определяет номер удаляемого из списка элемента

AddItem Добавляет элемент в список. Синтаксис:
AddItem ([ item [, varIndex) ] )

item — элемент (строковое выражение), добавляемый в список;
varIndex — номер добавляемого элемента.

Таблица 2. **Основные методы ListBox**
Метод	Назначение
Clear	Удаляет все элементы из списка
RemoveItem	Удаляет из списка элемент с указанным номером. Синтаксис: RemoveItem (index) Параметр index определяет номер удаляемого из списка элемента
AddItem	Добавляет элемент в список. Синтаксис: AddItem ([ item [, varIndex) ] ) item — элемент (строковое выражение), добавляемый в список; varIndex — номер добавляемого элемента.

На следующем шаге мы рассмотрим особености заполнения списка.

Предыдущий шаг Содержание Следующий шаг