SYNOPSIS

#include <Unidraw/Components/pad.h>

DESCRIPTION

PadComp is a Connector subclass that supports connectivity with two degrees of freedom. It uses a PadGraphic to store its graphical attributes. PadView is a GraphicView for displaying the pad. PSPad is a PostScriptView that externalizes the subject's information in PostScript form.

PADCOMP PUBLIC OPERATIONS

PadComp(PadGraphic* = nil)

The constructor takes an optional PadGraphic that defines the pad's graphical attributes.

virtual void Interpret(Command*)

virtual void Uninterpret(Command*)

PadComp (un)interprets a subset of commands that connectors can generally interpret, namely MoveCmd, BrushCmd, AlignCmd, MobilityCmd, DeleteCmd, and CutCmd.

virtual Mobility GetMobility()

virtual void SetMobility(Mobility)

PadComp redefines these functions to return and assign its _mobility protected member. The pad has fixed mobility initially.

Pad* GetPad()

Return the Pad graphic that defines the line's attributes. GetPad is simply a more specific form of the GetGraphic operation.

PADVIEW PUBLIC OPERATIONS

PadView(PadComp* = nil)

Create an PadView, optionally supplying the subject.

virtual void Interpret(Command*)

PadView interprets AlignToGridCmd to align its lower left to the grid.

virtual Manipulator* CreateManipulator(

Viewer*, Event&, Transformer*, Tool*

)

virtual void InterpretManipulator(Manipulator*)

PadViews respond only to manipulation by GraphicCompTools, MoveTools, and ConnectTools. PadView inherits its MoveTool response from ConnectorView. GraphicCompTool will let the user sweep out a rectangle that reflects the pad's size. Creation will be influenced by gravity, if any. PadView creates a ConnectManip in response to the ConnectTool, which will exhibit a gravational attraction to potential target connectors. PadView will produce a ConnectCmd to connect the pad to its target. A pad connected in this way will receive floating mobility.

PadComp* GetPadComp()

Return the subject.

PADVIEW PROTECTED OPERATIONS

PadGraphic* GetPad()

Return the PadGraphic that defines the pad's attributes. GetPad is simply a more specific form of the GetGraphic operation.

virtual PadComp* NewSubject(PadGraphic*)

A helper function that creates a PadComp subject with the given pad graphic. This function produces the proper subject when the GraphicCompTool's manipulator is interpreted. Subclasses can redefine this operation to return a PadComp subclass, thus eliminating the need to reimplement InterpretManipulator.

Manipulator* CreateGraphicCompManip(

Viewer*, Event&, Transformer*, Tool*

)

Manipulator* CreateConnectManip(

Viewer*, Event&, Transformer*, Tool*

)

Command* InterpretGraphicCompManip(Manipulator*)

Command* InterpretConnectManip(Manipulator*)

Helper functions used by CreateManipulator and InterpretManipulator to create and interpret the manipulators associated with GraphicCompTool and ConnectTool.

PADGRAPHIC PUBLIC OPERATIONS

PadGraphic(

Coord = 0, Coord = 0, Coord = 0, Coord = 0,

Graphic* = nil

)

Create a PadGraphic, optionally specifying lower-left and upper-right corners and a graphic from which to obtain its default graphics attributes.

void GetOriginal(Coord&, Coord&, Coord&, Coord&)

Return the PadGraphic's original coordinates as specified in the constructor.

PSPAD PUBLIC OPERATIONS

PSPad(PadComp* = nil)

Construct a PostScript external representation of the given subject, if any.