SoSearchAction

enum LookFor {

SoSearchAction::NODE Search for a particular node (by pointer)

SoSearchAction::TYPE Search for a particular type of node

SoSearchAction::NAME Search for a node with a particular name

}

enum Interest {

SoSearchAction::FIRST Return only the first path found

SoSearchAction::LAST Return only the last path found

SoSearchAction::ALL Return all paths found

}

Methods from class SoSearchAction:

SoSearchAction()

void setNode(SoNode *n)

SoNode * getNode() const

void setType(SoType t, SbBool derivedIsOk = TRUE)

SoType getType(SbBool &derivedIsOk) const

void setName(const SbName &n)

const SbName & getName() const

void setFind(int what)

int getFind()

void setInterest(Interest interest)

Interest getInterest() const

void setSearchingAll(SbBool flag)

SbBool isSearchingAll() const

SoPath * getPath() const

SoPathList & getPaths()

void reset()

Methods from class SoAction:

virtual void apply(SoNode *node)

virtual void apply(SoPath *path)

virtual void apply(const SoPathList &pathList, SbBool obeysRules = FALSE)

static SoType getClassTypeId()

virtual SoType getTypeId()

virtual SbBool isOfType(SoType type)

virtual void invalidateState()

This class is used to search scene graphs for specific nodes, nodes of a specific type, nodes with a specific name, or any combination of these. It can search for just the first or last node satisfying the criteria or for all such nodes. The actions return paths to each node found.

Note that by default nodekits do not search their children when a search action is applied. The man page for SoBaseKit discusses the methods SoBaseKit::isSearchingChildren() and SoBaseKit::setSearchingChildren(), which allow you to query and control this behavior.

int getFind()

Sets/returns what to look for; what is a bitmask of LookFor enum values. Default is no flags at all. Note that setting a node, type, and/or name to search for activates the relevant flag, so you may never need to call this method directly.

SbBool isSearchingAll() const

Sets/returns whether searching uses regular traversal or whether it traverses every single node. For example, if this flag is FALSE, an SoSwitch node will traverse only the child or children it would normally traverse for an action. If the flag is TRUE, the switch would always traverse all of its children. The default is FALSE.