From c4ffe5fe2b3556f0fcbf6f7a28ef09ce24d06e74 Mon Sep 17 00:00:00 2001
From: xue <>
Date: Sun, 1 Jan 2006 19:48:02 +0000
Subject: Added TDataSourceControl, TDataSourceView, TRepeatInfo.

---
 framework/Web/UI/THtmlWriter.php                   |   5 +
 .../Web/UI/WebControls/TDataSourceControl.php      |  82 +++++
 framework/Web/UI/WebControls/TDataSourceView.php   | 173 +++++++++++
 framework/Web/UI/WebControls/TRepeatInfo.php       | 332 +++++++++++++++++++++
 framework/Web/UI/WebControls/TWebControl.php       |  17 ++
 5 files changed, 609 insertions(+)
 create mode 100644 framework/Web/UI/WebControls/TDataSourceControl.php
 create mode 100644 framework/Web/UI/WebControls/TDataSourceView.php
 create mode 100644 framework/Web/UI/WebControls/TRepeatInfo.php

(limited to 'framework')

diff --git a/framework/Web/UI/THtmlWriter.php b/framework/Web/UI/THtmlWriter.php
index d9c0732b..abfc666c 100644
--- a/framework/Web/UI/THtmlWriter.php
+++ b/framework/Web/UI/THtmlWriter.php
@@ -177,6 +177,11 @@ class THtmlWriter extends TComponent implements ITextWriter
 		$this->_writer->write($str.self::CHAR_NEWLINE);
 	}
 
