summaryrefslogtreecommitdiff
path: root/src/gui/windowcontainer.h
blob: 582faf7a8344eac5bfe7fcac600b61b9d39170d0 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
/*
 *  The Mana World
 *  Copyright 2004 The Mana World Development Team
 *
 *  This file is part of The Mana World.
 *
 *  The Mana World 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
 *  any later version.
 *
 *  The Mana World is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with The Mana World; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 *  $Id$
 */

#ifndef _TMW_WINDOWCONTAINER_H_
#define _TMW_WINDOWCONTAINER_H_

#include <guichan.hpp>

class Window;

/**
 * A window container. This container makes draggable windows possible.
 *
 * \ingroup GUI
 */
class WindowContainer : public gcn::Container {
    public:
        /**
         * Constructor.
         */
        WindowContainer();

        /**
         * Do GUI logic. This functions adds automatic deletion of objects that
         * volunteered to be deleted.
         */
        void logic();

        /**
         * Handles mouse input messages. Differs from standard behaviour in
         * that widget with mouse doesn't change while a button is pressed.
         */
        void _mouseInputMessage(const gcn::MouseInput &mouseInput);

        /**
         * Adds a widget. The widget can be set to be modal, which will ensure
         * only that widget will receive input.
         */
        void add(gcn::Widget *widget);

        /**
         * Adds a window. The window can be set to be modal, which will ensure
         * only that window will receive input. Note that when a modal widget
         * has already been set, a new window can only be made model when the
         * previously modal window is its parent.
         */
        void WindowContainer::add(Window *window, bool modal);

        /**
         * Removes a widget.
         */
        void remove(gcn::Widget *widget);

        /**
         * This function is called by the containers children when they get
         * destroyed.
         */
        void _announceDeath(gcn::Widget *widget);

        /**
         * Clears the container of all widgets.
         */
        void clear();

        /**
         * Sets the modal widget. This will ensure only this widget will
         * receive mouse or keyboard input events.
         *
         * @see Window::Window
         */
        void setModalWindow(Window *window);

        /**
         * Returns the current modal widget, or <code>NULL</code> if there
         * is none.
         */
        gcn::Widget *getModalWindow();

        /**
         * Schedule a widget for deletion. It will be deleted at the start of
         * the next logic update.
         */
        void scheduleDelete(gcn::Widget *widget);

    protected:
        bool mouseDown;
        Window *modalWindow;

        std::list<gcn::Widget*> deathList;
};

#endif