Апплет может отображать элемент текст в
прямоугольнике-окне или вдоль линии (прямой,
ломанной, дуги окружности и т.д.).
Элементу текст могут быть заданы гарнитура,
размер и стиль шрифта. Используя специальные
лексемы, можно управлять форматированием
текста, например, указать отступ по
вертикали и/или горизонтали, осуществить
сдвиг на несколько пробелов, перейти на
следующую строку, регулировать смещение
между символами и отступ от линии.
Для задания и отображения текста в апплете
используются два метода: 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. Текст может
быть выровнен по левой и/или правой
границам или центрирован. Дополнительно можно задать отступы от
текста до границ элемента используя
параметры xpadding, ypadding
или paddings.
Управлять расположением прямоугольника-текста
в прямоугольнике-окне можно за счет
- задания параметра pos_code ( bits(2-3)(0x0С) и bits(6-7)(0xС0)
);
- ключевого параметра scroll;
- задания атрибутов слоя xpadding, ypadding
или 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>
- одинаковые для всех элементов слоя ключевые параметры
(подробнее ...)
|