All Frameworks Class Hierarchy This Framework Indexes
ObjectModelerNavigator Interface CATIGraphNode
Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.
interface CATIGraphNode
Interface to customize graph's nodes physical representation.
Role: This interface is automatically implemented on tree nodes.
If you use the CATIGraphNode methods in the CATINavigModify.UpdateElem method, the update of the node is automatically done, otherwise call the
CATINavigElement.Update method to refresh the visualization.
A node is a text with or without:
Method Index
- o
AddMask(CATUnicodeString&,int,int,int)
- Adds a mask on an icon.
- o
GetContextualMenu()
- Retrieves node contextual menu.
- o
GetFillStyle()
- Retrieves node background mode.
- o
GetIndexedChildLink(int)
- Returns a child link by its index.
- o
GetIndexedFatherLink(int)
- Returns a father link by its index.
- o
GetNbChildLinks()
- Returns number of child links.
- o
GetNbFatherLinks()
- Returns number of father links.
- o
GetPixelImage()
- Returns the pixel image associated with the node.
- o
GetUnderlineMode()
- Retrieves node underline mode.
- o
IsDecorated()
- Retrieves node frame mode.
- o
IsExpanded()
- Retrieves node expand mode.
- o
IsHighlighted()
- Retrieves node highlight mode.
- o
IsShadowOut()
- Retrieves node frame shadow mode.
- o
RemoveAllMasks()
- Removes all masks of an icon.
- o
RemoveLastMask()
- Removes last mask of an icon.
- o
SetColor(int)
- Sets node color.
- o
SetDecoration(int)
- Sets node frame mode.
- o
SetFillStyle(int)
- Sets node background mode.
- o
SetHighlight(int)
- Sets node highlight mode.
- o
SetPixelImage(CATUnicodeString&)
- Sets icon on the node.
- o
SetShadowOut(int)
- Sets node frame shadow mode.
- o
SetText(CATListValCATUnicodeString&)
- Sets node text.
- o
SetUnderlineMode(int)
- Sets node underline mode.
- o
UpdateState(CATNavigNodeState)
- Sets node expand mode.
Methods
o AddMask
| public virtual AddMask( | const | iFile, |
| | XVal, |
| | YVal, |
| | TransVal | =0) |
-
Adds a mask on an icon.
- Parameters:
-
- iFile
- path of the mask to add
- XVal
- coordinate of mask ( usually 0 )
- YVal
- coordinate of mask ( usually 0 )
- TransVal
- Flag to activate the transparency of the mask.
- if TransVal=0, the mask is completely opaque.
- if TransVal=1, the mask is transparent for all pixels which have the same color than this one on the top left.
o GetContextualMenu
| public virtual GetContextualMenu( | ) |
-
Retrieves node contextual menu.
Role:This method is useful to modify the default contextual menu associated
with a node. In the
CATINavigElement.ProcessAfterMethod you can call this method and add items to the returned menu.
- Returns:
- The node contextual menu.
o GetFillStyle
| public virtual GetFillStyle( | ) |
-
Retrieves node background mode.
- Returns:
- The background mode.
Legal values: 1: The background is filled,
0: otherwise.
o GetIndexedChildLink
| public virtual GetIndexedChildLink( | | index) |
-
Returns a child link by its index.
- Parameters:
-
- iIndex
- The index of the link
Returned pointer must be released.
o GetIndexedFatherLink
| public virtual GetIndexedFatherLink( | | iIndex) |
-
Returns a father link by its index.
- Parameters:
-
- iIndex
- The index of the link
Returned pointer must be released.
o GetNbChildLinks
| public virtual GetNbChildLinks( | ) |
-
Returns number of child links.
o GetNbFatherLinks
| public virtual GetNbFatherLinks( | ) |
-
Returns number of father links.
o GetPixelImage
| public virtual GetPixelImage( | ) |
-
Returns the pixel image associated with the node.
o GetUnderlineMode
| public virtual GetUnderlineMode( | ) |
-
Retrieves node underline mode.
- Returns:
- The node underline mode.
Legal values: 1: The text is underlined
0: otherwise
o IsDecorated
| public virtual IsDecorated( | ) |
-
Retrieves node frame mode.
- Returns:
- The node frame mode.
Legal values: 1: The node has a frame,
0: otherwise.
o IsExpanded
| public virtual IsExpanded( | ) |
-
Retrieves node expand mode.
- Returns:
- The expand node mode.
Legal values: 1: The node is expanded
0: The node is collapsed
o IsHighlighted
| public virtual IsHighlighted( | ) |
-
Retrieves node highlight mode.
- Returns:
- The highlight mode.
Legal values: 1: The node is highlighted,
0: otherwise.
o IsShadowOut
| public virtual IsShadowOut( | ) |
-
Retrieves node frame shadow mode.
- Returns:
- The frame shadow mode.
Legal values: 1: The icon has a shadow,
0: otherwise.
o RemoveAllMasks
| public virtual RemoveAllMasks( | ) |
-
Removes all masks of an icon.
o RemoveLastMask
| public virtual RemoveLastMask( | ) |
-
Removes last mask of an icon.
- Returns:
- 0 if succeeded
-1 otherwise.
o SetColor
| public virtual SetColor( | | iCouleur) |
-
Sets node color.
Role:This method enables you to modify the background color of the text.
The text color being automatically computed to have enought contrast.
This color is useless if the node is without background, i.e. the
GetFillStyle method returns 0.
- Parameters:
-
- iCouleur
- The index of the color.
Legal values:iCouleur ranges from 0 to 255.
You can use the CATColorMap#GetColor method to retrieve the
r,g and b components associated with an index color.
o SetDecoration
| public virtual SetDecoration( | | iMode) |
-
Sets node frame mode.
Role:This method enables you to set or not a frame around the text of
the node.
- Parameters:
-
- iMode
- The node frame mode.
Legal values: 1: The node has a frame,
0: otherwise.
o SetFillStyle
| public virtual SetFillStyle( | | iFill) |
-
Sets node background mode.
Role:This method enables you to set or not a background behind the text.
The color of the background being defined by the
SetColor method.
- Parameters:
-
- iFill
- The background mode
Legal values: 1: The background is filled,
0: otherwise.
o SetHighlight
| public virtual SetHighlight( | | iMode) |
-
Sets node highlight mode.
- Parameters:
-
- iMode
- The highlight mode.
Legal values: 1: The node has to be highlighted,
0: otherwise.
o SetPixelImage
| public virtual SetPixelImage( | const | iChaine) |
-
Sets icon on the node.
- Parameters:
-
- iChaine
- The name of the icon.
o SetShadowOut
| public virtual SetShadowOut( | | iMode) |
-
Sets node frame shadow mode.
Role:This method enables you to set or not a shadow on the frame. The value
of this mode is useless if the node is without frame, i.e. the
IsDecorated method returns 0.
- Parameters:
-
- iMode
- The frame shadow mode.
Legal values: 1: The frame has a shadow,
0: otherwise.
o SetText
| public virtual SetText( | const | iText) |
-
Sets node text.
Role:This method enables you to modify the text associated
with the node. The default text being the text returned by the
CATINavigateObject.GetIdentificators method.
However, modify the
text should be used temporary, because the Search mechanism is based on
the text returned by the
CATINavigateObject.GetIdentificators method.
- Parameters:
-
- iText
- The text associated to node. There are as many strings as lines.
o SetUnderlineMode
| public virtual SetUnderlineMode( | | iMode) |
-
Sets node underline mode.
- Parameters:
-
- iMode
- The node underline mode.
Legal values: 1: The text is underlined
0: otherwise
o UpdateState
| public virtual UpdateState( | | iState) |
-
Sets node expand mode.
- Parameters:
-
- iState
- The node state.
This object is included in the file: CATIGraphNode.h
If needed, your Imakefile.mk should include the module: CATObjectModelerNavigator