alignToRectangleTop.as

package utils.align
{
	import flash.display.DisplayObject;
	import flash.geom.Rectangle;

	/**
	   Aligns a DisplayObject to the top of the bounding Rectangle.

	   @param displayObject: The DisplayObject to align.
	   @param bounds: The area in which to align the DisplayObject.
	   @param snapToPixel: Force the position to whole pixels <code>true</code>, or to let the DisplayObject be positioned on sub-pixels <code>false</code>.
	   @param outside: Align the DisplayObject to the outside of the bounds <code>true</code>, or the inside <code>false</code>.
	 */
	public function alignToRectangleTop(displayObject:DisplayObject, bounds:Rectangle, snapToPixel:Boolean = true, outside:Boolean = false):void
	{
		var y:Number = outside ? bounds.top - displayObject.height : bounds.top;
		displayObject.y = snapToPixel ? Math.round(y) : y;
	}
}