Tab.FontColor

From SunFlurry wiki
Jump to: navigation, search
  FontColor (Работа с цветом текста)
Объект:Таблица
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, число, неверные индексы
Визуальность:Да

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

Синтаксис

Tab.FontColor(<Индекс строки ячейки (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.FontColor(i,0,_CLR_RED);
  Else
    MainTab.FontColor(i,0,_CLR_WINDOWTEXT);
  EndIf;  
Enddo;