X-Git-Url: http://git.tdb.fi/?a=blobdiff_plain;f=source%2Fwidget.h;h=a83cecc9bef8c14643cc4855faaeda1712ac603d;hb=af13797a82b242a3cd8fdd405b057a9e311631ac;hp=557df434adcd34f98d858324ab753e8271b9a1a5;hpb=b23464cda4e4f2c7b69b18549f18c2c893c3fe2d;p=libs%2Fgltk.git

diff --git a/source/widget.h b/source/widget.h
index 557df43..a83cecc 100644
--- a/source/widget.h
+++ b/source/widget.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_WIDGET_H_
 #define MSP_GLTK_WIDGET_H_
 
@@ -8,10 +15,15 @@
 namespace Msp {
 namespace GLtk {
 
+class Panel;
 class Part;
 class Resources;
 class Style;
 
+/**
+Base class for all widgets.  Derived classes should call update_style in 
+constructor, because it can't be done correctly in the Widget constructor.
+*/
 class Widget
 {
 public:
@@ -29,14 +41,41 @@ public:
 		void style(const std::string &);
 	};
 
-	virtual ~Widget() { }
+protected:
+	const Resources &res;
+	Geometry geom;
+	std::string style_name;
+	const Style *style;
+	State state;
+	bool visible;
+	Panel *parent;
+
+	Widget(const Resources &);
+public:
+	virtual ~Widget();
 	void set_position(int, int);
 	void set_size(unsigned, unsigned);
 	void set_geometry(const Geometry &);
+
+	/**
+	Sets the widget style.  The final style name is constructed by concatenating
+	the widget class and the style name with a dash.
+	*/
 	void set_style(const std::string &);
+
+	void set_visible(bool);
+
 	const Geometry &get_geometry() const { return geom; }
 	bool is_visible() const { return visible; }
+
 	void render() const;
+protected:
+	void render_graphic(const Part &) const;
+	void render_text(const Part &, const std::string &) const;
+	virtual void render_special(const Part &) const { }
+
+public:
+	// Events
 	virtual void button_press(int, int, unsigned) { }
 	virtual void button_release(int, int, unsigned) { }
 	virtual void pointer_motion(int, int) { }
@@ -46,20 +85,34 @@ public:
 	virtual void key_release(unsigned, unsigned) { }
 	virtual void focus_in() { }
 	virtual void focus_out() { }
-protected:
-	const Resources &res;
-	Geometry geom;
-	std::string style_name;
-	const Style *style;
-	State state;
-	bool visible;
 
-	Widget(const Resources &);
+protected:
+	/**
+	Returns the name of the widget class.  Used for style lookup.
+	*/
 	virtual const char *get_class() const { return "widget"; }
+
+	/**
+	Gets a style object from the resource collection based on the class and
+	style names of the widget.
+	*/
 	void update_style();
-	virtual void render_part(const Part &) const;
-	void render_graphic(const Part &) const;
-	void render_text(const Part &, const std::string &) const;
+
+	/**
+	Sets the widget's parent Panel.  The widget must be unparented when calling
+	this function with a nonzero parameter.
+	*/
+	void set_parent(Panel *);
+
+	/**
+	A helper function to set the parent of another widget.
+	*/
+	void set_parent(Widget &, Panel *);
+
+	// More events
+	virtual void on_geometry_change() { }
+	virtual void on_style_change() { }
+	virtual void on_reparent() { }
 };
 
 } // namespace GLtk