All Frameworks  Class Hierarchy  This Framework  Indexes   

VPMInterfaces Interface ENOVIConnectable

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


interface ENOVIConnectable

Base interface for connectable objects.

Role: Any instance of a class implementing ENOVIConnectable can be connected to any other implementation of ENOVIConnectable or to a connector object, through connection objects. Such an object is an implementation of ENOVIConnexion. Methods related to connectors are optional.

A connector is an implementation of ENOVIConnectable that also provides CreateConnector, RemoveConnector, GetConnectors, GetConnectorTimeStamp, GetConnectorObject, GetConnectorName methods.

Connector objects allows connection pointing to a sub-object of a more complex object.

See also:
ENOVIConnexion


Method Index


o CheckState(long&,CATLISTV(CATIVpmFactoryObject_var)&)
Checks connections states.
o CreateConnector(CATUnicodeString&)
Creates a connector.
o CreateConnexion(CATUnicodeString&,CATIVpmFactoryObject_var&,CATIVpmFactoryObject_var&,CATUnicodeString&,int)
Creates a connection.
o CreateDependenceConnexion(CATUnicodeString&,CATIVpmFactoryObject_var&,int)
Creates a dependence connection.
o CreateDependenceConnexions(CATUnicodeString&,CATListValCATBaseUnknown_var&,SEQUENCE_octet*&,CATListValCATIVpmFactoryObject_var&,int)
Creates many dependence connections at once.
o GetConnectorName(CATIVpmFactoryObject_var&,CATUnicodeString&)
Retrieves the connector name.
o GetConnectorObject(CATUnicodeString&,CATIVpmFactoryObject_var&)
Retrieves the connector object.
o GetConnectorTimeStamp(CATUnicodeString&,SEQUENCE_octet&)
Retrieves a connector's time stamp.
o GetConnectors(CATListOfCATUnicodeString&)
Retrieves the list of created connectors.
o GetConnexions(CATLISTV(CATIVpmFactoryObject_var)&,CATListOfCATUnicodeString&,CATUnicodeString&,CATUnicodeString&)
Retrieves connection objects.
o RemoveConnector(CATUnicodeString&)
Removes a connector.

Methods


o CheckState
public virtual CheckState( oState,
oListOfConnexionToBeSynchronized)
Checks connections states.
Role: For each connection it checks connected object states. If one of them has a state value equal to 1, the concerned connection is appended to the list of connections to be synchronized.
Parameters:
oState
This state is set to 0 if all connection and connectors are synchronized. 1 is returned if it is not the case.
oListOfConnexionToBeSynchronized
The list of connections. An empty list is returned if all connection and connectors are synchronized. Otherwise it contains the connections to be synchronized.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o CreateConnector
public virtual CreateConnector( const iConnector)
Creates a connector.
Parameters:
iConnector
The connector's name. Connectors on a given object must have distinct names.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o CreateConnexion
public virtual CreateConnexion( const iConnectionType,
oConnection,
const iOwner= NULL_var,
const iConnector= "unval",
iFiltrable=1)
Creates a connection.
Parameters:
iConnectionType
The type of connection to be created, depends upon sub-types of ENOVIConnexion you may have created.
oConnection
The reference to the newly created connection.
iOwner
Owner of the connection.
iFiltrable
A flag to indicate whether the connection can be filtered.
  • 1: created connection is filtrable, default value.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o CreateDependenceConnexion
public virtual CreateDependenceConnexion( const iConnexionType,
oConnexion,
iFiltrable=1)
Creates a dependence connection.
Role: A dependence connection is an historical connection established between an owner object and pointed objects. Dependence is implemented through pointed object times stamps. This behavior is inherited from historical connections. Dependence connections add orientation to the historical connection. The connection owner is the object that did create the dependence connection. The owner is not pointed by the connection.
Parameters:
iConnexionType
The name of the connection type to be created.
oConnexion
The newly created dependence connection.
iFiltrable
A flag to indicate whether the connection can be filtered.
  • 1: created connection is filtrable, default value.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o CreateDependenceConnexions
public virtual CreateDependenceConnexions( const iConnexionType,
const iPointedObjects,
const iTimestamps,
oConnexions,
iFiltrable=1)
Creates many dependence connections at once. Additionally, allows dependence connections to be created with specified timestamps.
Role: A dependence connection is an historical connection established between an owner object and pointed objects. Dependence is implemented through pointed object times stamps. This behavior is inherited from historical connections. Dependence connections add orientation to the historical connection. The connection owner is the object that did create the dependence connection. The owner is not pointed by the connection.
Parameters:
iConnexionType
The name of the connection type to be created.
iPointedObjects
A list of objects which will be pointed by dependence connections.
iTimestamps
An array of timestamps. This array may be NULL or it may be valuated. If it is valuated, it must be the same length as iPointedObjects. Each connection will be created using the corresponding timestamp in iTimestamps.
oConnexions
The newly created dependence connections.
iFiltrable
A flag to indicate whether the connections can be filtered.
  • 1: created connections are filtrable, default value.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o GetConnectorName
public virtual GetConnectorName( const iConnector,
oConnector)
Retrieves the connector name.
Parameters:
iConnector
The concerned connector.
oConnector
The retrieved name of the connector.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o GetConnectorObject
public virtual GetConnectorObject( const iConnector,
oConnector)
Retrieves the connector object.
Parameters:
iConnector
The name of the connector to retrieve.
oConnector
The retrieved connector object.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o GetConnectorTimeStamp
public virtual GetConnectorTimeStamp( const iConnector,
oTimeStamp)
Retrieves a connector's time stamp.
Parameters:
iConnector
The name of the connector.
oTimeStamp
The retrieved time stamp.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o GetConnectors
public virtual GetConnectors( oConnectors)
Retrieves the list of created connectors.
Parameters:
oConnectors
The list of created connectors.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o GetConnexions
public virtual GetConnexions( oConnections,
oConnectors,
const iConnectionTypeFilter= "all",
const iConnectionDirectionFilter= "all")
Retrieves connection objects.
Parameters:
oConnection
The retrieved list of connections objects.
iConnectionTypeFilter
A filter to connection types. "all", thus returning all types.
oConnectors
The retrieved list of connectors name.
iConnectionDirectionFilter
A filter to connections directions.
Legal values:
  • all: get all connections, default value.
  • pointed: get connections pointed by this.
  • pointing: get connection pointing to this.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.
o RemoveConnector
public virtual RemoveConnector( const iConnector)
Removes a connector.
Parameters:
iConnector
The name of the connector to remove.
Returns:
S_OK The method succeeds.
Returns:
E_FAIL The method fails.

This object is included in the file: ENOVIConnectable.h
If needed, your Imakefile.mk should include the module: GUIDVPMInterfaces

Copyright © 2003, Dassault Systèmes. All rights reserved.