CATMecModUseItf Interface CATIMmiInternalCopyWithLinkEdition

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.

interface CATIMmiInternalCopyWithLinkEdition

Interface used to change the reference of an internal copy with link.
Role: This interface is used to change the reference of objects created either by copy/paste as result with link inside a part or by using with the following options :

• the source and target must be in the same part.
• the link mode must be set either by the setting "keep link" or by the method (mode TRUE).

Internal copies made without a link do not answer to this interface.

The source of the copy is called the reference feature of the internal copy.

The reference of an internal copy with link can only be changed on solid internal copies for now.

This interface has two main usages :

1. Identifying internal copies with link from other features.
2. Changing the reference feature.

Sub elements of the geometry of an internal copy may be referenced by other features. When the reference of an internal copy is changed, its geometry also changes.

The features that referenced sub elements of the old copied geometry need to be replugged on sub elements of the new copied geometry via a replace operation.

In order to do this, user intervention is needed to specify on which new sub elements the features need to be rerouted. This has to be done interactively through the Replace Viewer.

see to retrieve the reference feature.

The main behaviours of an internal copy with link are the following :

• Updating the internal copy : it performs a synchronization of the geometry by copying the geometry of the reference feature.
• Breaking the link with . After this operation, the feature will no more answer to this interface because the link is deleted.
• Temporary isolation with (reversed with . After this operation, the feature still answers to this interface.

Method Index

o SetSelectedElement(CATIMmiMechanicalFeature_var&,CATBoolean)

Sets the reference of the copy.

Methods

Sets the reference of the copy.

Parameters:

ihReferenceFeature

The reference of the copy.

iAuthorizeManualReplugging

Indicates whether the Replace Viewer should be launched when manual reroute is necessary in order to fully complete the Replace operation.
Possible values:

• TRUE means the Replace Viewer is launched if user intervention is needed to complete the Replace operation.
• FALSE means the Replace Viewer is never launched even if user intervention is needed to complete the Replace operation.
  In this case, if user intervention is needed, the Replace operation will lead to update errors, but will be considered as a success.

Returns:

S_OK the operation went through successfully according to the iAuthorizeManualReplugging argument.
This garantees that the internal copy has changed reference, but does not garantee that the features that take the internal copy as import will not have update errors.
Update errors can occur if manual reroute was necessary but either no Replace Viewer was wanted or Replace Viewer was wanted, but manually reroute was not performed correctly by the user.
E_FAIL if the operation failed or if the internal copy with link is frozen.
It is not possible to change the reference of a frozen internal copy with link. The internal copy must be unfrozen before this method can be called.
E_NOTIMPLEMENTED if the internal copy is not a solid feature.

Copyright © 1999-2014, Dassault Systèmes. All rights reserved.