uiTreeItem Class Reference

are helping classes for uiTreeViews, wich makes it easy to bundle inteligence and data to treeitems. Usage is normally to create the uiTreeTopItem, run its init() and add Childrens. More...

Inheritance diagram for uiTreeItem:

Protected Member Functions
virtual int	uiTreeViewItemType () const
virtual uiParent *	getUiParent () const
virtual bool	addChld (uiTreeItem *, bool below, bool downwards)
virtual const char *	parentType () const =0
virtual bool	useParentType () const
virtual bool	init ()
virtual bool	rightClick (uiTreeViewItem *)
virtual bool	anyButtonClick (uiTreeViewItem *)
virtual bool	doubleClick (uiTreeViewItem *)
virtual void	setTreeViewItem (uiTreeViewItem *)
virtual void	removeItem (uiTreeViewItem *)
virtual void	renameItem (uiTreeViewItem *)
virtual bool	showSubMenu ()
virtual bool	selectWithKey (int selkey)
virtual bool	isSelectable () const
virtual bool	isExpandable () const
virtual void	updateSelection (int selectionKey, bool dw=false)
virtual bool	shouldSelect (int selectionkey) const
Protected Member Functions inherited from CallBacker
void	detachAllNotifiers () const
	Call from the destructor of your inherited object. More...

Protected Attributes
IOPar	properties_
uiTreeItem *	parent_
uiString	name_
uiTreeViewItem *	uitreeviewitem_
ObjectSet< uiTreeItem >	children_

Private Member Functions
virtual mODTextTranslationClass(uiTreeItem) public	~uiTreeItem ()
virtual void	prepareForShutdown ()
virtual bool	askContinueAndSaveIfNeeded (bool withcancel)
void	setName (const uiString &nm)
uiString	name () const
bool	areAllParentsChecked ()
void	entryInEditMode (int col)
virtual int	selectionKey () const
virtual bool	select ()
virtual bool	isSelected () const
void	setChecked (bool yn, bool trigger=false)
virtual bool	isChecked () const
NotifierAccess *	checkStatusChange ()
NotifierAccess *	keyPressed ()
void	expand ()
bool	isExpanded () const
void	collapse ()
bool	isCollapsed () const
bool	allChildrenExpanded () const
bool	allChildrenCollapsed () const
bool	allChildrenChecked () const
bool	allChildrenUnchecked () const
virtual int	siblingIndex () const
virtual uiTreeItem *	siblingAbove ()
virtual uiTreeItem *	siblingBelow ()
virtual void	moveItem (uiTreeItem *after)
virtual void	moveItemToTop ()
uiTreeItem *	lastChild ()
int	nrChildren () const
const uiTreeItem *	getChild (int) const
uiTreeItem *	getChild (int)
ObjectSet< uiTreeItem > &	getChildren ()
const ObjectSet< uiTreeItem > &	getChildren () const
virtual bool	addChild (uiTreeItem *child, bool below)
virtual void	removeChild (uiTreeItem *)
virtual void	removeAllChildren ()
virtual const uiTreeItem *	findChild (const char *name) const
virtual const uiTreeItem *	findChild (int selkey) const
virtual uiTreeItem *	findChild (const char *name)
virtual uiTreeItem *	findChild (int selkey)
virtual void	findChildren (const char *, ObjectSet< uiTreeItem > &)
template<class T >
void	setProperty (const char *key, const T &)
void	setPropertyPtr (const char *key, void *)
template<class T >
bool	getProperty (const char *key, T &res) const
bool	getPropertyPtr (const char *key, void *&) const
void	updateSelTreeColumnText (int col)
virtual void	updateColumnText (int col)
virtual void	updateCheckStatus ()
virtual void	translateText ()
uiTreeViewItem *	getItem ()
const uiTreeViewItem *	getItem () const
void	setPixmap (int col, const ColTab::Sequence *)
bool	addChildImpl (CallBacker *, uiTreeItem *, bool, bool)

Friends
class	uiTreeTopItem
class	uiODTreeTop

Additional Inherited Members
Public Member Functions inherited from CallBacker
	CallBacker ()
	CallBacker (const CallBacker &)
virtual	~CallBacker ()
bool	attachCB (const NotifierAccess &, const CallBack &, bool onlyifnew=false) const
bool	attachCB (const NotifierAccess *notif, const CallBack &cb, bool onlyifnew=false) const
void	detachCB (const NotifierAccess &, const CallBack &) const
void	detachCB (const NotifierAccess *notif, const CallBack &cb) const
bool	isNotifierAttached (const NotifierAccess *) const
	Only for debugging purposes, don't use. More...
