Руководство разработчика

Теги форматирования текста в ячейках таблицы

Строковые данные, отображающиеся в ячейках таблицы, можно отформатировать, то есть задать выравнивание, цвет текста и фона, шрифт, разбить текст на подстроки. Форматирование текста осуществляется с помощью тегов форматирования, которые указываются непосредственно в строке. Теги форматирования можно использовать в ячейках отчета, в расчетных столбцах и расчетных таблицах журнала, в расчетных столбцах плана аналитики. Теги форматирования имеют наивысший приоритет среди других настроек схемы таблицы. Каждый новый тег начинается с символа"/". При указании тегов, для которых предусмотрены значения, указывается сначала тег, потом его значения без пробелов и разделителей.

Например: "Текст/HR/TRB" - выравнивание вправо, цвет текста в невыделенной ячейке - красный, в выделенной ячейке - синий. Значение по умолчанию (*) указывает на то, что будет использовано форматирование, определенное в платформе для данного случая. Например: "Текст/B*V" - цвет фона в невыделенной ячейке - по умолчанию (белый), цвет фона в выделенной ячейке - фиолетовый.

ТегОписание
/T<цвет текста><цвет выделенного текста>Цвет текста. Необходимо указать два значения: первое - для невыбранной ячейки, второе - для выбранной.
/B<цвет фона><цвет выделенного фона>Цвет фона. Необходимо указать два значения: первое - для невыбранной ячейки, второе - для выбранной.
Значения тегов /Т и /B
*значение по умолчанию
Nчерный (black)
Wбелый (white)
Rкрасный (red)
Gзеленый (green)
Bсиний (blue)
Cголубой (cyan)
Yжелтый (yellow)
Eсерый (grey)
Dтемно-серый (dark-grey)
Vфиолетовый (violet)
Oоранжевый (orange)
A(R,G,B)цвет в палитре RGB. В скобках указываются числовые значения красного, зеленого и синего цветов, разделяемые запятыми. Пробелы недопустимы. Значение А допустимо задавать совместно с другими значениями цветов, например: "Текст/BA(137,193,224)B" - цвет фона в обычной ячейке - оттенок синего, заданный в палитре RGB, цвет фона в выделенной ячейке - синий.
/F<значение>Начертание текста
Значения тега /F
*значение по умолчанию
Nнормальный (normal)
B жирный (bold)
I наклонный (italic)
Jжирный, наклонный
/Z<значение>Размер текста
Значения тега /F
*значение по умолчанию
Nнормальный (normal)
Sмелкий (small)
Lкрупный (large)
/H<значение>Горизонтальное выравнивание
Значения тега /F
*значение по умолчанию
Rвправо (right)
Cпо центру(center)
Lвлево (left)
/V<значение>Вертикальное выравнивание
Значения тега /F
*значение по умолчанию
Tвправо (top)
Cпо центру(center)
B влево (bottom)
/R<значение>Рельеф ячейки
Значения тега /F
*значение по умолчанию; соотвествует /R-2
+<значение>Выпуклый. Необходимо задать значение в диапазоне от 0 до 4. Если значение не входит в диапазон - используется значение по умолчанию.
-<значение>Вдавленный. Необходимо задать значение в диапазоне от 0 до 4. Если значение не входит в диапазон - используется значение по умолчанию.
Bвлево (bottom)
/NПеревод строки. Следующие за тегом символы начнутся с новой строки.
/SНачало новой подстроки. Для каждой новой подстроки можно указывать свои теги форматирования (основное отличие от тега /N).
//Символ "/"
/L<значение> В отчетах не используется! Отображение линий, разделяющих подстроки. В зависимости от значения тега можно разделять указанные в ячейке подстроки (значения после тега /S), пустые подстроки (подстроки, получившиеся в результате форматирования значения в соседней ячейке; запись "/S" не является пустой подстрокой!), а также устанавливать разделитель между существующими и пустыми подстроками.Проиллюстрируем принцип использования тега с помощью рисунка:

В Ячейке1 четыре подстроки (запись строки с тегами - "1/S2/S3/S4"). В Ячейке2 две подстроки ("Подстрока1/SПодстрока2"). Черная линия демонстрирует использование тега /L1 в Ячейке2 (разделяются подстроки, указанные в значении ячейки), красная линия - использование тега /L2 (разделитель установлен после второй подстроки, далее подстрок в ячейке нет), синяя линия - использование тега /L3 (разделяются "несуществующие" подстроки 3 и 4) В одной строке можно использовать несколько тегов /L с различными значениями. Например, чтобы разделить абсолютно все подстроки - можно указать три тега: "L1/L2/L3".
Значения тега /L
1Разделение существующих подстрок
2Разделение существующих и пустых подстрок (граница данных)
3Разделение пустых подстрок

Примеры

Строка с тэгамиРезультат
"Значение/TNB/BEC"
"Значение/T*R/BE*/FB"
"/BW*/S/BB*/S/BR* "
/*Строка в Столбце1*/
"1/HC/S2/S3/S4/L1"
/*Строка в Столбце2*/
"Подстрока1/L2/L3"

См. также: