ТЕКСТ


Апплет может отображать элемент текст в прямоугольнике-окне или вдоль линии (прямой, ломанной, дуги окружности и т.д.).

Элементу текст могут быть заданы гарнитура, размер и стиль шрифта. Используя специальные лексемы, можно управлять форматированием текста, например,  указать отступ по вертикали и/или горизонтали, осуществить сдвиг на несколько пробелов, перейти на следующую строку, регулировать смещение между символами и отступ от линии. 

Для задания и отображения текста в апплете используются два метода:  text и ptext

text   [pos_code x y pos=p X=x Y=y width=w height=h hlines=hl draw_rect=x,y,width,height scroll=x,y shifts=sx,sy  font=<имя шрифта>:<размер>,<стиль> ]  value = '' "/"/ %%  

Текстовая информация, заданная  методом  text,  располагается в прямоугольнике-окне, размеры и положение которого можно указать по-разному.

Положение базовой точки задается ключевым параметром pos или позиционным параметром pos_code.
Координаты базовой точки можно задать в позиционных параметрах x,y, либо в соответствующих ключевых параметрах, либо указать в значениях параметра draw_rect.
Ширина и высота прямоугольника задаются ключевыми параметрами width,height или в значениях параметра  draw_rect.
(См. "Управление расположением прямоугольника относительно базовой точки"). 

Параметр value является обязательным и должен содержать текстовую строку (собственно текст подлежащий отображению). Значением этого параметра является подстрока, заключенная в символы-разделители. 

Остальные параметры не являются обязательными и определяют внешний вид текста (ориентацию, расположение, форматирование и.т.д. ). Полное описание параметров метода приведено ниже.

Управление размещением текста осуществляется через задание параметров для трех геометрических объектов: 
   - базовой точки; 
   - прямоугольника-окна для вывода текста; 
   - прямоугольника-текста.

Прямоугольник текста может быть, в общем случае, больше или меньше прямоугольника-окна, "через которое мы смотрим на текст".

Размещением прямоугольника-текста управляют bits(2-3)(0x0С) и bits(6-7)(0xС0) параметра  promt_align. Текст может быть выровнен по левой и/или правой границам или центрирован. Дополнительно можно задать отступы от текста до границ элемента используя параметры xpaddingypadding или paddings.

Управлять расположением прямоугольника-текста в прямоугольнике-окне можно за счет
- задания параметра pos_code ( bits(2-3)(0x0С) и bits(6-7)(0xС0) );
- ключевого параметра scroll;
- задания атрибутов слоя xpaddingypadding или paddings, которые регулируют отступы от текста до границ элемента ( см."Атрибуты слоя, управляющие форматированием текстовой информации").

В примере №17  приведено несколько вариантов с различным форматированием текстовой информации, показан подробный пример выравнивания прямоугольника-текста  в прямоугольнике-окне по горизонтали и вертикали. А так же имеется возможность динамического изменения различных параметров метода text.

pltext [step=sw shifts=sx,sy] value=""/''/%%  line=line_coords | iline=iline_coords |
           link=layer:number font=
<имя шрифта>:<размер>,<стиль> 

При использовании метода ptext, текст будет располагаться вдоль линии, которая определяется в параметрах метода. Используя параметр step можно указать смещением между символами, параметр shift определяет отступ текста от линии.

В пример №18 показано размещение текста вдоль различных линий и имеется возможность динамического изменения различных параметров метода ptext.

Синтаксис и описание параметров метода text

text   [pos_code x y pos=p X=x Y=y width=w height=h hlines=hl draw_rect=x,y,width,height scroll=x,y shifts=sx,sy  font=<имя шрифта>:<размер>,<стиль> ]   value ""/"/%% [<common key params>]

pos_code
положение прямоугольника-окна относительно базовой точки (x,y) и положение текста в прямоугольнике-окне задается десятичным, восьмеричным или шестнадцатиричным числом
(если не задан или задан равным -1, то устанавливается значение из параметра text_pos слоя):
 bits(0-1)(0x03) - размещение прямоугольника-окна по горизонтали:
