SoWWWAnchor — separator group node with a URL hyperlink
Contents
Action Behavior
SoHandleEventAction
When the left mouse is clicked over a child of this anchor node, the application is called back to
fetch the URL (see setFetchURLCallBack()).
Description
This node defines a separator group which has a URL (Universal Resource Locator) hyperlink. When clicked
on, this node invokes an application callback to fetch the URL. The application may fetch the data
itself, or call a World Wide Web browser like the HTML based NetscapeNavigator or the VRML based
WebSpaceNavigator to load the URL.
Fields
SoSFStringname
URL which the application will be called back to fetch when this node is activated by a left mouse
click (e.g. "http://www.sgi.com/Technology/Inventor").
SoSFStringdescription
A description of the URL which may make more sense to users than the URL itself (e.g. "The Open
Inventor Home Page").
SoSFEnummap
Specifies what additional information should be added to the end of the URL when passed back to the
application for fetching. If set to POINT, then the x,y,z location of the object space intersection
point when the mouse was clicked will be suffixed to the URL. Since the comma character does not
transmit through some web browsers, it is written in hex form (e.g. if the intersection point is
17,4.5,1 the URL passed to the application callback would be
"http://www.sgi.com/Technology/Inventor?17%2c4.5%2c1").
File Format/Defaults
WWWAnchor{renderCachingAUTOboundingBoxCachingAUTOrenderCullingAUTOpickCullingAUTOmodeAUTOstyleEMISSIVEcolor0.30.30.3name"<UndefinedURL>"description""mapNONE}Inherits From
SoBase > SoFieldContainer > SoNode > SoGroup > SoSeparator > SoLocateHighlight > SoWWWAnchor
Methods
SoWWWAnchor()
Creates an anchor node with default settings.
staticSoTypegetClassTypeId()
Returns type identifier for this class.
voidsetFullURLName(constSbString&url)constSbString&getFullURLName()
If the name field contains a relative URL (e.g. "foo.wrl" instead of "http://bogus.com/foo.wrl"), the
anchor cannot resolve the URL reference. This method allows the application to tell the anchor what
it's full URL should be. getFullURLName() returns the fullURL set here, or if not set, returns the
contents of the name field.
staticvoidsetFetchURLCallBack(SoWWWAnchorCB*f,void*userData)
Application callbacks invoked when the mouse is clicked on an anchor so that the application can fetch
the URL or call Netscape or WebSpace to fetch the URL.
staticvoidsetHighlightURLCallBack(SoWWWAnchorCB*f,void*userData)
Application callbacks invoked when the mouse is moved over an anchor so that the app can provide
feedback such as changing the cursor, or displaying the anchor description and name.
Name
SoWWWAnchor — separator group node with a URL hyperlink
See Also
SoWWWInlineSoWWWAnchor(3IV)()
Synopsis
#include<Inventor/nodes/SoWWWAnchor.h>typedefvoidSoWWWAnchorCB(constSbString&url,void*userData,SoWWWAnchor*node)enumMapping{SoWWWAnchor::NONE Do not add information to the URL
SoWWWAnchor::POINT Add object-space coordinates to URL
}
Fields from class SoWWWAnchor:
SoSFStringnameSoSFStringdescriptionSoSFEnummap
Fields from class SoLocateHighlight:
SoSFColorcolorSoSFEnumstyleSoSFEnummode
Fields from class SoSeparator:
SoSFEnumrenderCachingSoSFEnumboundingBoxCachingSoSFEnumrenderCullingSoSFEnumpickCulling
Methods from class SoWWWAnchor:
SoWWWAnchor()staticSoTypegetClassTypeId()voidsetFullURLName(constSbString&url)constSbString&getFullURLName()staticvoidsetFetchURLCallBack(SoWWWAnchorCB*f,void*userData)staticvoidsetHighlightURLCallBack(SoWWWAnchorCB*f,void*userData)
Methods from class SoSeparator:
staticvoidsetNumRenderCaches(inthowMany)staticintgetNumRenderCaches()
Methods from class SoGroup:
voidaddChild(SoNode*child)voidinsertChild(SoNode*child,intnewChildIndex)SoNode*getChild(intindex)constintfindChild(constSoNode*child)constintgetNumChildren()constvoidremoveChild(intindex)voidremoveChild(SoNode*child)voidremoveAllChildren()voidreplaceChild(intindex,SoNode*newChild)voidreplaceChild(SoNode*oldChild,SoNode*newChild)
Methods from class SoNode:
voidsetOverride(SbBoolstate)SbBoolisOverride()constSoNode*copy(SbBoolcopyConnections=FALSE)constvirtualSbBoolaffectsState()conststaticSoNode*getByName(constSbName&name)staticintgetByName(constSbName&name,SoNodeList&list)
Methods from class SoFieldContainer:
voidsetToDefaults()SbBoolhasDefaultValues()constSbBoolfieldsAreEqual(constSoFieldContainer*fc)constvoidcopyFieldValues(constSoFieldContainer*fc,SbBoolcopyConnections=FALSE)SbBoolset(constchar*fieldDataString)voidget(SbString&fieldDataString)virtualintgetFields(SoFieldList&resultList)constvirtualSoField*getField(constSbName&fieldName)constSbBoolgetFieldName(constSoField*field,SbName&fieldName)constSbBoolisNotifyEnabled()constSbBoolenableNotify(SbBoolflag)
Methods from class SoBase:
voidref()voidunref()constvoidunrefNoDelete()constvoidtouch()virtualSoTypegetTypeId()constSbBoolisOfType(SoTypetype)constvirtualvoidsetName(constSbName&name)virtualSbNamegetName()const