Метод AddItem

Добавляет новый элемент списка в элемент управления поле ввода с раскр вающимся списком или поле ввода со списком, предоставляя при этом возможность задать и декс элемента.

Применение

ComboBox, ListBox

Синтаксис

Control.AddItem(cItem [,nIndex] [,nColumn])

Параметры

cItem

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

nIndex

Задает положение элемента списка. Если в качестве nIndex задано допустимое значение, cItem располагается в элементе управления в указанной позиции. Если задан уже существующий индекс nIndex, новый элемент вставляется в заданную позицию, а все следующие за ним элемент смещаются на одну позицию по направлению к концу списка поля ввода.

Если аргумент nIndex опущен, а свойство Sorted имеет значение "истина" (.T.), элемент cItem добавляется с соблюдением алфавитного порядка сортировки. Если nIndex опущен и свойство Sorted имеет значение "ложь" (.F.), элемент cItem добавляется в конец списка поля ввода.

nColumn

Задает столбец элемента управления, в который добавляется новый элемент списка. По умолчанию используется столбец 1.

Комментарии

Используйте метод AddItem или AddListItem, когда устанавливаете значение свойства RowSourceType равным 0 (None).

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

nItemID целое число, используемое в качестве уникального идентификатора данного элеме та списка в элементе управления: первому записанному элементу списка соответствует nItemID = 1, если не задан иной nItemID.

nIndex целое число, соответствующее порядку, в котором элементы отображаются в списке: первому элементу отвечает nIndex = 1.