=0 - базовая точка на левой границе,
=1 - базовая точка в середине,
=2 - базовая точка на правой границе.
bits(2-3)(0x0C) - размещение текста в прямоугольнике-окне по горизонтали
=0 - выровнен по левой границе,
=1 - центрирован,
=2 = выровнен по правой границе.
bits(4-5)(0x30) - размещение прямоугольника-окна по вертикали:
=0 - базовая точка на верхней границе,
=1 - базовая точка в середине,
=2 - базовая точка на нижней границе.
bits(5-6)(0xC0) - размещение текста в прямоугольнике-окне по вертикали
=0 - выровнен по верхней границе,
=1 - центрирован,
=2 - выровнен по нижней границе
x
X-координата базовой точк
y
Y-координата базовой точки
pos
положение прямоугольника-окна относительно базовой
точки (x,y) и положение текста в прямоугольнике-окне (см. pos_code)
pos - это альтернативное задание pos_code, через
ключевой параметр, таким образом все можно задать через ключевые
параметры и первые три позиционных параметра после text можно
опустить.
shifts
немасштабируемое смещение прямоугольника-окна по горизонтали и
вертикали относительно заданного положения (xshift,yshift)
width
ширина прямоугольника-окна, если не задано или равно 0, то
выбирается ширина текста
height
высота прямоугольника-окна, если не задано или равно 0, то
выбирается высота текста
hlines
высота прямоугольника-окна в текстовых строках
draw_rect
альтернативный способ задания x, y, width и height прямоугольника-окна
scroll
величина смещения прямоугольника с текстом относительно
прямоугольника-окна
font
параметры шрифта: <имя>:<размер>[,<стиль>],  где
имя - имя шрифта или "*", если имя шрифта сохраняется,
размер - размер шрифта или -1, если размер шрифта сохраняется
стиль - стиль шрифта - целое число значения которого означают:
0 - plain, 1 - bold, 2 - italic, 3 - ibold
value
содержимое элемента текст.
Значением этого параметра является подстрока, 
заключенная в символы-разделители. 
(Символами-разделителями могут быть кавычка, 
кавычка бэкслеш, знак процента.)

Эта строка можетсодержать перечень специальных 
лексем для управления форматированием:
 <br> - переход на новую строку, 
<sp:num> - сдвинуться на num пробелов,
 <shift:sx,sy> - для всех следующих лексем установить 
сдвиг на sx пикселов по горизонтали и 
sy пикселов по вертикали, 
</shift> - признак конца действия сдвига 
<font=name:size,style> - для всех следующих лексем установить шрифт
</font> - признак конца действия шрифта
<common key params>
одинаковые для всех элементов слоя ключевые параметры (подробнее ...)
Синтаксис и описание параметров метода ptext

Текст расположенный вдоль линии
pltext [step=sw shifts=sx,sy] value=""/''/%% line=line_coords | iline=iline_coords |
           link=layer:number font  [<common key params>] 
step
немасштабируемое дополнительное смещение между символами
shifts
немасштабируемое смещение текста относительно положения, 
определяемого линией (xshift,yshift)
value
содержимое элемента текст. 
Значением этого параметра является подстрока, 
заключенная в символы-разделители. 
(Символами-разделителями могут быть кавычка, 
кавычка бэкслеш, знак процента.)
line
координаты линии, вдоль которой располагается текст, заданные 
как последовательность пар чисел x0,y0, ... xn,yn
iline
координаты линии, вдоль которой располагается текст, заданные как 
координаты первой точки и последовательность приращений координат
для остальных точек линии x0,y0,dx1,dy1, ... xn,yn
link
ссылка на линию: 
layer
- имя слоя, 
number - номер элемента в слое, 
если имя слоя не задано (eline=:number)
это означает выбор линии из текущего слоя
font
параметры шрифта: <имя>:<размер>[,<стиль>], где
имя - имя шрифта или "*", если имя шрифта сохраняется, 
размер - размер шрифта или -1, если размер шрифта сохраняется
стиль - стиль шрифта - целое число значения которого означают: 
0 - plain, 1 - bold, 2 - italic, 3 - ibold
<common key params>
одинаковые для всех элементов слоя ключевые параметры (подробнее ...)
На главную страницу
Наверх