Метод УстановитьТипЯчейки (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, Истина);