Студия/OnGetCellVisualProperties

OnGetCellVisualProperties (Визуальные события)
Применимость: Таблица значений Тип события: Прерывающее Статус разработки: Реализована

• Начальная страница
• Редактор форм
• Визуальные события

Событие, возникающее до прорисовки ячейки таблицы. Вызывается для получения визуальных параметров (таких как цвет, шрифт и пр.) для ячейки. Для больших таблиц может замедлить обновление интерфейса (так как будут происходить множественные вызовы, вместо одного, который изменит параметры всех элементов), рекомендуется пользоваться методами Icon, BackgroundColor, FontColor, FontStyle. Ниже приведена последовательность и описана разница между событиями, выполняющимися после обновления таблицы и использующимися для заполнения ячеек таблицы или изменения их визуальных свойств:

1. OnInitLine -- выполняется сразу для всего диапазона загруженных в буфер новых строк. Используется как для заполнения значений ячеек, так и для изменения их визуальных свойств.
2. OnShowLine -- выполняется для диапазона новых строк, выводящихся на экран. Рекомендуется для больших таблиц, особенно не связанных с базой данных. Может вызываться несколько раз по мере того, как пользователь просматривает содержимое таблицы. Используется как для заполнения значений ячеек, так и для изменения их визуальных свойств.
3. OnGetCellVisualProperties -- выполняется для новых строк, выводящихся на экран, вызывается для каждого столбца каждой строки. Для больших таблиц может замедлить обновление. Обычно используется только для изменения визуальных свойств ячейки.

Аргументы

• <Index (INT)> - Переменная задает индекс строки ячейки таблицы, визуальные свойства которой необходимо получить.
• <ColumnIndex (INT)> - Переменная задает индекс столбца ячейки таблицы, визуальные свойства которой необходимо получить.
• - (возможен аргумент-переменная (ByRef)) Переменная задает наименование шрифта, который будет использован для прорисовки ячейки. Шрифт задан в стандартном формате, см. Формат записи шрифтов в системе (для разделения используются запятые, наименования шрифта, размер шрифта, градус поворота и режим сглаживания игнорируются). Заполняется шрифтом по умолчанию при вызове.
• <BackColor (INT)> - (возможен аргумент-переменная (ByRef)) Переменная задает цвет фона ячейки. Заполняется цветом по умолчанию при вызове (_CLR_WINDOW).
• <IconIndex (INT)> - (возможен аргумент-переменная (ByRef)) Переменная задает индекс иконки ячейки. По умолчанию равна 0 (без иконки). Иконки отображаются в столбцах таблицы, для которых задан флаг ShowIcons).

Примеры

//Пример обработчика OnGetCellVisualProperties
If ColumnIndex=1 Then
  MainTab:=Form.оТМЦ.Value;
  Эл:=MainTab.Get(Index,"@ELEMENT");
  //Вывести стандартную иконку в первый столбик таблицы.
  IconIndex:=GetStandardIcon(Эл);
EndIf;