Add version and description fields to Build

[libs/gltk.git] / source / panel.h

diff --git a/source/panel.h b/source/panel.h
index d922a991eb281b16017304786388d8915bc78170..397d71fc3974adac96bedec9763a32e283141d24 100644 (file)
--- a/source/panel.h
+++ b/source/panel.h
@@ -1,3 +1,10 @@
+/* $Id$
+
+This file is part of libmspgltk
+Copyright © 2007  Mikko Rasa, Mikkosoft Productions
+Distributed under the LGPL
+*/
+
 #ifndef MSP_GLTK_PANEL_H_
 #define MSP_GLTK_PANEL_H_
 
@@ -6,6 +13,11 @@
 namespace Msp {
 namespace GLtk {
 
+/**
+Panels are containers for other widgets.  Panel styles should have a special
+part "children" to render the child widgets.  All properties of this part are
+ignored.
+*/
 class Panel: public Widget
 {
 public:
@@ -23,29 +35,41 @@ public:
                void panel(const std::string &);
        };
 
-       Panel(const Resources &);
-       ~Panel();
-
-       void add(Widget &);
-       void button_press(int, int, unsigned);
-       void button_release(int, int, unsigned);
-       void pointer_motion(int, int);
-       void key_press(unsigned, unsigned, wchar_t);
-       void key_release(unsigned, unsigned);
-       void focus_out();
 private:
-       typedef std::list<Widget *> ChildSeq;
-
-       ChildSeq children;
+       std::list<Widget *> children;
        Widget *pointer_focus;
        unsigned pointer_grab;
        Widget *input_focus;
 
        Panel(const Panel &);
        Panel &operator=(const Panel &);
-       const char *get_class() const { return "panel"; }
-       void render_part(const Part &) const;
-       void set_pointer_focus(Widget *);
+public:
+       Panel(const Resources &);
+       ~Panel();
+
+       void add(Widget &);
+       void remove(Widget &);
+       void raise(Widget &);
+       void set_focus(Widget &);
+
+       virtual void button_press(int, int, unsigned);
+       virtual void button_release(int, int, unsigned);
+       virtual void pointer_motion(int, int);
+       virtual void pointer_leave();
+       virtual void key_press(unsigned, unsigned, wchar_t);
+       virtual void key_release(unsigned, unsigned);
+       virtual void focus_out();
+
+       // These functions are not intended to be called from outside GLtk
+       void child_hidden(Widget &);
+       void grab_pointer(Widget &);
+       void ungrab_pointer(Widget &);
+       void grab_focus(Widget &);
+private:
+       virtual const char *get_class() const { return "panel"; }
+       virtual void render_special(const Part &) const;
+
+       void set_pointer_focus(Widget *, int);
        void set_input_focus(Widget *);
        Widget *get_child_at(int, int);
 };