Оператор Create Text
Оператор Create Text
Назначение:
Создает объект типа "текст".
Синтаксис:
Create Text
[ Into { Window window_id | Variable var_name } ] text_string
(x1, y1) (x2, y2) [ Font . . . ]
[ Label Line { Simple | Arrow } (label_x, label_y) ] [ Spacing { 1.0 | 1.5 | 2.0 } ]
[ Justify { Left | Center | Right } ] [ Angle text_angle ]
где
window_id – целое число, идентификатор окна Карты или Отчета; var_name – имя существующей объектной переменной;
text_string – текст длиной до 255 символов (многострочный текст содержит символ Chr$(10)); x1, y1 – координаты одного угла прямоугольника, заполненного текстом;
x2, y2 – координаты противоположного по диагонали угла прямоугольника; label_x, label_y – координаты места, к которому прикреплен текст; text_angle – угол поворота текста в градусах, действительная величина.
Слово Font начинает стандартное предложение для назначения стиля шрифта текстового объекта.
Описание:
Параметры x и y являются координатами в той системе координат, которая была объявлена до оператора Create Text. (Смотрите описание оператора Set CoordSys.) Если система не объявлялась, то координаты будут принимать значения широты и долготы. При этом надо учесть, что MapBasic игнорирует координатную систему самого окна Карты. Если объект создается для окна Отчета, параметры x и y интерпретируются как координаты на листе в объявленных ранее единицах измерения листа. (Смотрите описание оператора Set Paper Units.) Так XLкоордината – это расстояние от левого края листа до точки, а YLкоордината – расстояние от верхнего края листа. Перед созданием объекта в окне Отчета не забудьте выполнить оператор Set CoordSys Layout.
Параметры x1, y1, x2 и y2 задают прямоугольник текста. Если текстовый объект создается в окне Карты, текст будет заполнять заданную текстовую область так, чтобы длина строки была равна ширине текстовой области. Размер шрифта, заданный предложением Font, будет проигнорирован. В окне Отчета текст будет рисоваться заданного в предложении Font размера, при этом координаты верхнего левого угла текстовой области (x1, y1) будут задавать расположение объекта на листе, а вторая пара (x2, y2) будет проигнорирована.
Предложение Font назначает шрифт для текстового объекта. Если предложения нет в операторе, оператор Create Text использует текущую установку шрифта в MapInfo (шрифт можно изменить в диалоге команды НАСТРОЙКА > СТИЛЬ ТЕКСТА).
Смотрите также:
Autolabel, Font, Insert, Update
160 |
Справочник MapBasic |
Функция CreateText( )
Функция CreateText( )
Назначение:
Возвращает текстовый объект, созданный в определенном окне Карты.
Синтаксис:
CreateText(window_id , x , y , text , angle , anchor , offset)
window_id – целочисленный идентификатор окна Карты;
x , y – координаты, задающие закрепленное положение подписи;
text – строка с текстом подписи, представляющим текстовый объект;
angle – угол поворота подписи в градусах; для для горизонтального текста он равен нулю;
anchor – целое число типа Integer от 0 до 8, контролирующее расположение подписи относительно места привязки. Ниже перечислены возможные значения кодов, которые описаны в MAPBAL SIC.DEF.
LAYER_INFO_LBL_POS_CC (0)
LAYER_INFO_LBL_POS_TL (1)
LAYER_INFO_LBL_POS_TC (2)
LAYER_INFO_LBL_POS_TR (3)
LAYER_INFO_LBL_POS_CL (4)
LAYER_INFO_LBL_POS_CR (5)
LAYER_INFO_LBL_POS_BL (6)
LAYER_INFO_LBL_POS_BC (7)
LAYER_INFO_LBL_POS_BR (8)
Двухбуквенное окончание определяет ориентацию подписи: T=Top, B=Bottom, C=Center, R=Right, L=Left. Например, для размещения подписи ниже и правее места привязки, укажите код LAYER_INFO_LBL_POS_BR, или укажите значение 8.
offset – целое число от 0 до 50, расстояние в точках от подписи до точки привязки на подписываемом объекте; offset игнорируется, если значение кода привязки равно 0.
Величина, полученная в результате
Величина типа Object.
Описание:
Функция CreateText( ) возвращает величину типа Object, являющейся текстовым объектом.
Текстовый объект использует текущий стиль текста. Для создания текстового объекта с определенным стилем, используйте оператор Set Style перед CreateText( ).
В тот момент, когда текст создан, его высота контролируется размером текущего шрифта. Таким образом, после создания текстового объекта его высота зависит от размера окна Карты; изменение масштаба ведет к соответственному изменению размера текста.
Возвращаемый объект имеет тип Object и сохраняется в существующей строке таблицы (используя оператор Update) или вставлеяется в новую строку таблицы (используя оператор Insert).
Справочник MapBasic |
161 |
Функция CreateText( )
Пример:
Следующий пример создает текстовый объект и помещаеь его на Косметический слой Карты (целочисленная переменная i_map_id содержит идентификатор окна Карты).
Insert Into Cosmetic1 (Obj)
Values ( CreateText(i_map_id, 80, 42.4, ”Sales Map”, 0,0,0) )
Смотрите также:
Autolabel, Create Text, Font, Insert, Update
162 |
Справочник MapBasic |
Функция CurDate( )
Функция CurDate( )
Назначение:
Возвращает текущее значение даты в формате ГГГГММДД.
Синтаксис:
CurDate(_)
Величина, полученная в результате:
Дата.
Описание:
Функция CurDate(_) возвращает текущее значение даты.
Формат всегда будет вида – ГГГГММДД. Для того чтобы возвращаемое значение было в формате локальной системы, используйте функцию FormatDate$().
Пример:
Dim d_today As Date
d_today = CurDate( )
Смотрите также:
FormatDate$(), Day(_), Month(_), StringToDate(_), Timer(_), Weekday(_), Year(_)
Справочник MapBasic |
163 |
Функция CurrentBrush( )
Функция CurrentBrush( )
Назначение:
Возвращает значение установленного на данный момент стиля штриховки.
Синтаксис:
CurrentBrush(_)
Величина, полученная в результате:
Величина типа Brush.
Описание:
Функция CurrentBrush(_) возвращает значение текущей установки стиля штриха. В MapInfo это значение изменяется в диалоге команды НАСТРОЙКИ > СТИЛЬ ОБЛАСТЕЙ. Когда Вы рисуете в окне такие объекты, как эллипс, прямоугольник, сглаженный прямоугольник или регион, MapInfo заполняет его установленным штрихом. Когда программа на MapBasic создает такие объекты (например, оператором Create Region(_) без предложения Brush, объект заштриховывается в соответствии с текущей установкой стиля штриха в MapInfo.
Величина, полученная функцией CurrentBrush(_), может быть присвоена переменной типа Brush или использована как параметр в операторах, в которых используется установка стиля штриха (такие, как Set Map или Shade).
Для вывода отдельных характеристик стиля штриха (например, цвета) используется функция Style4 Attr(_).
Более подробно о стиле можно прочитать в описании предложения Brush.
Пример:
Dim b_current_fill As Brush
b_current_fill = CurrentBrush( )
Смотрите также:
Brush, MakeBrush( ), StyleAttr( )
164 |
Справочник MapBasic |
Функция CurrentFont( )
Функция CurrentFont( )
Назначение:
Возвращает значение шрифта, используемого в данный момент в окне Карты.
Синтаксис:
CurrentFont(_)
Величина, полученная в результате:
Величина типа Font.
Описание:
Функция возвращает значение текущей установки стиля шрифта. В MapInfo это значение изменяется в диалоге команды НАСТРОЙКИ > СТИЛЬ ТЕКСТА. Когда Вы создаете в окне текстовый объект, MapInfo рисует буквы установленным шрифтом. Когда программа MapBasic создает текстовый объект при помощи оператора Create Text без слова Font, объекту назначается шрифт в соответствии с текущей установкой шрифта в MapInfo.
Величина, полученная функцией CurrentFont(_), может быть присвоена переменной типа Font или использована как параметр в операторах, в которых используется установка шрифта.
Для вывода отдельных характеристик стиля шрифта (например, цвета) используется функция
StyleAttr(_).
Более подробно о стиле можно прочитать в описании предложения Font.
Пример:
Dim f_user_text As Font
f_user_text = CurrentFont( )
Смотрите также:
Font, MakeFont( ), Set Style, StyleAttr( )
Справочник MapBasic |
165 |
Функция CurrentPen( )
Функция CurrentPen( )
Назначение:
Возвращает значение установленного на данный момент стиля линии.
Синтаксис:
CurrentPen(_)
Величина, полученная в результате:
Величина типа Pen.
Описание:
Функция CurrentPen(_) возвращает значение текущей установки стиля линии. В MapInfo это значение изменяется в диалоге команды НАСТРОЙКИ > СТИЛЬ ЛИНИЙ. Когда Вы рисуете в окне такие объекты, как линия или полилиния или же объекты, имеющие границу, такие, как эллипс, прямоугольник, сглаженный прямоугольник или область, MapInfo создает линии в установленном стиле. Когда программа MapBasic создает такие объекты (например, оператором Create Line) без слова Pen, линии объекта рисуются в соответствии с текущей установкой стиля линии в MapInfo.
Величина, полученная функцией CurrentPen(_), может быть присвоена переменной типа Pen или использована как параметр в операторах, в которых используется установка стиля линии (такой, как
Set Map ).
Для вывода отдельных характеристик стиля линии (например, цвета) используется функция Style4 Attr(_).
Более подробно о стиле можно прочитать в описании предложения Pen.
Пример:
Dim p_user_pen As Pen
p_user_pen = CurrentPen( )
Смотрите также:
MakePen( ), Pen, Set Style, StyleAttr( )
166 |
Справочник MapBasic |
Функция CurrentSymbol( )
Функция CurrentSymbol( )
Назначение:
Возвращает значение установленного на данный момент стиля символа для точечного объекта.
Синтаксис:
CurrentSymbol(_)
Величина, полученная в результате:
Величина типа Symbol.
Описание:
Функция CurrentSymbol(_) возвращает значение текущей установки стиля символа для точечного объекта. В MapInfo это значение может изменяться в диалоге команды НАСТРОЙКИ > СТИЛЬ СИМВОЛОВ. Когда Вы рисуете в окне точечный объект, MapInfo обозначает его установленным символом. Когда программа MapBasic создает такой объект при помощи оператора Create Point без слова Symbol, объект изображается в соответствии с текущей установкой стиля символа в MapInfo.
Величина, полученная функцией CurrentSymbol(_), может быть присвоена переменной типа SymL bol или использована как параметр в операторах, в которых используется установка стиля символа (таких, как Set Map или Shade).
Для вывода отдельных характеристик стиля символа (например, цвета) используется функция
StyleAttr(_).
Более подробно о стиле можно прочитать в описании предложения Symbol.
Пример:
Dim sym_user_symbol As Symbol
sym_user_symbol = CurrentSymbol( )
Смотрите также: MakeSymbol( ), Set Style, StyleAttr( ), Symbol
Справочник MapBasic |
167 |