walker_tree_node.hpp

Go to the documentation of this file.

/*
    Copyright (C) 2011 - 2024
    by Mark de Wever <koraq@xs4all.nl>
    Part of the Battle for Wesnoth Project https://www.wesnoth.org/
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY.
 
    See the COPYING file for more details.
*/
 
#pragma once
 
#include "gui/auxiliary/iterator/walker.hpp"
 
#include "gui/widgets/tree_view_node.hpp"
 
namespace gui2::iteration
{
 
/** A walker for a @ref gui2::tree_view_node. */
class tree_node : public walker_base
{
public:
    /**
     * Constructor.
     *
     * @param node                The tree view node which the walker is attached to.
     * @param children            The node's children.
     */
    tree_node(gui2::tree_view_node& node, tree_view_node::node_children_vector& children);
 
    /** Inherited from @ref gui2::iteration::walker_base. */
    virtual state_t next(const level level);
 
    /** Inherited from @ref gui2::iteration::walker_base. */
    virtual bool at_end(const level level) const;
 
    /** Inherited from @ref gui2::iteration::walker_base. */
    virtual gui2::widget* get(const level level);
 
private:
    /** The children of the node which the walker is attached to. */
    tree_view_node::node_children_vector& children_;
 
    /**
     * The node which the walker is attached to.
     *
     * This variable is used to track whether the
     * gui2::iteration::walker_base::widget level has been visited.
     */
    gui2::widget* widget_;
 
    /**
     * The iterator to the children of the node.
     *
     * This variable is used to track where the @ref
     * gui2::iteration::walker_base::child level visiting is.
     */
    tree_view_node::node_children_vector::iterator itor_;
};
 
} // namespace gui2::iteration