Replace one display object for another one.

replace.as

package rinaldi.display
{

	/**
	 *
	 * Replace one display object for another one.
	 *
	 * @param					p_scope					Scope of the items.
	 * @param					p_oldObject				Object to be replaced.
	 * @param					p_newObject				New object to replace the old object.
	 * @return											The new object placed.
	 *
	 * @see rinaldi.display
	 *
	 * @date 30/09/2010
	 * @author Rafael Rinaldi (rafaelrinaldi.com)
	 *
	 */

	public function replace( p_scope : Object, p_oldObject : Object, p_newObject : Object ) : Object
	{
		if(p_oldObject != null && p_scope["contains"](p_oldObject)) {
			p_scope["removeChild"](p_oldObject);
			p_oldObject = null;
		}

		if(p_newObject == null) return null;

		return p_scope["addChild"](p_newObject);
	}
}