<СтрокаТаблицы> УстановитьТипЯчейки (SetCellType)

<< Click to Display Table of Contents >>

Navigation:  Раздел 7 Расширения языка L9 > Объекты пользовательского интерфейса > Объекты для работы с таблицами > СтрокаТаблицы (GridRow) > Методы >

<СтрокаТаблицы> УстановитьТипЯчейки (SetCellType)


Описание:

Устанавливает тип ячейки.

Синтаксис:

УстановитьТипЯчейки(<Индекс>, <Тип>, <Параметр1>, <Параметр2>)

SetCellType(<Index>, <Type>, <Parameter1>, <Parameter2>)

Параметры:

Индекс (Index) – порядковый номер ячейки, начиная с нуля. Если порядковый номер меньше нуля или превышает количество ячеек, т.е. указан индекс ячейки несуществующей в строке, то метод не выполняется. Параметр не является обязательным. Если параметр отсутствует, то в конец строки добавляется еще одна ячейка, и для нее устанавливается тип. Добавление ячейки производится только при выполнении данного метода без указания индекса.

Тип (Type) – тип ячейки. Возможные значения типов ячеек см. в таблице ниже.

Набор следующих параметров зависит от передаваемого типа ячейки в параметре "Тип" ("Type"):

1.

При типе редактируемого значения ячейки "Строка" ("String"):

Параметр (Parameter1) – максимальная длина строкового значения ячейки. Параметр необязателен. Если параметр отсутствует или принимает значение 0, то ограничение на длину не устанавливается.

Параметр (Parameter2) – отсутствует.

2.

При типе редактируемого значения ячейки "Пароль" ("Password"):

Параметр (Parameter1) – максимальная длина строки пароля в ячейке. Параметр необязателен. Если параметр отсутствует или принимает значение 0, то ограничение на длину не устанавливается.

Параметр (Parameter2) – отсутствует.

3.

При типе редактируемого значения ячейки "Число" ("Number"):

Параметр (Parameter1) – максимальная длина дробной части числового значения в ячейке. Параметр необязателен. Если параметр отсутствует или принимает значение "0", то в ячейке будет отображаться целое число.

Параметр (Parameter2) – логический признак, что в ячейке отображается число со знаком. Параметр необязателен. Если параметр отсутствует или принимает значение "Ложь" ("False") – в ячейке отображается число без знака.

4.

При типе редактируемого значения ячейки "Список" ("Combobox"):

Параметр (Parameter1) – массив возможных строк – элементов выпадающего списка,  ключи массива – целые числа, порядковые номера строк.

Параметр (Parameter2) – отсутствует.

5.

При типе редактируемого значения ячейки "ДатаВремя" ("DateTime"):

Параметр (Parameter1) – логический признак, что в ячейке отображается значение даты с полным (4 цифры) представлением года. Параметр необязателен. Если параметр отсутствует или принимает значение "Ложь" ("False") – в ячейке отображается дата с неполным представлением года (последние 2 цифры года).

Параметр (Parameter2) – логический признак, что в ячейке отображается значение времени. Параметр необязателен. Если параметр отсутствует или принимает значение "Истина" ("True") – в ячейке отображается время.

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

Нет.

Пример:

//В примере создается строка – новый объект "ДанныеТаблСтроки",

//для ячейки с номером 0 в строке устанавливается числовой тип со знаком.
Запись = Новый("СтрокаТаблицы");
Запись.УстановитьТипЯчейки(0, "Число", 2, Истина);