gui/auxiliary/old_markup.hpp

Go to the documentation of this file.

/* $Id: old_markup.hpp 52533 2012-01-07 02:35:17Z shadowmaster $ */
/*
   Copyright (C) 2008 - 2012 by Mark de Wever <koraq@xs4all.nl>
   Part of the Battle for Wesnoth Project http://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.
*/

#ifndef GUI_AUXILIARY_OLD_MARKUP_INCLUDED
#define GUI_AUXILIARY_OLD_MARKUP_INCLUDED

#include <string>

namespace gui2
{

/**
 * Implements simple parsing of legacy GUI1 item markup.
 */
class tlegacy_menu_item
{
    /*
     * Legacy options/menu items have some special markup:
     * A line starting with a * is selected by default.
     * A line starting with a & enables the following markup:
     * - The part until the = is the name of an image.
     * - The part until the second = is the first column.
     * - The rest is the third column (the wiki only specifies two columns
     *   so only two of them are implemented).
     */
    /**
     * @todo This syntax looks like a bad hack, it would be nice to write
     * a new syntax which doesn't use those hacks (also avoids the problem
     * with special meanings for certain characters.
     */
public:
    explicit tlegacy_menu_item(const std::string& str = std::string());

    const std::string& icon() const {
        return icon_;
    }

    const std::string& label() const {
        return label_;
    }

    const std::string& description() const {
        return desc_;
    }

    bool is_default() const {
        return default_;
    }

    tlegacy_menu_item& operator=(const tlegacy_menu_item& rhs) {
        if(&rhs != this) {
            icon_ = rhs.icon_;
            label_ = rhs.label_;
            desc_ = rhs.desc_;
        }
        return *this;
    }

private:
    /** The icon for the menu item. */
    std::string icon_;

    /** The first text item of the menu item, normally a short string. */
    std::string label_;

    /** The second text item of the menu item, normally a longer string. */
    std::string desc_;

    /**
     * Is the item the default item and thus initially selected.
     *
     * It's unspecified what happens if multiple items in a menu are selected.
     */
    bool default_;
};

}

#endif