![](../../Home/Icons/Home.gif)
![](../icons/UpCNM.gif)
![](../icons/CNMContext.gif)
![](../../Home/Icons/Search.gif)
Taxonomy Categories:
Member Functions:
Interface Category:
API.
Inherits From:
TCommandOn
Inherited By:
TRotateCanvasGraphicCmd
TScaleCanvasGraphicCmd
TSetCanvasGraphicFillColorCmd
TSetCanvasGraphicFrameColorCmd
TSetCanvasGraphicLineWidthCmd
TTransformCanvasGraphicCmd
TTranslateCanvasGraphicCmd
Purpose:
An abstract base class for any command that changes canvas graphics in the target selection.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
Abstract base class; must be derived.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
Other Considerations:
None.
- TChangeCanvasGraphicCmd ()
- TChangeCanvasGraphicCmd (const TChangeCanvasGraphicCmd &)
Interface Category:
API.
Purpose:
- Default constructor.
- Copy constructor.
Calling Context:
- Called by the stream-in operators and constructors of derived classes.
- Called to copy an object.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual ~ TChangeCanvasGraphicCmd ()
Interface Category:
API.
Purpose:
Destructor.
Calling Context:
Called to destroy an object.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual TStream & operator >>=(TStream &) const
Interface Category:
API.
Purpose:
Stream-out operator.
Calling Context:
Called to stream out data.
Parameters:
- TStream & -The stream the object is streamed out to.
Return Value:
Returns a reference to the stream the object streams itself out to.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual TStream & operator <<= (TStream &)
Interface Category:
API.
Purpose:
Stream-in operator.
Calling Context:
Called to stream in data.
Parameters:
- TStream & -The stream the object is streamed in from.
Return Value:
Returns a reference to the stream the object streams itself in from.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
TChangeCanvasGraphicCmd & operator =(const TChangeCanvasGraphicCmd &)
Interface Category:
API.
Purpose:
Assignment operator.
Calling Context:
Called when an object is assigned to another compatible object.
Parameters:
Return Value:
A non-const reference to the left-hand side object.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual void BeginChange (MCanvasRepresentation &, MCanvasGraphic &)
Interface Category:
API.
Purpose:
Changes a specified canvas graphic and saves undo information to later restore the graphic in UndoChange.
Calling Context:
Called by TChangeCanvasGraphicCmd::HandleDoBegin.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
A pure virtual member function that must be overridden. The derived class implementation should save undo information from the graphic and then change the graphic as per the design of the command class.
virtual void ContinueChange (MCanvasRepresentation &, MCanvasGraphic &)
Interface Category:
API.
Purpose:
Changes a specified canvas graphic.
Calling Context:
Called by TChangeCanvasGraphicCmd::HandleDoIncrement.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
A pure virtual member function that must be overridden. The derived class implementation should change the graphic as per the design of the command class.
virtual void UndoChange (MCanvasRepresentation &, MCanvasGraphic &)
Interface Category:
API.
Purpose:
Undoes prior changes to a specified canvas graphic and saves redo information to later restore the graphic in RedoChange.
Calling Context:
Called for each canvas graphic in the target selection by TChangeCanvasGraphicCmd::HandleUndo.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
A pure virtual member function that must be overridden. The derived class implementation should undo the change on the graphic as per the design of the command class. TCanvasGraphicAssociationsWith can be used to store undo and redo information.
virtual void RedoChange (MCanvasRepresentation &, MCanvasGraphic &)
Interface Category:
API.
Purpose:
Redoes changes to a specified canvas graphic and saves undo information to later restore the graphic in UndoChange.
Calling Context:
Called for each canvas graphic in the target selection by TChangeCanvasGraphicCmd::HandleRedo.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
A pure virtual member function that must be overridden. The derived class implementation should redo change the graphic as per the design of the command class. TCanvasGraphicAssociationsWith can be used to store undo and redo information.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.