Example implementation of a single tree list node. More...

#include <TreeNode.h>

Inheritance diagram for TreeNode:

Public Member Functions
	TreeNode (const std::string labelText, TextFormat labelFormat, std::unique_ptr< IconPair > labelIcon)
	Construct a tree node with the given label.

void	addChildNode (std::unique_ptr< TreeNode > node)
	Adds a child node.

void	removeChildNode (TreeNode *node, int index)
	Removes a child node.

const std::vector< TreeNode * > &	childNodes () const
	Returns the list of children.

void	collapse ()
	Collapses this node.

void	expand ()
	Expands this node.

Public Member Functions inherited from Wt::WCompositeWidget
	WCompositeWidget ()

	WCompositeWidget (std::unique_ptr< WWidget > implementation)

virtual std::vector< WWidget * >	children () const override

virtual std::unique_ptr< WWidget >	removeWidget (WWidget *widget) override

virtual void	setObjectName (const std::string &name) override

virtual std::string	objectName () const override

virtual const std::string	id () const override

virtual void	setPositionScheme (PositionScheme scheme) override

virtual PositionScheme	positionScheme () const override

virtual void	setOffsets (const WLength &offset, WFlags< Side > sides=AllSides) override

virtual WLength	offset (Side s) const override

virtual void	resize (const WLength &width, const WLength &height) override

virtual WLength	width () const override

virtual WLength	height () const override

virtual void	setMinimumSize (const WLength &width, const WLength &height) override

virtual WLength	minimumWidth () const override

virtual WLength	minimumHeight () const override

virtual void	setMaximumSize (const WLength &width, const WLength &height) override

virtual WLength	maximumWidth () const override

virtual WLength	maximumHeight () const override

virtual void	setLineHeight (const WLength &height) override

virtual WLength	lineHeight () const override

virtual void	setFloatSide (Side s) override

virtual Side	floatSide () const override

virtual void	setClearSides (WFlags< Side > sides) override

virtual WFlags< Side >	clearSides () const override

virtual void	setMargin (const WLength &margin, WFlags< Side > sides=AllSides) override

virtual WLength	margin (Side side) const override

virtual void	setHiddenKeepsGeometry (bool enabled) override

virtual bool	hiddenKeepsGeometry () const override

virtual void	setHidden (bool hidden, const WAnimation &animation=WAnimation()) override

virtual bool	isHidden () const override

virtual bool	isVisible () const override

virtual void	setDisabled (bool disabled) override

virtual bool	isDisabled () const override

virtual bool	isEnabled () const override

virtual void	setPopup (bool popup) override

virtual bool	isPopup () const override

virtual void	setInline (bool isInline) override

virtual bool	isInline () const override

virtual void	setDecorationStyle (const WCssDecorationStyle &style) override

virtual WCssDecorationStyle &	decorationStyle () override

virtual void	setStyleClass (const WString &styleClass) override

virtual WString	styleClass () const override

virtual void	addStyleClass (const WString &styleClass, bool force=false) override

virtual void	removeStyleClass (const WString &styleClass, bool force=false) override

virtual bool	hasStyleClass (const WString &styleClass) const override

virtual void	setVerticalAlignment (AlignmentFlag alignment, const WLength &length=WLength::Auto) override

virtual AlignmentFlag	verticalAlignment () const override

virtual WLength	verticalAlignmentLength () const override

virtual void	setToolTip (const WString &text, TextFormat textFormat=TextFormat::Plain) override

virtual WString	toolTip () const override

virtual void	setDeferredToolTip (bool enable, TextFormat textFormat=TextFormat::Plain) override

virtual void	refresh () override

virtual void	setAttributeValue (const std::string &name, const WString &value) override

virtual WString	attributeValue (const std::string &name) const override

virtual void	setJavaScriptMember (const std::string &name, const std::string &value) override

virtual std::string	javaScriptMember (const std::string &name) const override

virtual void	callJavaScriptMember (const std::string &name, const std::string &args) override

virtual void	load () override

virtual bool	loaded () const override

virtual void	setCanReceiveFocus (bool enabled) override

virtual bool	canReceiveFocus () const override

virtual void	setFocus (bool focus) override

virtual bool	setFirstFocus () override

virtual bool	hasFocus () const override

virtual void	setTabIndex (int index) override

virtual int	tabIndex () const override

