![](../../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:
None.
Purpose:
Adopts a new link into an anchor in a model. The link must be a link out of an anchor on the target model. This command supports undo and redo of the operation.
The GetLink member functions support access to the link to be adopted.
Instantiation:
Allocate on the heap or the stack.
Deriving Classes:
No special requirements.
Concurrency:
Not multithread safe.
Resource Use:
No special requirements.
Invariants:
Interface Category:
API.
Purpose:
- Constructs a command with a link to adopt into a model anchor.
- Copy constructor.
- Default constructor.
Calling Context:
- Called to create new command.
- Called to copy command.
- Called by the stream-in operators and derived classes.
Parameters:
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
Postconditions:
Interface Category:
API.
Purpose:
Assignment operator.
Calling Context:
Called when an object is assigned to another compatible object.
Parameters:
Return Value:
Returns a const reference to the left-hand side object.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual ~ TAdoptLinkCommand ()
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 TModelLink * GetLink ()
Interface Category:
API.
Purpose:
Provides access to the link to be adopted into the model.
Calling Context:
No special requirements.
Parameters:
Return Value:
Returns the link to be adopted to be adopted into the model.
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 to which the object streams itself out.
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 from which the object streams itself in.
Return Value:
Returns a reference to the stream the object streams itself in from.
Exceptions:
Throws a TInvalidVersionError if the version of the object on the stream is unknown to the version of the shared library installed.
Concurrency:
Not multithread safe.
Other Considerations:
None.
virtual void HandleDoBegin (TModelSelection &)
Interface Category:
API.
Purpose:
Does the command. The link is adopted into the target anchor in the target model.
Calling Context:
Called only by TCommand.
Parameters:
- TModelSelection & -The selection on model into which the link will be adopted.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
This function is protected.
virtual void HandleUndo (TModelSelection &)
Interface Category:
API.
Purpose:
Orphans out the previously adopted link of the model.
Calling Context:
Called only by TCommandOn.
Parameters:
- TModelSelection & -The selection on the model from which the link will be orphaned.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
This function is protected.
virtual void HandleRedo (TModelSelection &)
Interface Category:
API.
Purpose:
Redoes the command: Same as HandleDo.
Calling Context:
Called only by TCommandOn.
Parameters:
- TModelSelection & -The selection on the model into which the link will be adopted.
Return Value:
None.
Exceptions:
Throws no exceptions, passes all exceptions through.
Concurrency:
Not multithread safe.
Other Considerations:
This function is protected.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.