Name

---

      TEXTLINE__DEFINE

Purpose

---

      The purpose of this routine is to provide a line of text that can
      be displayed in a direct graphics draw widget. As a subclassed
      CATDATAATOM, the text is the "data" and can be manipulated with
      the GetData and SetData methods. The coordinate system of the
      TextLine object is either passed to it (a CatCoord object) or is
      a normalized coordinate system by default.

Authors

---

        FANNING SOFTWARE CONSULTING BURRIDGE COMPUTING
        1645 Sheely Drive 18 The Green South
        Fort Collins Warborough, Oxon
        CO 80526 USA OX10 7DN, ENGLAND
        Phone: 970-221-0438 Phone: +44 (0)1865 858279
        E-mail: davidf@dfanning.com E-mail: davidb@burridgecomputing.co.uk

Category

---

      Objects.

Syntax

---

      textObject = Obj_New("TEXTLINE", "This is a line of text")
      drawObject -> Add, textObject

Superclasses

---

      SELECTABLEOBJECT
      CATDATAATOM
      CATATOM
      CATCONTAINER IDLITCOMPONENT
      IDL_CONTAINER

Class Structure

---

  class = { TEXTLINE, $
            alignment: 0.0, $ ; The alignment of the text.
            background: 0L, $ ; A flag to indicate if a background box is drawn.
            bg_color: "", $ ; The background color.
            charsize: 0.0, $ ; The character size.
            color: "", $ ; The name of a color to draw text in.
            font: 0L, $ ; The font type (0-Hershey, 1-Hardware, 2-True-Type).
            orientation: 0.0, $ ; The orientation of the text
            thickness: 0.0, $ ; The CHARTHICK ness of the text.
            x: 0.0, $ ; The X location for drawing text.
            y: 0.0, $ ; The Y location for drawing text.
            width: 0.0, $ ; The width of the text line. (Set when drawn.)
            INHERITS SelectableObject $
          }
;

Messages

---

  TEXTLINE_CHANGED: This message is sent whenever SetProperty method is called and the NOMESSAGE
                      keyword is NOT set.

Notes And Restrictions

---

      If the font field is set to 0 (Hershey fonts) when drawn in PostScript output,
      the font type is switched to 1 (Hardware fonts).
      Rotation of text can only occur when the ALIGNMENT of the test is "centered". If you
      try to rotate the text, the alignment is changed. Hardware fonts cannot be rotated on
      the display.

Modification History

---

      Written by: David W. Fanning, 25 Jan 2004.
      Modified to work with MapCoord object. 25 June 2009. DWF.
      An invisible call to XYOUTS to get the width of the output line is actually
          drawn on the display when hardware fonts are used. Fixed. 15 July 2010. DWF.