projects/dynamin: dynamin/gui/control.d comparison

comparison dynamin/gui/control.d @ 5:4029d5af7542

Add blank lines and rewrap some comments.

author	Jordan Miner <jminer7@gmail.com>
date	Sat, 20 Jun 2009 12:26:40 -0500
parents	aa4efef0f0b1
children	b621b528823d

comparison

equal deleted inserted replaced

-:fc2420d39e3c
+:4029d5af7542
 		e.graphics.save();
 		// TODO: every call to a handler should be wrapped in a save/restore
 		painting.callHandlers(e);
 		e.graphics.restore();
 	}
 	this() {
 		moved = new Event!()(&whenMoved);
 		resized = new Event!()(&whenResized);
 		mouseEntered = new Event!()(&whenMouseEntered, &dispatchMouseEntered);
 		mouseLeft = new Event!()(&whenMouseLeft);
 		// TODO: remove these when themes mature
 		_foreColor = Color.Black;
 		_font = new Font("Tahoma", 11);
 	}
 	protected Graphics quickCreateGraphics() {
 		if(_parent is null)
 			return null;
 		auto g = _parent.quickCreateGraphics();
 		g.translate(location);
 		return g;
 	}
 	/**
 	 * Sets the specified Graphics' font and source to this control's font
 	 * and foreground color. Also, clips to this control's rectangle.
 	 */
 	void setupGraphics(Graphics g) {
 		g.rectangle(0, 0, width, height);
 		g.clip();
 		g.font = font;
 		g.source = foreColor;
 	}
 	/**
 	 * Creates a Graphics, calls the specified delegate with it, and deletes
 	 * it to release resources.
 	 */
 	void withGraphics(void delegate(Graphics g) dg) {
 		auto g = quickCreateGraphics();
 		setupGraphics(g);
 		dg(g);
 		delete g;
 	}
 	/**
 	 *
 	 */
 	bool focused() {
 		return _focused;
 	}
 	/**
 	 *
 	 */
 	void focus() {
 		if(!_focusable)
 			win.focusedControl = this;
 			_focused = true;
 			repaint();
 		}
 	}
 	/**
 	 * Returns whether this control is on the screen. A control is
 	 * on screen if one of its ancestors is a top level window. Whether or
 	 * not the control is visible has no bearing on this value. If a control
 	 * has no parent, then it is clearly not on the screen.
 	 */
 	bool onScreen() {
 		return _parent && _parent.onScreen;
 	}
 	/**
 	 * Gets the location of this control in screen coordinates. An exception is
 	 * thrown if this control is not on the screen.
 	 */
 	Point screenLocation() {
 		if(!_parent)
 			throw new Exception("control is not on screen");
 		return _parent.screenLocation + location;
 	}
 	/**
 	 * Converts the specified point in content coordinates into screen
 	 * coordinates. An exception is thrown if this control is not on the screen.
 	 */
 	Point contentToScreen(Point pt) { // TODO: content?? even on Window??
 		if(!_parent)
 			throw new Exception("control is not on screen");
 		return _parent.contentToScreen(pt + location);
 	}
 	/**
 	 * Converts the specified point in screen coordinates into content
 	 * coordinates. An exception is thrown if this control is not on the screen.
 	 */
 	Point screenToContent(Point pt) {
 		if(!_parent)
 			throw new Exception("control is not on screen");
 		return _parent.screenToContent(pt) - location; // TODO: borders
 	}
 	/**
 	 * Converts the specified point in this control's content coordinates
 	 * into the specified control's content coordinates. An exception is
 	 * thrown if this control is not on the screen.
 	 */
 	Point contentToContent(Point pt, Control c) {
 		return c.screenToContent(contentToScreen(pt));
 	}
 	/**
 	 * Returns whether the specified point is inside this control.
 	 */
 	bool contains(Point pt) {
 		return pt.x >= 0 && pt.y >= 0 && pt.x < width && pt.y < height;
 	}
 	/// ditto
 	bool contains(real x, real y) {
 		return contains(Point(x, y));
 	}
 	bool topLevel() { return false; }
 	// TODO: return NativeControl/Window?
 	Control getTopLevel() {
 		Control c = this;
 		while(c.parent)
 			c = c.parent;
 		return c.topLevel ? c : null;
 	}
 	/**
 	 * Gets this control's parent.
 	 */
 	Container parent() { return _parent; }
 	package void parent(Container c) {
 		_parent = c;
 		//ParentChanged(new EventArgs); // TODO: add event
 	}
-	/**
-	 * Gets or sets whether is control is visible. The default is true, except on top-level windows.
+	/**
+	 * Gets or sets whether is control is visible. The default is true, except
+	 * on top-level windows.
 	 */
 	//void visible(bool b) { visible = b; }
 	bool visible() { return _visible; }
 	/**
 	 * if it is elastic, or if it needs to be aligned with other controls.
 	 *
 	 * This property should be overridden in subclasses to return a best size.
 	 */
 	Size bestSize() { return Size(100, 100); }
 	/**
 	 * Gets the distance from the top of this control to the baseline of
 	 * the first line of this control's text. If this control does not have
 	 * text, 0 may be returned.
 	 */
 	void elasticX(bool b) { _elasticX = b; }
 	/// ditto
 	bool elasticY() { return _elasticY; }
 	/// ditto
 	void elasticY(bool b) { _elasticY = b; }
 	/**
 	 * Gets or sets the text that this control shows.
 	 */
 	string text() { return _text.dup; }
 	/// ditto
 	/// ditto
 	void font(Font f) {
 		_font = f;
 		repaint();
 	}
 	Cursor cursor() {
 		return _cursor;
 	}
 	void cursor(Cursor cur) {
 		if(_cursor is cur)
 	 * The control will not be repainted before this method returns; rather,
 	 * the area is just marked as needing to be repainted. The next time there
 	 * are no other system events to be processed, a painting event will called.
 	 */
 	void repaint(Rect rect) {
-		// TODO: make sure that parts clipped off by the parent are not invalidated
+		// TODO: make sure that parts clipped off by the parent are
+		//       not invalidated
 		if(_parent)
 			_parent.repaint(rect + location);
 	}
 	/// ditto
 	void repaint(real x, real y, real width, real height) {

Mercurial > projects > dynamin

comparison dynamin/gui/control.d @ 5:4029d5af7542