virtual void	setId (const std::string &id) override

virtual WWidget *	find (const std::string &name) override

virtual WWidget *	findById (const std::string &name) override

virtual void	setSelectable (bool selectable) override

virtual void	doJavaScript (const std::string &js) override

virtual void	propagateSetEnabled (bool enabled) override

virtual bool	scrollVisibilityEnabled () const final override

virtual void	setScrollVisibilityEnabled (bool enabled) final override

virtual int	scrollVisibilityMargin () const final override

virtual void	setScrollVisibilityMargin (int margin) final override

virtual Signal< bool > &	scrollVisibilityChanged () final override

virtual bool	isScrollVisible () const final override

virtual void	setThemeStyleEnabled (bool enabled) final override

virtual bool	isThemeStyleEnabled () const final override

virtual std::unique_ptr< WWidget >	removeWidget (WWidget *widget)

std::unique_ptr< Widget >	removeWidget (Widget *widget)

void	setFocus ()

virtual void	setFocus (bool focus)=0

Public Member Functions inherited from Wt::WWidget
virtual	~WWidget ()

WWidget *	parent () const

std::unique_ptr< Widget >	removeWidget (Widget *widget)

std::unique_ptr< WWidget >	removeFromParent ()

void	setWidth (const WLength &width)

void	setHeight (const WLength &height)

virtual void	positionAt (const WWidget *widget, Orientation orientation=Orientation::Vertical, WFlags< Orientation > adjustOrientations=AllOrientations)

virtual void	toggleStyleClass (const WString &styleClass, bool add, bool force=false)

std::string	jsRef () const

void	setFocus ()

virtual void	acceptDrops (const std::string &mimeType, const WString &hoverStyleClass=WString())

virtual void	stopAcceptDrops (const std::string &mimeType)

virtual void	htmlText (std::ostream &out)

bool	isRendered () const

void	hide ()

void	animateHide (const WAnimation &animation)

void	show ()

void	animateShow (const WAnimation &animation)

void	enable ()

void	disable ()

bool	layoutSizeAware () const

virtual void	scheduleThemeStyleApply (std::shared_ptr< Wt::WTheme > theme, WWidget *child, int role)

virtual void	applyThemeStyles ()

Public Member Functions inherited from Wt::WObject
void	addChild (std::unique_ptr< WObject > child)

Child *	addChild (std::unique_ptr< Child > child)

std::unique_ptr< WObject >	removeChild (WObject *child)

std::unique_ptr< Child >	removeChild (Child *child)

void	resetLearnedSlots ()

void	resetLearnedSlot (void(T::*method)())

WStatelessSlot *	implementStateless (void(T::*method)())

WStatelessSlot *	implementStateless (void(T::method)(), void(T::undoMethod)())

void	isNotStateless ()

WStatelessSlot *	implementJavaScript (void(T::*method)(), const std::string &jsCode)

Public Member Functions inherited from Wt::Core::observable
	observable () noexcept

virtual	~observable ()

auto	bindSafe (void(C::*method)(Args...)) noexcept

auto	bindSafe (void(C::*method)(Args...) const) const noexcept

auto	bindSafe (const Function &function) noexcept

Private Types
enum	ImageIndex { Middle = 0 , Last = 1 }
	Two sets of images, for a normal node, and for the last node. More...

Private Member Functions
void	adjustExpandIcon ()
	Adjust the expand icon.

bool	isLastChildNode () const
	Returns if is the last child within its parent (is rendered differently)

void	childNodesChanged ()
	Rerender when children have changed.

void	undoCollapse ()
	Undo function for prelearning collapse()

void	undoExpand ()
	Undo function for prelearning expand()

Private Attributes
std::vector< TreeNode * >	childNodes_
	List of child nodes.

TreeNode *	parentNode_
	The parent node.

WTable *	layout_
	Layout (2x2 table).

IconPair *	expandIcon_
	The icon for expanding or collapsing.

WImage *	noExpandIcon_
	The single image shown instead of the expand/collapse icon when no children.

IconPair *	labelIcon_
	The icon next to the label.

WText *	childCountLabel_
	The children count '(x)' for x children.

WContainerWidget *	expandedContent_
	The container in which the children are managed.

