Tab.BackgroundColor

From SunFlurry wiki
Revision as of 18:23, 18 August 2019 by Admin (talk | contribs) (Created page with "{{infobox function |name=BackgroundColor |object=Таблица |caption=Работа с цветом фона |type=1 |status=2 |db=0 |exception=Невозможно пр...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  BackgroundColor (Работа с цветом фона)
Объект:Таблица
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, число, неверные индексы
Визуальность:Да

Функция считывает или устанавливает значение цвета фона ячейки в указанном столбце таблицы. Если столбец таблицы не указан цвет меняется для всей строки, если строка не указана для всех строк столбца или для всей таблицы, если не указана ни строка ни столбец. Цвет представлен 3 байтами (24 бит). Любая ячейка таблицы имеет атрибут цвета фона, функция также может использоваться для невизуальных таблиц.

Синтаксис

Tab.BackgroundColor(<Индекс строки ячейки (INT)>,<Индекс или наименование столбца ячейки (INT,STRING)>,<Новый цвет фона ячейки (INT)>):<Текущий цвет фона ячейки (INT)>

Аргументы

  • <Индекс строки ячейки (INT)> - (необязательный аргумент) Индекс строки для чтения или изменения цвета фона ячеек. Если аргумент опущен, цвет фона будет установлен для всех строк таблицы.
  • <Индекс или наименование столбца ячейки (INT,STRING)> - (необязательный аргумент) Аргумент задает наименование столбца ячеек, если он имеет тип строка, иначе задает номер столбца ячеек для которых требуется прочитать или изменить цвет фона. Если аргумент опущен или равен нулю, цвет фона будет установлен для всех ячеек выбранной строки таблицы.
  • <Новое цвет фона ячейки (INT)> - (необязательный аргумент) Аргумент задает цвет фона ячеек. Если аргумент опущен, цвет фона ячеек не будет изменен.

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

Возвращает текущий цвет фона первой из ячеек, заданных первым и вторым аргументами.

Примеры

//Ниже показан пример обработчика события OnInitLine для визуальной таблицы
MainTab:=Form.MainTab.Value;

//Цикл по всем строкам, которые нужно инициализировать
For i:=IndexFrom to IndexTo Do
  MainTab.CurLine:=i;
  //Строки, где столбик "Партия" не имеет выбранного значения, выделим красным цветом, остальные желтым
  //  Цвета смешиваются с текущим цветом окна, чтобы не нарушать общую цветовую гамму интерфейса
  if isEmpty(MainTab.Партия) Then
    MainTab.BackgroundColor(i,0,MixColors(_CLR_WINDOW,_CLR_RED,15));
  Else
    MainTab.BackgroundColor(i,0,MixColors(_CLR_WINDOW,_CLR_YELLOW,15));
  EndIf;  
Enddo;