o ActivateExtension(char*,char*,CATBoolean)
o DeactivateExtension(char*,char*,CATBoolean)
o IsExtensionActive(char*,char*)
o QueryAllExtensions(IID&,CATListPtrCATBaseUnknown**,char*)
o ReactivateExtension(char*,char*)
Methods
o ActivateExtension
public virtual HRESULT ActivateExtension( const char* iExtensionName,
const char* iApplicationId,
CATBoolean iCreateIfNecessary =FALSE )=0
Deprecated:
V5R15 CATIOsmExtendable#AddExtension Activates the extension.Role: an extension can be activated without necessarily actually existing in the applicative container. When using CATIOsmExtendable interface, activated/deactivated state is deprecated, extensions are seen as always active, so CATIOsmExtendable#AddExtension should be called only at creation of the extension on the base feature.
Parameters:
iExtensionName
the name of the extension to be activated
iApplicationId
the applicative container containing the extension to be activated
iCreateIfNecessary
TRUE - the extension is instantiated in the applicative container if it does not already exist
FALSE - the extension is not instantiated in the applicative container even if it does not already exist
Returns:
S_OK if succeeded
S_FALSE if creation requested but not needed
o DeactivateExtension
public virtual HRESULT DeactivateExtension( const char* iExtensionName,
const char* iApplicationId,
CATBoolean iDestroyIfNecessary =FALSE)=0
Deprecated:
V5R15 CATIOsmExtendable#RemoveExtension Deactivates the extension. Role: an extension can be deactivated without necessarily actually being removed from the applicative container. When using CATIOsmExtendable interface, activated/deactivated state is deprecated, extensions are seen as always active, so this method has its equivalent RemoveExtension on CATIOsmExtendable only if it is used with iDestroyIfNecessary=TRUE, else it is useless.
Parameters:
extensionName
the name of the extension to be deactivated
iApplicationId
the name of the applicative container containing the extension to be deactivated
iDestroyIfNecessary
TRUE = if the extension exists, it is removed
FALSE = even if the extension exists, it is not removed
o IsExtensionActive
public virtual HRESULT IsExtensionActive( const char* iExtensionName,
const char* iApplicationId =NULL )=0
Deprecated:
V5R15 NoReplacement Tests if the extension is active, not active or does not exist at all. When using CATIOsmExtendable interface, activated/deactivated state is deprecated, extensions are seen as always active, so this method has no equivalent on CATIOsmExtendable.
Parameters:
iExtensionName
the name of the extension
iApplicationId
the name of the applicative container
Returns:
S_OK if the extension is active
S_FALSE if the extension exists but is inactive
E_FAIL if the extension does not exist at all
o QueryAllExtensions
public virtual HRESULT QueryAllExtensions( const IID& iIID,
CATListPtrCATBaseUnknown** oLst,
const char* iApplicationId =NULL )= 0
Deprecated:
V5R15 CATIOsmExtendable#QueryAllExtensions Returns all the active extensions implementing the requested interface in the requested applicative container.
Parameters:
IID
the requested interface
oLst
the list of all the active extensions implementing the requested interface in the requested applicative container, if any. The list is in activation reverse order (last activated first).
iApplicationId
the name of the applicative container. If NULL, returns all the active extensions, regardless of the applicative container.
o ReactivateExtension
public virtual HRESULT ReactivateExtension( const char* iWeakType,
const char* iApplicationId)=0
Deprecated:
V5R15 NoReplacement Reactivates the extension.Role: An extension can be activated by invoking its supertype. When using CATIOsmExtendable interface, activated/deactivated state is deprecated, extensions are seen as always active, so this method has no equivalent on CATIOsmExtendable.
Parameters:
iWeakType
the type or supertype of the extension to be activated
iApplicationId
the applicative container containing the extension to be activated
Returns:
S_OK if succeeded
--------------------------------------------------------------------------------
This object is included in the file: CATIExtendable.h
If needed, your Imakefile.mk should include the module: CATObjectSpecsModeler
--------------------------------------------------------------------------------