Объект ListBox (Outlook Forms Script)
Отображает список значений и позволяет выбирать одно или несколько значений.
Замечания
Если элемент ListBox привязан к источнику данных, элемент ListBox сохраняет выбранное значение в этом источнике данных.
ListBox может отображаться в виде списка или группы элементов управления OptionButton или CheckBox.
Свойством по умолчанию для ListBox является свойство Value .
Событием по умолчанию для ListBox является событие Click .
В раскрывающийся элемент ListBox невозможно поместить текст.
Стили элемента ListBox
Вы можете выбрать любой из двух стилей представления элемента ListBox. Это выражается свойством ListStyle . Каждый из них реализует собственный способ выбора элементов в списке.
Если стиль равен 0, каждый элемент находится в отдельной строке; пользователь выбирает элемент, выделяя одну или несколько строк.
Если стиль равен 1, в начале каждой строки отображается optionButton или CheckBox . В этом случае для выбора элемента пользователь нажимает кнопку или устанавливает флажок. Флажки отображаются только в том случае, если свойство MultiSelect имеет значение True.
События
| Имя | Описание |
|---|---|
| Click | Происходит, когда пользователь окончательно выбирает для элемента управления значение, которое содержит несколько возможных значений. |
Методы
| Имя | Описание |
|---|---|
| AddItem | Для элемента ListBox с одним столбцом метод AddItem добавляет элемент в список. Для многоколоний ListBox этот метод добавляет строку в список. |
| Clear | Удаляет все записи в списке в ListBox. |
| RemoveItem | Удаляет строку из списка в ListBox. |
Свойства
| Имя | Описание |
|---|---|
| BackColor | Возвращает или задает значение Long , указывающее цвет фона объекта . Для чтения и записи. |
| BorderColor | Возвращает или задает значение Long , указывающее цвет границы объекта. Для чтения и записи. |
| BorderStyle | Возвращает или задает целое число , указывающее тип границы элемента управления. Для чтения и записи. |
| BoundColumn | Возвращает или задает значение Variant , определяющее источник данных в многоколоний ListBox. Для чтения и записи. |
| Столбец | Возвращает или задает значение Variant , представляющее одно значение, столбец значений или двумерный массив для загрузки в ListBox. Для чтения и записи. |
| ColumnCount | Возвращает или задает значение Long , представляющее количество столбцов, отображаемых в списке. Для чтения и записи. |
| ColumnHeads | Возвращает или задает логическое значение, указывающее, отображается ли одна строка заголовков столбцов. Для чтения и записи. |
| ColumnWidths | Возвращает или задает значение String , указывающее ширину каждого столбца в многоколоний ListBox. Для чтения и записи. |
| Enabled | Возвращает или задает логическое значение, указывающее, может ли элемент управления получать фокус и реагировать на события, созданные пользователем. Для чтения и записи. |
| ForeColor | Возвращает или задает значение Long , указывающее цвет переднего плана объекта. Для чтения и записи. |
| IMEMode | Возвращает или задает целое число , указывающее режим времени выполнения по умолчанию редактора метода ввода (IME) для элемента управления. Для чтения и записи. |
| IntegralHeight | Возвращает или задает логическое значение, указывающее, отображает ли ListBox полные строки текста в списке или частичные строки. Для чтения и записи. |
| List | Возвращает или задает значение Variant , представляющее указанную запись в ListBox. Для чтения и записи. |
| ListCount | Возвращает значение Long , представляющее количество записей списка в элементе управления . Только для чтения. |
| ListIndex | Возвращает или задает значение Variant , представляющее текущий выбранный элемент в элементе ListBox. Для чтения и записи. |
| ListStyle | Возвращает или задает целое число , указывающее визуальный вид списка в ListBox. Для чтения и записи. |
| Locked | Возвращает или задает логическое значение, указывающее, можно ли изменять элемент управления. Для чтения и записи. |
| MatchEntry | Возвращает или задает целое число , указывающее, как ListBox выполняет поиск в списке по типу пользователя. Для чтения и записи. |
| MouseIcon | Возвращает значение String , представляющее полное имя пути настраиваемого значка, назначаемого элементу управления. Только для чтения. |
| MousePointer | Возвращает или задает целое число , указывающее тип указателя, отображаемого при наведении указателя мыши на определенный объект. Для чтения и записи. |
| MultiSelect | Возвращает или задает целое число , указывающее, допускает ли объект несколько выделений. Для чтения и записи. |
| Selected | Возвращает или задает логическое значение, указывающее состояние выделения элементов в ListBox. Для чтения и записи. |
| SpecialEffect | Возвращает или задает целое число , указывающее внешний вид объекта. Для чтения и записи. |
| Текст | Возвращает или задает строку, указывающую текст в элементе ListBox, изменяя выбранную строку в элементе управления . Для чтения и записи. |
| TextAlign | Возвращает или задает целое число , указывающее способ выравнивания текста в элементе управления . Для чтения и записи. |
| TextColumn | Возвращает или задает значение Variant , которое идентифицирует столбец в элементе ListBox для отображения пользователю. Для чтения и записи. |
| TopIndex | Возвращает или задает значение Long , представляющее индекс элемента списка, отображаемого в верхней позиции списка. Для чтения и записи. |
| Value (Значение) | Возвращает или задает значение Variant , указывающее значение в BoundColumn выбранных строк. Для чтения и записи. |
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.