ObjectModelerNavigator Interface CATINavigModify

• SystemTS.IUnknown
• System.IDispatch
• System.CATBaseUnknown
• CATINavigModify

Usage: you can reimplement this interface by deriving the supplied CATNodeExtension adapter class.

interface CATINavigModify

Interface to customize tree node visualization.

Role:This interface enables you to customize the visual aspect of nodes associated with your object. If to be visualized in object tree, an object must implement the CATINavigateObject interface, this interface implementation is not mandatory. Nodes associated with an object have a default implementation of this interface, such as the CATINavigElement and CATIGraphNode interfaces.

This implementation, full or partial, is not done on the object itself but on an object, named MyObject_node, where MyObject is the name of the object.

To implement UpdateElem or ModifyShortHelp , it can be useful to retrieve a pointer to the object implementing CATINavigateObject. From a node, there are two steps:

1. Call CATINavigElement.GetAssociatedInstance , to retrieve a CATNavigInstance pointer (It is already the UpdateElem input)
2. Then, call CATNavigInstance.GetReference to retrieve a pointer on the object associated with the node.

BOA information: this interface CANNOT be implemented using the BOA (Basic Object Adapter). To know more about the BOA, refer to the CAA Encyclopedia home page. Click Middleware at the bottom left, then click the Object Modeler tab page. Several articles deal with the BOA.

Method Index

o IsSelected()

Defines whether the node has ever been selected.

o ModifyShortHelp(CATUnicodeString&)

Defines the node short help.

o Select(int)

Defines whether the node is selectable or not.

o UpdateElem(CATNavigInstance*)

Defines node graphic representation.

Methods

Defines whether the node has ever been selected.

Returns:

The selecting state.
Legal values:

• 0: The node is not selected
• Otherwise : selected

Defines the node short help.
Role: When you pass over a node a short help is displayed. The short help text is the text associated with the node. This text is either the name returned by the CATINavigateObject.GetIdentificators method, or if defined, the text set thanks to the CATIGraphNode.SetText method.
This method enables you to modify this default behavior defined by CATNodeExtension.ModifyShortHelp. You have three possibilities:

• do not overwrite this method: you have the default behavior: short help + text associated with the node,
.
• Overwrite it and return E_FAIL: no short help will be displayed,
• Overwrite it and return S_OK: ioText will be the displayed text.

Parameters:

ioText

The short help of the node.
In input ioText is the text associated with the node.

Returns:

The displaying state.
Legal values:

• E_FAIL: no short help will be displayed
• S_OK : ioText will be displayed

Defines whether the node is selectable or not.
Note: This method enables you to control the node selection. The default behavior brings the node selectionnable.

Parameters:

iMode

The selectable mode.

Defines node graphic representation.
Role:This method enables you to modify the default visual aspect of a node. By using the CATIGraphNode interface you can:

• Modify the text ( CATIGraphNode.SetText ): the default one is those returned by CATINavigateObject.GetIdentificators ,
• Modify the box color ( CATIGraphNode.SetColor ): the default color is blue ,
• Add an icon ( CATIGraphNode.SetPixelImage ) ,
• ...

The CATIGraphNode interface is natively implemented on your node. You use it in the UpdateElem implementation such as:

      CATIGraphNode *pIGraphNode = NULL ;
      HRESULT rc = QueryInterface(IID_CATIGraphNode,
                        (void**)&pIGraphNode);
      if ( SUCCEEDED(rc) )
      {
          pIGraphNode->SetXXX(..);
      }
 

Parameters:

iInst

The navig instance associated with the node.
This parameter enables you to retrieve the component associated with the node and then to get specific information from the component.

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