Вставляет новую колонку в дерево значений на указанную позицию
Синтаксис
Метод Вставить() имеет следующий синтаксис:
КолонкаДереваЗначений Вставить(Индекс, [Имя=""], [Тип], [Заголовок=""], [Ширина=0])
А также альтернативный англоязычный синтаксис:
ValueTreeColumn Insert(Index, [Name=""], [Type], [Title=""], [Width=0])
Параметры
Описание параметров метода Вставить():
| Имя параметра* | Тип | Описание |
|---|---|---|
| Индекс | Число | Индекс вставляемой колонки. |
| Имя | Строка | Имя колонки. Значение по умолчанию: Пустая строка |
| Тип | ОписаниеТипов | Объект, описывающий допустимые типы значений для колонки. Если параметр не указан, в колонке можно будет хранить значение любого типа.
Обратите внимание, что после создания колонки, тип значения изменить нельзя!
|
| Заголовок | Строка | Заголовок колонки дерева значений. Используется при визуальном отображении дерева значений. Значение по умолчанию: Пустая строка |
| Ширина | Число | Ширина колонки в символах. Используется при визуальном отображении дерева значений. Значение по умолчанию: 0 |
| *Жирным шрифтом выделены обязательные параметры | ||
Возвращаемое значение
КолонкаДереваЗначений
Описание
Метод Вставить() вставляет новую колонку в коллекцию колонок дерева значений на указанную позицию. Метод возвращает добавленную колонку для дальнейших действий.
Доступность
| Версия | Поддержка |
|---|---|
| 8.1 | Сервер, Клиент, Внешнее соединение |
| 8.2 | Сервер, Толстый клиент, Внешнее соединение |
| 8.3 | Сервер, Толстый клиент, Внешнее соединение, Мобильный автономный сервер, Мобильное приложение |
Пример использования
Пример кода с использованием метода Вставить():
//создание нового дерева значений дз = Новый ДеревоЗначений; //добавляем колонки НоваяКолонка = дз.Колонки.Вставить(0,,Новый ОписаниеТипов("Строка")); НоваяКолонка.Имя = "Наименование"; НоваяКолонка.Заголовок = "Наименование"; //НоваяКолонка.ТипЗначения = Новый ОписаниеТипов("Строка");//исключение! //однако удобнее сразу описывать все параметры: НоваяКолонка = дз.Колонки.Вставить(0, "КодТовара", Новый ОписаниеТипов("Строка"), "Код товара");