virtual bool	isCapsule () const
void	stopReceivingNotifications () const
Static Public Member Functions inherited from CallBacker
static void	createReceiverForCurrentThread ()
static void	removeReceiverForCurrentThread ()

Detailed Description

are helping classes for uiTreeViews, wich makes it easy to bundle inteligence and data to treeitems. Usage is normally to create the uiTreeTopItem, run its init() and add Childrens.

Constructor & Destructor Documentation

virtual mODTextTranslationClass (uiTreeItem) public uiTreeItem::~uiTreeItem ( )

privatevirtual

Member Function Documentation

virtual bool uiTreeItem::addChild ( uiTreeItem *  child, bool  below  )

privatevirtual

Adds a child. If the child does not fit (i.e. the child's parentType() is not the same as this), it will try to find a valid parent somewhere else in the tree.

Parameters

below

specifies wether the child shoule be added above or below eventual existing siblings.

Note

child becomes mine regardless of return value.

Reimplemented in uiTreeTopItem.

bool uiTreeItem::addChildImpl ( CallBacker *  , uiTreeItem *  , bool  , bool    )

private

virtual bool uiTreeItem::addChld ( uiTreeItem *  , bool  below, bool  downwards  )

protectedvirtual

Adds a child to this item. If the child does not fit (i.e. its parentType() is not equal to this), the object tries to add it to its parent if downwards is false. If downwards is true, it tries to add it to its children if it does not fit.

Parameters

below

specifies wether the child should be added above or below eventual existing siblings.

Reimplemented in uiTreeTopItem, uiODHorizon2DParentTreeItem, and uiODHorizonParentTreeItem.

bool uiTreeItem::allChildrenChecked ( ) const

private

bool uiTreeItem::allChildrenCollapsed ( ) const

private

bool uiTreeItem::allChildrenExpanded ( ) const

private

bool uiTreeItem::allChildrenUnchecked ( ) const

private

virtual bool uiTreeItem::anyButtonClick ( uiTreeViewItem *  )

protectedvirtual

Reimplemented in uiODZsliceParentTreeItem, uiODCrosslineParentTreeItem, uiODHorizon2DParentTreeItem, uiODFaultStickSetParentTreeItem, uiODInlineParentTreeItem, uiODPolygonParentTreeItem, uiODPSEventsTreeItem, uiODAnnotTreeItem, uiODAttribTreeItem, VolProc::uiDataTreeItem, uiODFaultParentTreeItem, uiODHorizonParentTreeItem, uiODWellParentTreeItem, uiODBodyDisplayParentTreeItem, uiODRandomLineParentTreeItem, uiODLine2DParentTreeItem, uiODTreeItem, uiODPickSetParentTreeItem, uiODSceneParentTreeItem, uiODSceneTreeItem, and uiODVolrenParentTreeItem.

bool uiTreeItem::areAllParentsChecked ( )

private

virtual bool uiTreeItem::askContinueAndSaveIfNeeded ( bool  withcancel )

privatevirtual

Reimplemented in uiODHorizon2DTreeItem, uiODFaultStickSetTreeItem, uiODPolygonTreeItem, uiODHorizonTreeItem, uiODDisplayTreeItem, uiODFaultTreeItem, uiODBodyDisplayTreeItem, uiODWellTreeItem, and uiODPickSetTreeItem.

NotifierAccess* uiTreeItem::checkStatusChange ( )

private

void uiTreeItem::collapse ( )

private

virtual bool uiTreeItem::doubleClick ( uiTreeViewItem *  )

protectedvirtual

Reimplemented in uiODPolygonTreeItem, uiODPickSetTreeItem, and uiODDisplayTreeItem.

void uiTreeItem::entryInEditMode ( int  col )

private

void uiTreeItem::expand ( )

private

virtual const uiTreeItem* uiTreeItem::findChild ( const char *  name ) const

privatevirtual

Finds a child in the tree below this item.

virtual const uiTreeItem* uiTreeItem::findChild ( int  selkey ) const

privatevirtual

Finds a child in the tree below this item.

virtual uiTreeItem* uiTreeItem::findChild ( const char *  name )

privatevirtual

Finds a child in the tree below this item.

virtual uiTreeItem* uiTreeItem::findChild ( int  selkey )

privatevirtual

Finds a child in the tree below this item.

virtual void uiTreeItem::findChildren ( const char *  , ObjectSet< uiTreeItem > &    )

privatevirtual

Finds all children in the tree below this item.

const uiTreeItem* uiTreeItem::getChild ( int  ) const

private

uiTreeItem* uiTreeItem::getChild ( int  )

private

ObjectSet<uiTreeItem>& uiTreeItem::getChildren ( )

inlineprivate

const ObjectSet<uiTreeItem>& uiTreeItem::getChildren ( ) const

inlineprivate

uiTreeViewItem* uiTreeItem::getItem ( )

inlineprivate

const uiTreeViewItem* uiTreeItem::getItem ( ) const

inlineprivate

template<class T >

bool uiTreeItem::getProperty ( const char *  key, T &  res  ) const

inlineprivate

Gets a keyed value that has been stored with setProperty().

Return values

true	the key was found and res is set
false	the key was not found and res is not set

Note

Should not be used if T is a pointer. Use getPropertyPtr( const char*, T& ) instead.

bool uiTreeItem::getPropertyPtr ( const char *  key, void *&  res  ) const

inlineprivate

Gets a keyed pointer that has been stored with setPropertyPtr().

Return values

true	the key was found and res is set
false	the key was not found and res is not set

virtual uiParent* uiTreeItem::getUiParent ( ) const

protectedvirtual

Reimplemented in uiTreeTopItem.

virtual bool uiTreeItem::init ( )

inlineprotectedvirtual

Reimplemented in ImageSubItem, ArrowSubItem, uiODFaultStickSetTreeItem, ScaleBarSubItem, uiODPolygonTreeItem, uiODVolrenSubTreeItem, uiOD2DLineTreeItem, uiODVw2DParentTreeItem, uiODAnnotSubItem, uiODDataTreeItem, uiODRandomLineTreeItem, uiODVw2DHor2DTreeItem, uiODSceneProbeTreeItem, uiODVw2DHor3DTreeItem, uiODVw2DPickSetTreeItem, uiODVw2DFaultSS2DTreeItem, uiODFaultTreeItem, uiODVw2DFaultTreeItem, uiODVw2DFaultSSTreeItem, uiODBodyDisplayTreeItem, uiODPSEventsTreeItem, uiODHorizonTreeItem, uiODAnnotTreeItem, uiODDisplayTreeItem, uiODWellTreeItem, uiODPickSetTreeItem, uiODEarthModelSurfaceTreeItem, uiODVolrenTreeItem, uiODAttribTreeItem, uiODVw2DFaultSS2DParentTreeItem, uiODVw2DFaultParentTreeItem, uiODVw2DHor2DParentTreeItem, uiODVw2DHor3DParentTreeItem, uiODVw2DFaultSSParentTreeItem, uiODVW2DVariableDensityTreeItem, uiODVw2DPickSetParentTreeItem, uiODVW2DWiggleVarAreaTreeItem, uiODPlaneDataTreeItem, uiODAnnotParentTreeItem, uiODTreeItem, uiODSceneObjTreeItem, uiODLine2DParentTreeItem, uiODPSEventsParentTreeItem, and uiODSceneParentTreeItem.

virtual bool uiTreeItem::isChecked ( ) const

privatevirtual

Reimplemented in uiTreeTopItem.

bool uiTreeItem::isCollapsed ( ) const

private

virtual bool uiTreeItem::isExpandable ( ) const

inlineprotectedvirtual

Reimplemented in uiODDataTreeItem, uiODDisplayTreeItem, uiODVolrenTreeItem, and uiODSceneObjTreeItem.

bool uiTreeItem::isExpanded ( ) const

private

virtual bool uiTreeItem::isSelectable ( ) const

inlineprotectedvirtual

Reimplemented in uiODDataTreeItem, uiODVw2DHor2DTreeItem, uiODVw2DHor3DTreeItem, uiODVw2DFaultSS2DTreeItem, uiODVw2DPickSetTreeItem, uiODVw2DFaultTreeItem, uiODVw2DFaultSSTreeItem, uiODDisplayTreeItem, uiODVW2DVariableDensityTreeItem, uiODVW2DWiggleVarAreaTreeItem, and uiODSceneObjTreeItem.

virtual bool uiTreeItem::isSelected ( ) const

privatevirtual

NotifierAccess* uiTreeItem::keyPressed ( )

private

uiTreeItem* uiTreeItem::lastChild ( )

private

virtual void uiTreeItem::moveItem ( uiTreeItem *  after )

privatevirtual

virtual void uiTreeItem::moveItemToTop ( )

privatevirtual

uiString uiTreeItem::name ( ) const

private

int uiTreeItem::nrChildren ( ) const

inlineprivate

virtual const char* uiTreeItem::parentType ( ) const

protectedpure virtual

Returns

typeid(parentclass).name()

Implemented in uiTreeTopItem, uiODZsliceTreeItem, ImageSubItem, uiODZsliceParentTreeItem, uiODCrosslineTreeItem, ArrowSubItem, uiODCrosslineParentTreeItem, uiODHorizon2DTreeItem, ScaleBarSubItem, uiODVw2DTreeTop, uiODFaultStickSetTreeItem, uiODPolygonTreeItem, uiODInlineTreeItem, uiODHorizon2DParentTreeItem, uiODVolrenSubTreeItem, uiODFaultStickSetParentTreeItem, uiOD2DLineTreeItem, uiODDataTreeItem, uiODInlineParentTreeItem, uiODAnnotSubItem, uiODRandomLineTreeItem, uiODPolygonParentTreeItem, uiODVw2DHor2DTreeItem, uiODVw2DHor3DTreeItem, uiODVw2DFaultSS2DTreeItem, uiODFaultTreeItem, uiODVw2DFaultTreeItem, uiODVw2DPickSetTreeItem, uiODVw2DFaultSSTreeItem, uiODBodyDisplayTreeItem, uiODHorizonTreeItem, uiODPickSetTreeItem, uiODWellTreeItem, uiODAnnotTreeItem, uiODSceneTreeTop, uiODVolrenTreeItem, uiODPSEventsTreeItem, uiODVw2DFaultSS2DParentTreeItem, uiODVw2DFaultParentTreeItem, uiODVw2DHor2DParentTreeItem, uiODVw2DHor3DParentTreeItem, uiODVw2DFaultSSParentTreeItem, uiODVW2DVariableDensityTreeItem, uiODVw2DPickSetParentTreeItem, uiODVW2DWiggleVarAreaTreeItem, uiODFaultParentTreeItem, uiODHorizonParentTreeItem, uiODSceneObjTreeItem, uiODWellParentTreeItem, uiODAnnotParentTreeItem, uiODRandomLineParentTreeItem, uiODBodyDisplayParentTreeItem, uiODPSEventsParentTreeItem, uiODLine2DParentTreeItem, uiODPickSetParentTreeItem, and uiODVolrenParentTreeItem.

virtual void uiTreeItem::prepareForShutdown ( )

privatevirtual

Override if you want to popup dlg for saving various things (or similar)

Reimplemented in uiODFaultStickSetTreeItem, uiODPolygonTreeItem, uiODFaultTreeItem, uiODBodyDisplayTreeItem, uiODPickSetTreeItem, uiODEarthModelSurfaceTreeItem, uiODDisplayTreeItem, uiPresManagedTreeItem, uiODAttribTreeItem, and uiODSceneTreeItem.

virtual void uiTreeItem::removeAllChildren ( )

privatevirtual

Reimplemented in uiODVw2DTreeItem.

virtual void uiTreeItem::removeChild ( uiTreeItem *  )

privatevirtual

Reimplemented in uiODHorizon2DParentTreeItem, uiODRandomLineParentTreeItem, and uiODHorizonParentTreeItem.

virtual void uiTreeItem::removeItem ( uiTreeViewItem *  )

protectedvirtual

Reimplemented in uiTreeTopItem.

virtual void uiTreeItem::renameItem ( uiTreeViewItem *  )

protectedvirtual

virtual bool uiTreeItem::rightClick ( uiTreeViewItem *  )

protectedvirtual

Reimplemented in uiODAnnotParentTreeItem.

virtual bool uiTreeItem::select ( )

privatevirtual

Selects this item

Reimplemented in uiODVw2DHor2DTreeItem, uiODVw2DFaultSS2DTreeItem, uiODVw2DHor3DTreeItem, uiODVw2DFaultTreeItem, uiODVw2DFaultSSTreeItem, uiODVw2DPickSetTreeItem, uiODDataTreeItem, uiODVW2DVariableDensityTreeItem, and uiODVW2DWiggleVarAreaTreeItem.

virtual int uiTreeItem::selectionKey ( ) const

inlineprivatevirtual

Reimplemented in uiODDisplayTreeItem, uiODSceneObjTreeItem, and uiODLine2DParentTreeItem.

virtual bool uiTreeItem::selectWithKey ( int  selkey )

protectedvirtual

Reimplemented in uiODVw2DTreeTop, and uiODSceneTreeTop.

void uiTreeItem::setChecked ( bool  yn, bool  trigger = false  )

private

void uiTreeItem::setName ( const uiString &  nm )

inlineprivate

void uiTreeItem::setPixmap ( int  col, const ColTab::Sequence *    )

private

template<class T >

void uiTreeItem::setProperty ( const char *  key, const T &  val  )

inlineprivate

Sets a keyed value that has been retrieved with getProperty().

Note

Should not be used if T is a pointer. Use setPropertyPtr( const char*, T& ) instead.

void uiTreeItem::setPropertyPtr ( const char *  key, void *  val  )

inlineprivate

Sets a keyed pointer that may have been retrieved with getPropertyPtr().

virtual void uiTreeItem::setTreeViewItem ( uiTreeViewItem *  )

protectedvirtual

virtual bool uiTreeItem::shouldSelect ( int  selectionkey ) const

protectedvirtual

Reimplemented in uiODDataTreeItem, and uiODDisplayTreeItem.

virtual bool uiTreeItem::showSubMenu ( )

inlineprotectedvirtual

Reimplemented in uiODHorizon2DParentTreeItem, uiODFaultStickSetParentTreeItem, uiODDataTreeItem, uiODPolygonParentTreeItem, uiODVw2DHor2DTreeItem, uiODVw2DHor3DTreeItem, uiODVw2DFaultSS2DTreeItem, uiODVw2DFaultTreeItem, uiODVw2DFaultSSTreeItem, uiODVw2DPickSetTreeItem, uiODAnnotTreeItem, uiODVolrenTreeItem, uiODFaultParentTreeItem, uiODDisplayTreeItem, uiODHorizonParentTreeItem, uiODVW2DVariableDensityTreeItem, uiODWellParentTreeItem, uiODSceneObjTreeItem, uiODVW2DWiggleVarAreaTreeItem, uiODSceneProbeParentTreeItem, uiODVw2DPickSetParentTreeItem, uiODPSEventsParentTreeItem, uiODVw2DFaultSS2DParentTreeItem, uiODBodyDisplayParentTreeItem, uiODVw2DFaultParentTreeItem, uiODVw2DHor2DParentTreeItem, uiODVw2DFaultSSParentTreeItem, uiODVw2DHor3DParentTreeItem, uiODLine2DParentTreeItem, and uiODPickSetParentTreeItem.

virtual uiTreeItem* uiTreeItem::siblingAbove ( )

privatevirtual

virtual uiTreeItem* uiTreeItem::siblingBelow ( )

privatevirtual

virtual int uiTreeItem::siblingIndex ( ) const

privatevirtual

virtual void uiTreeItem::translateText ( )

inlineprivatevirtual

virtual int uiTreeItem::uiTreeViewItemType ( ) const

protectedvirtual

Returns

the uiTreeViewItem::Type that should be created

Reimplemented in uiODDataTreeItem, and uiODDisplayTreeItem.

virtual void uiTreeItem::updateCheckStatus ( )

privatevirtual

Reimplemented in uiODDisplayTreeItem.

virtual void uiTreeItem::updateColumnText ( int  col )

privatevirtual

Reimplemented in uiTreeTopItem, ImageSubItem, uiODDataTreeItem, uiODVolrenSubTreeItem, uiODPSEventsTreeItem, uiODAttribTreeItem, VolProc::uiDataTreeItem, uiODDisplayTreeItem, and uiODSceneObjTreeItem.

virtual void uiTreeItem::updateSelection ( int  selectionKey, bool  dw = false  )

protectedvirtual

Does only update the display

Reimplemented in uiTreeTopItem.

void uiTreeItem::updateSelTreeColumnText ( int  col )

private

virtual bool uiTreeItem::useParentType ( ) const

inlineprotectedvirtual

Friends And Related Function Documentation

friend class uiODTreeTop

friend

friend class uiTreeTopItem

friend

Member Data Documentation

ObjectSet<uiTreeItem> uiTreeItem::children_

protected

uiString uiTreeItem::name_

protected

uiTreeItem* uiTreeItem::parent_

protected

IOPar uiTreeItem::properties_

protected

Returns

true if the item should be marked as selected given the selectionkey.

uiTreeViewItem* uiTreeItem::uitreeviewitem_

protected