Admin: 1 revision imported

2021-02-07T06:55:39Z

1 revision imported

Admin at 15:58, 26 August 2020

2020-08-26T15:58:11Z

New page

{{infobox function
|name=OnGetCellVisualProperties
|element=Таблица значений
|caption=Визуальные события
|eventtype=Прерывающее
|status=2}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Студия/Редактор форм|Редактор форм]]
* [[Студия/Визуальные события|Визуальные события]]}}
Событие, возникающее до прорисовки ячейки таблицы. Вызывается для получения визуальных параметров (таких как цвет, шрифт и пр.) для ячейки. Для больших таблиц может замедлить обновление интерфейса (так как будут происходить множественные вызовы, вместо одного, который изменит параметры всех элементов), рекомендуется пользоваться методами [[Tab.Icon|Icon]], [[Tab.BackgroundColor|BackgroundColor]], [[Tab.FontColor|FontColor]], [[Tab.FontStyle|FontStyle]]. Ниже приведена последовательность и описана разница между событиями, выполняющимися после обновления таблицы и использующимися для заполнения ячеек таблицы или изменения их визуальных свойств:
# [[Студия/OnInitLine|OnInitLine]] -- выполняется сразу для всего диапазона загруженных в буфер новых строк. Используется как для заполнения значений ячеек, так и для изменения их визуальных свойств.
# [[Студия/OnShowLine|OnShowLine]] -- выполняется для диапазона новых строк, выводящихся на экран. Рекомендуется для больших таблиц, особенно не связанных с базой данных. Может вызываться несколько раз по мере того, как пользователь просматривает содержимое таблицы. Используется как для заполнения значений ячеек, так и для изменения их визуальных свойств.
# [[Студия/OnGetCellVisualProperties|OnGetCellVisualProperties]] -- выполняется для новых строк, выводящихся на экран, вызывается для каждого столбца каждой строки. Для больших таблиц может замедлить обновление. Обычно используется только для изменения визуальных свойств ячейки.

==== Аргументы ====
* <code>''<Index (INT)>''</code> - Переменная задает индекс строки ячейки таблицы, визуальные свойства которой необходимо получить.
* <code>''<ColumnIndex (INT)>''</code> - Переменная задает индекс столбца ячейки таблицы, визуальные свойства которой необходимо получить.
* <code>''<Font (STRING)>''</code> - {{ByRef}} Переменная задает наименование шрифта, который будет использован для прорисовки ячейки. Шрифт задан в стандартном формате, см. [[Формат записи шрифтов в системе]] (для разделения используются запятые, наименования шрифта, размер шрифта, градус поворота и режим сглаживания игнорируются). Заполняется шрифтом по умолчанию при вызове.
* <code>''<BackColor (INT)>''</code> - {{ByRef}} Переменная задает цвет фона ячейки. Заполняется цветом по умолчанию при вызове (_CLR_WINDOW).
* <code>''<IconIndex (INT)>''</code> - {{ByRef}} Переменная задает индекс иконки ячейки. По умолчанию равна 0 (без иконки). Иконки отображаются в столбцах таблицы, для которых задан флаг [[Tab.Column.ShowIcons|ShowIcons]]).

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

← Older revision	Revision as of 06:55, 7 February 2021
(No difference)

Студия/OnGetCellVisualProperties - Revision history

Admin: 1 revision imported

Admin at 15:58, 26 August 2020