<?php
/*=====================================================================*
|| ###################################################################
|| # Blue Static ISSO Framework
|| # Copyright (c)2005-2008 Blue Static
|| #
|| # This program is free software; you can redistribute it and/or modify
|| # it under the terms of the GNU General Public License as published by
|| # the Free Software Foundation; version 2 of the License.
|| #
|| # This program is distributed in the hope that it will be useful, but
|| # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|| # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|| # more details.
|| #
|| # You should have received a copy of the GNU General Public License along
|| # with this program; if not, write to the Free Software Foundation, Inc.,
|| # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
|| ###################################################################
\*=====================================================================*/

/**
* Printer Root Element (PrinterRootAbstract.php)
*
* @package	ISSO
*/

require_once(ISSO . '/PrinterAbstract.php');

/**
* Printer Root Element
*
* This is a root element class. That means that elements can be printed
* directly into this and this can stand alone as a page. However, that
* does not mean that all root elements produce valid XHTML.
*
* @author		Blue Static
* @copyright	Copyright (c)2005 - 2008, Blue Static
* @package		ISSO
*
*/
abstract class BSPrinterRootAbstract extends BSPrinterAbstract
{
	/**
	* Child elements
	* @var string
	*/
	protected $children = array();
	
	/**
	* Returns all of the children painted in the right order
	*/
	protected abstract function _paintChildren();
	
	// ###################################################################
	/**
	* Adds a child node to the element
	*
	* @param	BSPrinterAbstract	A child element
	* 
	* @return	fluent interface
	*/
	public function addChild(BSPrinterAbstract $child)
	{
		$this->children[] = $child;
		return $this;
	}
}

?>