bool	wasCollapsed_
	Was collapsed (for undo of prelearned collapse() and expand() slots.

Static Private Attributes
static std::string	imageLine_ []

static std::string	imagePlus_ []

static std::string	imageMin_ []

Additional Inherited Members
Public Types inherited from Wt::WObject
typedef void(WObject::*	Method) ()

Static Public Member Functions inherited from Wt::WWidget
static WString	tr (const char *key)

Protected Member Functions inherited from Wt::WCompositeWidget
virtual void	enableAjax () override

void	setImplementation (std::unique_ptr< WWidget > widget)

Widget *	setImplementation (std::unique_ptr< Widget > widget)

W *	setNewImplementation (Args &&... args)

WWidget *	implementation ()

virtual int	boxPadding (Orientation orientation) const override

virtual int	boxBorder (Orientation orientation) const override

virtual void	render (WFlags< RenderFlag > flags) override

Protected Member Functions inherited from Wt::WWidget
void	setLayoutSizeAware (bool sizeAware)

virtual void	layoutSizeChanged (int width, int height)

	WWidget ()

virtual void	dropEvent (WDropEvent dropEvent)

void	scheduleRender (WFlags< RepaintFlag > flags=None)

virtual WStatelessSlot *	getStateless (Method method) override

Detailed Description

Example implementation of a single tree list node.

This is an example of a basic treelist implementation. As of version 1.1.8, a more flexible treenode implementation is included as part of the library: WTreeNode.

A tree list is constructed by nesting TreeNode objects in a tree hierarchy.

A TreeNode has a label, and optionally a two-state label icon, which defines a different image depending on the state of the node (expanded or collapsed). When the node has any children, a child count is also indicated.

Next to the icons, two style classes determine the look of a TreeNode: the label has style "treenodelabel", and the child count has as style "treenodechildcount".

Use CSS nested selectors to apply different styles to different treenodes. For example, to style the treenode with style class "mynode":

The behaviour of the tree node is to collapse all children when the node is expanded (this is similar to how most tree node implementations work).

The widget uses a number of images which must be available in an "icons/" folder (see the Wt treelist examples).

This widget is part of the Wt treelist example.

Definition at line 57 of file TreeNode.h.

Member Enumeration Documentation

◆ ImageIndex

enum TreeNode::ImageIndex

private

Two sets of images, for a normal node, and for the last node.

Enumerator
Middle
Last

Definition at line 138 of file TreeNode.h.

138{ Middle = 0, Last = 1 };

TreeNode::Last

@ Last

Definition TreeNode.h:138

TreeNode::Middle

@ Middle

Definition TreeNode.h:138

Constructor & Destructor Documentation

◆ TreeNode()

TreeNode::TreeNode	(	const std::string	labelText,
		TextFormat	labelFormat,
		std::unique_ptr< IconPair >	labelIcon
	)

Construct a tree node with the given label.

The label is formatted in a WText with the given formatting. The labelIcon (if not 0) will appear next to the label and its state will reflect the expand/collapse state of the node.

Optionally, a userContent widget may be associated with the node. When expanded, this widget will be shown below the widget, but above any of the children nodes.

Definition at line 25 of file TreeNode.C.

  : parentNode_(nullptr),
    labelIcon_(labelIcon.get())
{
  // pre-learned stateless implementations ...
  implementStateless(&TreeNode::expand, &TreeNode::undoExpand);
  implementStateless(&TreeNode::collapse, &TreeNode::undoCollapse);
 
  // ... or auto-learned stateless implementations
  // which do not need undo functions
  //implementStateless(&TreeNode::expand);
  //implementStateless(&TreeNode::collapse);
 
  layout_ = setNewImplementation<WTable>();
 
  expandIcon_ = layout_->elementAt(0, 0)->addNew<IconPair>(imagePlus_[Last], imageMin_[Last]);
  expandIcon_->hide();
 
  noExpandIcon_ = layout_->elementAt(0, 0)->addNew<WImage>(imageLine_[Last]);
 
  expandedContent_ = layout_->elementAt(1, 1)->addNew<WContainerWidget>();
  expandedContent_->hide();
 
  auto labelTextWidget = std::make_unique<WText>(labelText);
  labelTextWidget->setTextFormat(labelFormat);
  labelTextWidget->setStyleClass("treenodelabel");
 
  auto childCountLabel = std::make_unique<WText>();
  childCountLabel_ = childCountLabel.get();
  childCountLabel_->setMargin(7, Side::Left);
  childCountLabel_->setStyleClass("treenodechildcount");
 
  if (labelIcon) {
    layout_->elementAt(0, 1)->addWidget(std::move(labelIcon));
    labelIcon_->setVerticalAlignment(AlignmentFlag::Middle);
  }
  layout_->elementAt(0, 1)->addWidget(std::move(labelTextWidget));
  layout_->elementAt(0, 1)->addWidget(std::move(childCountLabel));
 
  layout_->elementAt(0, 0)->setContentAlignment(AlignmentFlag::Top);
  layout_->elementAt(0, 1)->setContentAlignment(AlignmentFlag::Middle);
 
  expandIcon_->icon1Clicked->connect(this, &TreeNode::expand);
  expandIcon_->icon2Clicked->connect(this, &TreeNode::collapse);
} //

Member Function Documentation

◆ addChildNode()

void TreeNode::addChildNode ( std::unique_ptr< TreeNode > node )

Adds a child node.

Definition at line 81 of file TreeNode.C.

{
  childNodes_.push_back(node.get());
  node->parentNode_ = this;
 
  expandedContent_->addWidget(std::move(node));
 
  childNodesChanged();
}

◆ adjustExpandIcon()

void TreeNode::adjustExpandIcon ( )

private

Adjust the expand icon.

Definition at line 172 of file TreeNode.C.

{
  ImageIndex index = isLastChildNode() ? Last : Middle;
 
  if (expandIcon_->icon1()->imageLink().url() != imagePlus_[index])
    expandIcon_->icon1()->setImageLink(imagePlus_[index]);
  if (expandIcon_->icon2()->imageLink().url() != imageMin_[index])
    expandIcon_->icon2()->setImageLink(imageMin_[index]);
  if (noExpandIcon_->imageLink().url() != imageLine_[index])
    noExpandIcon_->setImageLink(imageLine_[index]);
 
  if (index == Last) {
    layout_->elementAt(0, 0)
      ->decorationStyle().setBackgroundImage("");
    layout_->elementAt(1, 0)
      ->decorationStyle().setBackgroundImage("");
  } else {
    layout_->elementAt(0, 0)
      ->decorationStyle().setBackgroundImage("icons/line-trunk.gif",
                                             Orientation::Vertical);
    layout_->elementAt(1, 0)
      ->decorationStyle().setBackgroundImage("icons/line-trunk.gif",
                                             Orientation::Vertical);
  } //
 
  if (childNodes_.empty()) {
    if (noExpandIcon_->isHidden()) {
      noExpandIcon_->show();
      expandIcon_->hide();
    }
  } else {
    if (expandIcon_->isHidden()) {
      noExpandIcon_->hide();
      expandIcon_->show();
    }
  }
} //

◆ childNodes()

const std::vector< TreeNode * > & TreeNode::childNodes ( ) const

inline

Returns the list of children.

Definition at line 84 of file TreeNode.h.

84{ return childNodes_; }

◆ childNodesChanged()

void TreeNode::childNodesChanged ( )

private

Rerender when children have changed.

Definition at line 102 of file TreeNode.C.

{
  for (auto node : childNodes_)
    node->adjustExpandIcon();
 
  adjustExpandIcon();
 
  if (!childNodes_.empty()) {
    childCountLabel_ ->setText("(" + std::to_string(childNodes_.size()) + ")");
  } else {
    childCountLabel_->setText("");
  }
 
  resetLearnedSlots();
} //

◆ collapse()

void TreeNode::collapse ( )

Collapses this node.

Definition at line 118 of file TreeNode.C.

{
  wasCollapsed_ = expandedContent_->isHidden();
 
  expandIcon_->setState(0);
  expandedContent_->hide();
  if (labelIcon_)
    labelIcon_->setState(0);
} //

◆ expand()

void TreeNode::expand ( )

Expands this node.

Definition at line 128 of file TreeNode.C.

{
  wasCollapsed_ = expandedContent_->isHidden();
 
  expandIcon_->setState(1);
  expandedContent_->show();
  if (labelIcon_)
    labelIcon_->setState(1);
 
  /*
   * collapse all children
   */
  for (auto node : childNodes_)
    node->collapse();
} //

◆ isLastChildNode()

bool TreeNode::isLastChildNode ( ) const

private

Returns if is the last child within its parent (is rendered differently)

Definition at line 73 of file TreeNode.C.

{
  if (parentNode_) {
    return parentNode_->childNodes_.back() == this;
  } else
    return true;
}

◆ removeChildNode()

void TreeNode::removeChildNode	(	TreeNode *	node,
		int	index
	)

Removes a child node.

Definition at line 91 of file TreeNode.C.

{
  childNodes_.erase(childNodes_.begin() + index);
 
  node->parentNode_ = nullptr;
 
  expandedContent_->removeWidget(node);
 
  childNodesChanged();
} //

◆ undoCollapse()

void TreeNode::undoCollapse ( )

private

Undo function for prelearning collapse()

Definition at line 144 of file TreeNode.C.

{
  if (!wasCollapsed_) {
    // re-expand
    expandIcon_->setState(1);
    expandedContent_->show();
    if (labelIcon_)
      labelIcon_->setState(1);
  }
}

◆ undoExpand()

void TreeNode::undoExpand ( )

private

Undo function for prelearning expand()

Definition at line 155 of file TreeNode.C.

{
  if (wasCollapsed_) {
    // re-collapse
    expandIcon_->setState(0);
    expandedContent_->hide();
    if (labelIcon_)
      labelIcon_->setState(0);
  }
 
  /*
   * undo collapse of children
   */
  for (auto node : childNodes_)
    node->undoCollapse();
} //

Member Data Documentation

◆ childCountLabel_

WText* TreeNode::childCountLabel_

private

The children count '(x)' for x children.

Definition at line 114 of file TreeNode.h.

◆ childNodes_

std::vector<TreeNode *> TreeNode::childNodes_

private

List of child nodes.

Definition at line 96 of file TreeNode.h.

◆ expandedContent_

WContainerWidget* TreeNode::expandedContent_

private

The container in which the children are managed.

Definition at line 117 of file TreeNode.h.

◆ expandIcon_

IconPair* TreeNode::expandIcon_

private

The icon for expanding or collapsing.

Definition at line 105 of file TreeNode.h.

◆ imageLine_

std::string TreeNode::imageLine_

staticprivate

Initial value:

= { "icons/line-middle.gif",

"icons/line-last.gif" }

Definition at line 18 of file TreeNode.h.

◆ imageMin_

std::string TreeNode::imageMin_

staticprivate

Initial value:

= { "icons/nav-minus-line-middle.gif",

"icons/nav-minus-line-last.gif" }

Definition at line 22 of file TreeNode.h.

◆ imagePlus_

std::string TreeNode::imagePlus_

staticprivate

Initial value:

= { "icons/nav-plus-line-middle.gif",

"icons/nav-plus-line-last.gif" }

Definition at line 20 of file TreeNode.h.

◆ labelIcon_

IconPair* TreeNode::labelIcon_

private

The icon next to the label.

Definition at line 111 of file TreeNode.h.

◆ layout_

WTable* TreeNode::layout_

private

Layout (2x2 table).

Definition at line 102 of file TreeNode.h.

◆ noExpandIcon_

WImage* TreeNode::noExpandIcon_

private

The single image shown instead of the expand/collapse icon when no children.

Definition at line 108 of file TreeNode.h.

◆ parentNode_

TreeNode* TreeNode::parentNode_

private

The parent node.

Definition at line 99 of file TreeNode.h.

◆ wasCollapsed_

bool TreeNode::wasCollapsed_

private

Was collapsed (for undo of prelearned collapse() and expand() slots.

Definition at line 129 of file TreeNode.h.

The documentation for this class was generated from the following files:

treelist/TreeNode.h
treelist/TreeNode.C

Public Member Functions

Private Types

Private Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ ImageIndex

Constructor & Destructor Documentation

◆ TreeNode()

Member Function Documentation

◆ addChildNode()

◆ adjustExpandIcon()

◆ childNodes()

◆ childNodesChanged()

◆ collapse()

◆ expand()

◆ isLastChildNode()

◆ removeChildNode()

◆ undoCollapse()

◆ undoExpand()

Member Data Documentation

◆ childCountLabel_

◆ childNodes_

◆ expandedContent_

◆ expandIcon_

◆ imageLine_

◆ imageMin_

◆ imagePlus_

◆ labelIcon_

◆ layout_

◆ noExpandIcon_

◆ parentNode_

◆ wasCollapsed_