TextComp(3U)

NAME
TextComp, TextView, TextGraphic, PSText - multiline text component subject, view, structured graphic, and PostScript external representation

SYNOPSIS
#include <Unidraw/Components/text.h>

DESCRIPTION
TextComp is a GraphicComp that defines a piece of multiline text. It uses a TextGraphic (a subclass of Label) to store its graphical attributes. TextView is a GraphicView for displaying the text. PSText is a PostScriptView that externalizes the subject's information in PostScript form.

TEXTCOMP PUBLIC OPERATIONS

TextComp(TextGraphic* = nil)
    The constructor takes an optional TextGraphic that defines the attributes of the text.

virtual void Interpret(Command*)

virtual void Uninterpret(Command*)
    TextComp redefines (Un)interpret to ignore BrushCmd and PatternCmd and to (un)interpret FontCmd.

TextGraphic* GetText()
    Return the TextGraphic that defines the text component's attributes. GetText is simply a more specific form of the GetGraphic operation.

TEXTVIEW PUBLIC OPERATIONS

TextView(TextComp* = nil)
    Create an TextView, optionally supplying the subject.

virtual void Interpret(Command*)
    TextView interprets AlignToGridCmd to align its lower-left to the grid.

virtual Manipulator* CreateManipulator(

Viewer*, Event&, Transformer*, Tool*

)

virtual void InterpretManipulator(Manipulator*)
    TextView redefines its response to manipulation with a GraphicCompTool. GraphicCompTool will let the user position and type out the component's text using TextManip. Positioning of the text will be influenced by gravity, if any. TextView also defines a response to the ReshapeTool to let the user edit the text. The subject is actually replaced (via ReplaceCmd) with a new TextComp subject positioned at the original TextComp's location but reflecting the edited text.

TextComp* GetTextComp()
    Return the subject.

TEXTVIEW PROTECTED OPERATIONS

virtual boolean TextChanged()
    Return whether the text in the subject is any different from that in the view.

TEXTGRAPHIC PUBLIC OPERATIONS

TextGraphic(const char*, int h, Graphic* = nil)

TextGraphic(const char*, Graphic*)
    Create a TextGraphic, specifying its text, optional inter-line spacing, and optional graphic from which to obtain default graphics attributes. TextGraphic stores a copy of the given string (behavior it inherits from Label). If inter-line spacing is not specified, then lines will be separated to reflect the font height reported by PSFont.

void SetLineHeight(int)

int GetLineHeight()
    Explicitly set and get the inter-line spacing.

virtual boolean operator == (TextGraphic&)

virtual boolean operator != (TextGraphic&)
    Report whether the given graphic contains or does not contain an identical copy of the text in this

PSTEXT PUBLIC OPERATIONS

PSText(TextComp* = nil)
    Construct a PostScript external representation of the given subject, if any.

PSTEXT PROTECTED OPERATIONS

const char* Filter(const char* string, int length)
    Filter excapes embedded control or other special characters that would cause syntax errors in the PostScript output.

SEE ALSO
FontCmd(3U), GraphicComp(3U), GraphicCompTool(3U), GraphicView(3U), Grid(3U), Label(3U), PostScriptView(3U), ReshapeTool(3U), align(3U), edit(3U), manips(3U), pspaint(3U)