SYNOPSIS

#include <Unidraw/Components/slot.h>

DESCRIPTION

SlotComp is a Connector subclass that supports connectivity with one degree of freedom. It serves as an abstract base class from which to derive HSlotComp and VSlotComp, which support horizontal and vertical orientations. The slot component classes use SlotGraphics to store their graphical attributes. SlotView is an abstract subclass of ConnectorView for displaying slots. HSlotView and VSlotView are SlotViews that display slots with the corresponding orientations. Finally, PSSlot is a PostScriptView that externalizes the slot subject's information in PostScript form.

SLOTCOMP PUBLIC OPERATIONS

virtual void Interpret(Command*)

virtual void Uninterpret(Command*)

SlotComp (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)

SlotComp redefines these functions to return and assign its _mobility protected member. Slots have fixed mobility initially.

Slot* GetSlot()

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

SLOTCOMP PROTECTED OPERATIONS

SlotComp(SlotGraphic* = nil)

The constructor takes an optional SlotGraphic that defines the slot's graphical attributes. It is protected to prevent instantiation, since SlotComp is an abstract class.

void SetOrientation(SlotGraphic*, Orientation)

Define the orientation of the SlotComp's SlotGraphic. Only SlotComp can specify this SlotGraphic attribute; HSlotComp and VSlotComp subclasses set it to reflect their respective orientations.

SLOTVIEW PUBLIC OPERATIONS

virtual void Interpret(Command*)

SlotView interprets AlignToGridCmd to align its starting point to the grid.

virtual Manipulator* CreateManipulator(

Viewer*, Event&, Transformer*, Tool*

)

virtual void InterpretManipulator(Manipulator*)

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

SlotComp* GetSlotComp()

Return the subject.

SLOTVIEW PROTECTED OPERATIONS

SlotView(SlotComp* = nil)

Create an SlotView, optionally supplying the subject. The constructor is protected to prevent instantiation.

SlotGraphic* GetSlot()

Return the SlotGraphic that defines the slot's attributes. GetSlot is simply a more specific form of the GetGraphic operation.

virtual SlotComp* NewSubject(SlotGraphic*)

A helper function that creates a SlotComp subject with the given slot graphic. This function produces the proper subject when the GraphicCompTool's manipulator is interpreted. HSlotView and VSlotView redefine this operation to return the corresponding SlotComp subclasses, 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.

SLOTGRAPHIC PUBLIC OPERATIONS

SlotGraphic(Coord, Coord, Coord, Graphic* = nil)

Create a SlotGraphic, specifying the starting point, length, and optionally a graphic from which to obtain its default graphics attributes.

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

Return the SlotGraphic's original geometry parameters as specified in the constructor.

PSSLOT PUBLIC OPERATIONS

PSSlot(SlotComp* = nil)

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