Le portail francophone de la géomatique

Purpose

Creates a text object, such as a title, for a Map or Layout window.

Syntax

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  is an Integer window ID number, identifying a Map or Layout window
var_name  is the name of an existing object variable
text_string  specifies the string, up to 255 characters long, that will constitute the text object; to create a multiple-line text object, embed the function call Chr$(10) in the string
x1 , y1  are floating-point coordinates, specifying one corner of the rectangular area which the text will fill
x2 , y2  specify the opposite corner of the rectangular area which the text will fill

The Font clause specifies a text style. The point-size element of the Font is ignored if the text object is created in a Map window; see below.
label_x , label_y  specifies the position where the text object's label line is anchored
text_angle  is a Float value indicating the angle of rotation for the text object (in degrees)

Description

The x and y parameters use whatever coordinate system MapBasic is currently using. By default, MapBasic uses a longitude, latitude coordinate system, although the Set CoordSys statement can re-configure MapBasic to use a different coordinate system. If you need to create objects on a Layout window, you must first issue a Set CoordSys Layout statement.
The x1, y1, x2, and y2 arguments define a rectangular area. When you create text in a Map window, the text fills the rectangular area, which controls the text height; the point size specified in the Font clause is ignored. In a Layout window, text is drawn at the point size specified in the Font clause, with the upper-left corner of the text placed at the (x1, y1) location; the (x2, y2) arguments are ignored.