+	public function writeBreak()
+	{
+		$this->_writer->write('<br/>');
+	}
+
 	public function writeAttribute($name,$value,$encode=false)
 	{
 		$this->_writer->write(' '.$name.='"'.($encode?THttpUtility::htmlEncode($value):$value).'"');
diff --git a/framework/Web/UI/WebControls/TDataSourceControl.php b/framework/Web/UI/WebControls/TDataSourceControl.php
new file mode 100644
index 00000000..6814e872
--- /dev/null
+++ b/framework/Web/UI/WebControls/TDataSourceControl.php
@@ -0,0 +1,82 @@
+<?php
+
+interface IDataSource
+{
+	public function getView($viewName);
+	public function getViewNames();
+	public function onDataSourceChanged($param);
+}
+
+abstract class TDataSourceControl extends TControl implements IDataSource
+{
+	public function getView($viewName);
+
+	public function getViewNames()
+	{
+		return array();
+	}
+
+	protected function onDataSourceChanged($param)
+	{
+		$this->raiseEvent('DataSourceChanged',$this,$param);
+	}
+
+	public function focus()
+	{
+		throw new TNotSupportedException('datasourcecontrol_focus_unsupported');
+	}
+
+	public function getEnableTheming()
+	{
+		return false;
+	}
+
+	public function setEnableTheming($value)
+	{
+		throw new TNotSupportedException('datasourcecontrol_enabletheming_unsupported');
+	}
+
+	public function getSkinID()
+	{
+		return '';
+	}
+
+	public function setSkinID($value)
+	{
+		throw new TNotSupportedException('datasourcecontrol_skinid_unsupported');
+	}
+
+	public function getVisible()
+	{
+		return false;
+	}
+
+	public function setVisible($value)
+	{
+		throw new TNotSupportedException('datasourcecontrol_visible_unsupported');
+	}
+}
+
+class TReadOnlyDataSource extends TDataSourceControl
+{
+	private $_dataSource;
+	private $_dataMember;
+
+	public function __construct($dataSource,$dataMember)
+	{
+		if(!is_array($dataSource) && !($dataSource instanceof IDataSource) && !($dataSource instanceof Traversable))
+			throw new TInvalidDataTypeException('readonlydatasource_datasource_invalid');
+		$this->_dataSource=$dataSource;
+		$this->_dataMember=$dataMember;
+	}
+
+	public function getView($viewName)
+	{
+		if($this->_dataSource instanceof IDataSource)
+			return $this->_dataSource->getView($viewName);
+		else
+			return new TReadOnlyDataSourceView($this,$this->_dataMember,$this->_dataSource);
+	}
+}
+
+?>
\ No newline at end of file
diff --git a/framework/Web/UI/WebControls/TDataSourceView.php b/framework/Web/UI/WebControls/TDataSourceView.php
new file mode 100644
index 00000000..e988af15
--- /dev/null
+++ b/framework/Web/UI/WebControls/TDataSourceView.php
@@ -0,0 +1,173 @@
+<?php
+
+class TDataSourceSelectParameters extends TComponent
+{
+	private $_retrieveTotalRowCount=false;
+	private $_startRowIndex=0;
+	private $_totalRowCount=0;
+	private $_maximumRows=0;
+
+	public function getStartRowIndex()
+	{
+		return $this->_startRowIndex;
+	}
+
+	public function setStartRowIndex($value)
+	{
+		if(($value=TPropertyValue::ensureInteger($value))<0)
+			$value=0;
+		$this->_startRowIndex=$value;
+	}
+
+	public function getMaximumRows()
+	{
+		return $this->_maximumRows;
+	}
+
+	public function setMaximumRows($value)
+	{
+		if(($value=TPropertyValue::ensureInteger($value))<0)
+			$value=0;
+		$this->_maximumRows=$value;
+	}
+
+	public function getRetrieveTotalRowCount()
+	{
+		return $this->_retrieveTotalRowCount;
+	}
+
+	public function setRetrieveTotalRowCount($value)
+	{
+		$this->_retrieveTotalRowCount=TPropertyValue::ensureBoolean($value);
+	}
+
+	public function getTotalRowCount()
+	{
+		return $this->_totalRowCount;
+	}
+
+	public function setTotalRowCount($value)
+	{
+		if(($value=TPropertyValue::ensureInteger($value))<0)
+			$value=0;
+		$this->_totalRowCount=$value;
+	}
+}
+
+abstract class TDataSourceView extends TComponent
+{
+	private $_owner;
+	private $_name;
+
+	public function __construct(IDataSource $owner,$viewName)
+	{
+		$this->_owner=$owner;
+		$this->_name=$viewName;
+	}
+
+	/**
+	 * Performs DB selection based on specified parameters.
+	 * @param ???
+	 * @return Traversable
+	 */
+	public function select($parameters);
+
+	/**
+	 * Inserts a DB record.
+	 * @param array|TMap
+	 * @return integer affected rows
+	 */
+	public function insert($values)
+	{
+		throw new TNotSupportedException('datasourceview_insert_unsupported');
+	}
+
+	/**
+	 * Updates DB record(s) with the specified keys and new values
+	 * @param array|TMap keys for specifying the records to be updated
+	 * @param array|TMap new values
+	 * @return integer affected rows
+	 */
+	public function update($keys,$values)
+	{
+		throw new TNotSupportedException('datasourceview_update_unsupported');
+	}
+
+	/**
+	 * Deletes DB row(s) with the specified keys.
+	 * @param array|TMap keys for specifying the rows to be deleted
+	 * @return integer affected rows
+	 */
+	public function delete($keys)
+	{
+		throw new TNotSupportedException('datasourceview_delete_unsupported');
+	}
+
+	public function getCanDelete()
+	{
+		return false;
+	}
+
+	public function getCanInsert()
+	{
+		return false;
+	}
+
+	public function getCanPage()
+	{
+		return false;
+	}
+
+	public function getCanGetRowCount()
+	{
+		return false;
+	}
+
+	public function getCanSort()
+	{
+		return false;
+	}
+
+	public function getCanUpdate()
+	{
+		return false;
+	}
+
+	public function getName()
+	{
+		return $this->_name;
+	}
+
+	public function getDataSource()
+	{
+		return $this->_owner;
+	}
+
+	protected function onDataSourceViewChanged($param)
+	{
+		$this->raiseEvent('DataSourceViewChanged',$this,$param);
+	}
+}
+
+class TReadOnlyDataSourceView extends TDataSourceView
+{
+	private $_dataSource=null;
+
+	public function __construct(IDataSource $owner,$viewName,$dataSource)
+	{
+		parent::__construct($owner,$viewName);
+		if($dataSource===null || is_array($dataSource))
+			$this->_dataSource=new TMap($dataSource);
+		else if($dataSource instanceof Traversable)
+			$this->_dataSource=$dataSource;
+		else
+			throw new TInvalidDataTypeException('readonlydatasourceview_datasource_invalid');
+	}
+
+	public function select($parameters)
+	{
+		return $this->_dataSource;
+	}
+}
+
+?>
\ No newline at end of file
diff --git a/framework/Web/UI/WebControls/TRepeatInfo.php b/framework/Web/UI/WebControls/TRepeatInfo.php
new file mode 100644
index 00000000..414f5db9
--- /dev/null
+++ b/framework/Web/UI/WebControls/TRepeatInfo.php
@@ -0,0 +1,332 @@
+<?php
+
+interface IRepeatInfoUser
+{
+	public function getItemStyle($itemType,$index);
+	public function renderItem($writer,$repeatInfo,$itemType,$index);
+	public function getHasFooter();
+	public function getHasHeader();
+	public function getHasSeparators();
+	public function getRepeatedItemCount();
+}
+
+class TRepeatInfo extends TComponent
+{
+	private $_caption='';
+	private $_captionAlign='NotSet';
+	private $_repeatColumns=0;
+	private $_repeatDirection='Vertical';
+	private $_repeatLayout='Table';
+
+	public function getCaption()
+	{
+		return $this->_caption;
+	}
+
+	public function setCaption($value)
+	{
+		$this->_caption=$value;
+	}
+
+	public function getCaptionAlign()
+	{
+		return $this->_captionAlign;
+	}
+
+	public function setCaptionAlign($value)
+	{
+		$this->_captionAlign=TPropertyValue::ensureEnum($value,array('NotSet','Top','Bottom','Left','Right'));
+	}
+
+	public function getRepeatColumns()
+	{
+		return $this->_repeatColumns;
+	}
+
+	public function setRepeatColumns($value)
+	{
+		$this->_repeatColumns=TPropertyValue::ensureInteger($value);
+	}
+
+	public function getRepeatDirection()
+	{
+		return $this->_repeatDirection;
+	}
+
+	public function setRepeatDirection($value)
+	{
+		$this->_repeatDirection=TPropertyValue::ensureEnum($value,array('Horizontal','Vertical'));
+	}
+
+	public function getRepeatLayout()
+	{
+		return $this->_repeatLayout;
+	}
+
+	public function setRepeatLayout($value)
+	{
+		$this->_repeatLayout=TPropertyValue::ensureEnum($value,array('Table','Flow'));
+	}
+
+	public function renderRepeater($writer, IRepeatInfoUser $user)
+	{
+		if($this->_repeatLayout==='Table')
+		{
+			$control=new TTable;
+			if($this->_caption!=='')
+			{
+				$control->setCaption($this->_caption);
+				$control->setCaptionAlign($this->_captionAlign);
+			}
+		}
+		else
+			$control=new TWebControl;
+		$control->setID($user->getClientID());
+		$control->copyBaseAttributes($user);
+		if($user->getHasStyle())
+			$control->getStyle()->copyFrom($user->getStyle());
+		$control->renderBeginTag($writer);
+
+		if($this->_repeatDirection==='Vertical')
+			$this->renderVerticalContents($writer,$user);
+		else
+			$this->renderHorizontalContents($writer,$user);
+
+		$control->renderEndTag();
+	}
+
+	protected function renderHorizontalContents($writer,$user)
+	{
+		$tableLayout=($this->_repeatLayout==='Table');
+		$hasSeparators=$user->getHasSeparators();
+		$itemCount=$user->getRepeatedItemCount();
+		$columns=$this->_repeatColumns===0?$itemCount:$this->_repeatColumns;
+		$totalColumns=$hasSeparators?$columns+$columns:$columns;
+		$needBreak=$columns<$itemCount;
+
+		if($user->getHasHeader())
+			$this->renderHeader($writer,$user,$tableLayout,$totalColumns,$needBreak);
+
+		// render items
+		if($tableLayout)
+		{
+			$column=0;
+			for($i=0;$i<$itemCount;++$i)
+			{
+				if($column==0)
+					$writer->renderBeginTag('tr');
+				if(($style=$user->getItemStyle('Item',$i))!==null)
+					$style->addAttributesToRender($writer);
+				$writer->renderBeginTag('td');
+				$user->renderItem($writer,$this,'Item',$i);
+				$writer->renderEndTag();
+				if($hasSeparators && $i!=$itemCount-1)
+				{
+					if(($style=$user->getItemStyle('Separator',$i))!==null)
+						$style->addAttributesToRender($writer);
+					$writer->renderBeginTag('td');
+					$user->renderItem($writer,$this,'Separator',$i);
+					$writer->renderEndTag();
+				}
+				$column++;
+				if($i==$itemCount-1)
+				{
+					$restColumns=$columns-$column;
+					if($hasSeparators)
+						$restColumns=$restColumns?$restColumns+$restColumns+1:1;
+					for($j=0;$j<$restColumns;++$j)
+						$writer->write('<td></td>');
+				}
+				if($column==$columns || $i==$itemCount-1)
+				{
+					$writer->renderEndTag();
+					$column=0;
+				}
+			}
+		}
+		else
+		{
+			$column=0;
+			for($i=0;$i<$itemCount;++$i)
+			{
+				$user->renderItem($writer,$this,'Item',$i);
+				if($hasSeparators && $i!=$itemCount-1)
+					$user->renderItem($writer,$this,'Separator',$i);
+				$column++;
+				if($column==$columns || $i==$itemCount-1)
+				{
+					if($needBreak)
+						$writer->writeBreak();
+					$column=0;
+				}
+			}
+		}
+
+		if($user->getHasFooter())
+			$this->renderFooter($writer,$user,$tableLayout,$totalColumns,$needBreak);
+	}
+
+	protected function renderVerticalContents($writer,$user)
+	{
+		$tableLayout=($this->_repeatLayout==='Table');
+		$hasSeparators=$user->getHasSeparators();
+		$itemCount=$user->getRepeatedItemCount();
+		if($this->_repeatColumns<=1)
+		{
+			$rows=$itemCount;
+			$columns=1;
+			$lastColumns=1;
+		}
+		else
+		{
+			$columns=$this->_repeatColumns;
+			$rows=(int)(($itemCount+$columns-1)/$columns);
+			if($rows==0 && $itemCount>0)
+				$rows=1;
+			if(($lastColumns=$itemCount%$columns)==0)
+				$lastColumns=$columns;
+		}
+		$totalColumns=$hasSeparators?$columns+$columns:$columns;
+
+		if($user->getHasHeader())
+			$this->renderHeader($writer,$user,$tableLayout,$totalColumns,false);
+
+		if($tableLayout)
+		{
+			$renderedItems=0;
+			for($row=0;$row<$rows;++$row)
+			{
+				$index=$row;
+				$writer->renderBeginTag('tr');
+				for($col=0;$col<$columns;++$col)
+				{
+					if($renderedItems>=$itemCount)
+						break;
+					if($col>0)
+					{
+						$index+=$rows;
+						if($col-1>=$lastColumns)
+							$index--;
+					}
+					if($index>=$itemCount)
+						continue;
+					$renderedItems++;
+					if(($style=$user->getItemStyle('Item',$index))!==null)
+						$style->addAttributesToRender($writer);
+					$writer->renderBeginTag('td');
+					$user->renderItem($writer,$this,'Item',$index);
+					$writer->renderEndTag();
+					if(!$hasSeparators)
+						continue;
+					if($renderedItems<$itemCount-1)
+					{
+						if($columns==1)
+						{
+							$writer->renderEndTag();
+							$writer->renderBeginTag('tr');
+						}
+						if(($style=$user->getItemStyle('Separator',$index))!==null)
+							$style->addAttributesToRender($writer);
+						$writer->renderBeginTag('td');
+						$user->renderItem($writer,$this,'Separator',$index);
+						$writer->renderEndTag();
+					}
+					else if($columns>1)
+						$writer->write('<td></td>');
+				}
+				if($row==$rows-1)
+				{
+					$restColumns=$columns-$lastColumns;
+					if($hasSeparators)
+						$restColumns+=$restColumns;
+					for($col=0;$col<$restColumns;++$col)
+						$writer->write('<td></td>');
+				}
+				$writer->renderEndTag();
+			}
+		}
+		else
+		{
+			$renderedItems=0;
+			for($row=0;$row<$rows;++$row)
+			{
+				$index=$row;
+				$writer->renderBeginTag('tr');
+				for($col=0;$col<$columns;++$col)
+				{
+					if($renderedItems>=$itemCount)
+						break;
+					if($col>0)
+					{
+						$index+=$rows;
+						if($col-1>=$lastColumns)
+							$index--;
+					}
+					if($index>=$itemCount)
+						continue;
+					$user->renderItem($writer,$this,'Item',$index);
+					if(!$hasSeparators)
+						continue;
+					if($renderedItems<$itemCount-1)
+					{
+						if($columns==1)
+							$writer->writeBreak();
+						$user->renderItem($writer,$this,'Separator',$index);
+					}
+					else if($columns>1)
+						$writer->write('<td></td>');
+				}
+				if($row<$rows-1 || $user->getHasFooter())
+					$writer->writeBreak();
+			}
+		}
+
+		if($user->getHasFooter())
+			$this->renderFooter($writer,$user,$tableLayout,$totalColumns,false);
+
+	}
+
+	protected function renderHeader($writer,$user,$tableLayout,$columns,$needBreak)
+	{
+		if($tableLayout)
+		{
+			$writer->renderBeginTag('tr');
+			if($columns>1)
+				$writer->addAttribute('colspan',"$columns");
+			$writer->addAttribute('scope','col');
+			if(($style=$user->getItemStyle('Header',-1))!==null)
+				$style->addAttributesToRender($writer);
+			$writer->renderBeginTag('th');
+			$user->renderItem($writer,$this,'Header',-1)
+			$writer->renderEndTag();
+			$writer->renderEndTag();
+		}
+		else
+		{
+			$user->renderItem($writer,$this,'Header',-1)
+			if($needBreak)
+				$writer->writeBreak();
+		}
+	}
+
+	protected function renderFooter($writer,$user,$tableLayout,$columns)
+	{
+		if($tableLayout)
+		{
+			$writer->renderBeginTag('tr');
+			if($columns>1)
+				$writer->addAttribute('colspan',"$columns");
+			$writer->addAttribute('scope','col');
+			if(($style=$user->getItemStyle('Header',-1))!==null)
+				$style->addAttributesToRender($writer);
+			$writer->renderBeginTag('td');
+			$user->renderItem($writer,$this,'Header',-1)
+			$writer->renderEndTag();
+			$writer->renderEndTag();
+		}
+		else
+			$user->renderItem($writer,$this,'Header',-1)
+	}
+}
+
+?>
\ No newline at end of file
diff --git a/framework/Web/UI/WebControls/TWebControl.php b/framework/Web/UI/WebControls/TWebControl.php
index 6e2a2c89..e86b9161 100644
--- a/framework/Web/UI/WebControls/TWebControl.php
+++ b/framework/Web/UI/WebControls/TWebControl.php
@@ -39,6 +39,23 @@ Prado::using('System.Web.UI.WebControls.TStyle');
  */
 class TWebControl extends TControl
 {
+	/**
+	 * Copies basic control attributes from another control.
+	 * Properties including AccessKey, ToolTip, TabIndex, Enabled
+	 * and Attributes are copied.
+	 * @param TWebControl source control
+	 */
+	public function copyBaseAttributes(TWebControl $control)
+	{
+		$this->setAccessKey($control->getAccessKey());
+		$this->setToolTip($control->getToolTip());
+		$this->setTabIndex($control->getTabIndex());
+		if(!$control->getEnabled())
+			$this->setEnabled(false);
+		if($control->getHasAttributes())
+			$this->getAttributes()->copyFrom($control->getAttributes());
+	}
+
 	/**
 	 * @return string the access key of the control
 	 */
-- 
cgit v1.2.3