<< Click to Display Table of Contents >> Navigation:  Раздел 7 Расширения языка L9 > Объекты пользовательского интерфейса > Объекты для работы с таблицами > ТаблицаДанных (DataGrid) > Методы > <ТаблицаДанных> ВставитьСтолбец (InsertColumn)

Описание:

Вставляет  новый столбец.

Первая форма синтаксиса:

ВставитьСтолбец(<Номер>, <Заголовок>, <Ширина>, <Выравнивание>,

               <Флаг1>, <Флаг2>, <Иконка>)

InsertColumn(<Number>, <Title>, <Width>, <Alignment>,

             <Flag1>, <Flag2>, <Icon>)

Параметры:

Номер (Number) – номер вставляемого столбца. Нумерация начинается с 0. Номер должен быть равен числу столбцов, т.е. на текущий момент возможно только добавление столбцов при условии, что строк в таблицу еще добавлено не было.

Заголовок (Title) – заголовок столбца. Строковое значение.

Ширина (Width) –  ширина столбца. Числовое значение.

Выравнивание (Alignment) – идентификатор форматирования текста  заголовка столбца. Строковое значение. Идентификаторы форматирование текста могут принимать следующие значения:

Флаг1 (Flag1) – признак видимости столбца. Если параметр принимает значение "Истина" ("True"), то столбец видимый. Если параметр принимает значение "Ложь" ("False"), то столбец невидимый. Если параметр не указан, то столбец видимый. Параметр не является обязательным.

Флаг2 (Flag2) – признак отображения иконок в строках столбца. Если параметр принимает значение "Истина" ("True"), то иконка отображается. Если параметр принимает значение "Ложь" ("False"), то иконка не отображается. Если параметр не указан, то иконки отображаются. Параметр не является обязательным.

Иконка (Icon) – объект "Иконка" ("Icon"). Параметр не является обязательным.

Возвращаемые значения:

Номер вставленного столбца, если новый столбец вставлен. Метод Возвращает значение "-1", если столбец не был вставлен.

Пример:

//В примере указаны параметры для столбца,

//который необходимо вставить в таблицу "Товары"
ЭтаФорма.Товары.ВставитьСтолбец(0, "№", 30, "Влево", Истина, Ложь)

 

Вторая форма синтаксиса:

ВставитьСтолбец(<Номер>, <Столбец>)

InsertColumn(<Number>, <Column>)

Параметры:

Номер (Number) – номер вставляемого столбца. Нумерация начинается с 0. Номер должен быть равен числу столбцов, т.е. на текущий момент возможно только добавление столбцов при условии, что строк в таблицу еще добавлено не было.

Столбец (Column) – объект "СтолбецТаблицы (GridColumn)".

Возвращаемые значения:

Номер вставленного столбца, если новый столбец вставлен. Метод Возвращает значение "-1", если столбец не был вставлен.

Пример:

//Вставка нового столбца

ЭтаФорма.ТаблицаДанных.ВставитьСтолбец(1, Столбец);