Иллюстрированный самоучитель по языку системы 1С:Предприятие

Системные предопределенные процедуры работы с таблицами

ОбработкаЯчейкиТаблицы

Предопределенная процедура обработки ячейки таблицы.

Описание:

ОбработкаЯчейкиТаблицы(<Значение>, <ФлагСтандартнойОбработки> , <КонтекстТаблицы>,
<Адрес>)

Англоязычный синоним:

SheetCellProcessing

Параметры:

<Значение> Здесь в процедуру передается вычисленное значение ячейки (задается в конфигураторе: "Свойства" ячейки, "Текст", "Значение").
<ФлагСтандартнойОбработки> Флаг, установка которого в теле процедуры в 1 приведет к выполнению стандартной обработки значения ячейки (открытию документа, элемента справочника и т. п.).
<КонтекстТаблицы> Необязательный параметр. Имя переменной, куда система передаст контекст всей таблицы (см. Передача контекста в качестве параметра). С помощью значения этого контекста можно произвольно манипулировать данной таблицей пока она открыта, например, вывести туда дополнительные секции или очистить и заполнить всю таблицу заново. Пока данный объект "Таблица" существует, тип значения данного параметра равен 100 (см. ТипЗначения), если закрыта – 0.
<Адрес> Необязательный параметр. Имя переменной, куда система передаст адрес ячейки/объекта в формате "R1C1:R2C2".

Описание:

Вызов процедуры ОбработкаЯчейкиТаблицы на исполнение производится в системе 1С:Предприятие по двойному щелчку мыши или по нажатию клавиши "Enter" в табличном документе на выбранной ячейке.

Замечание
ОбработкаЯчейкиТаблицы – предопределенная процедура. Она не является встроенной процедурой языка. Для нее определено только название и синтаксис. Тело процедуры должно быть написано пользователем, осуществляющим конфигурирование, в программном модуле формы, из которой сформирован табличный документ или в глобальном модуле
.

Замечание
Объект типа "СписокЗначений" может записываться в поле "значение" ячейки таблицы и использоваться затем процедурой ОбработкаЯчейкиТаблицы
.

Важно
Если процедура описана в модуле формы, то вызывается она, иначе система запускает одноименную процедуру из глобального модуля
.

Внимание
Данная предопределенная процедура не вызывается при выборе ячейки таблицы в режиме ввода данных. Для этого случая вызывается предопределенная процедура ПриВыбореЯчейкиТаблицы
.

Пример:

Процедура ОбработкаЯчейкиТаблицы(ЗначениеЯчейки, Флаг)

// Тело процедуры

//. . .

КонецПроцедуры
Если Вы заметили ошибку, выделите, пожалуйста, необходимый текст и нажмите CTRL + Enter, чтобы сообщить об этом редактору.