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