merge from 3.0 branch till 1374.

5 files changed, 300 insertions, 9 deletions

diff --git a/framework/Web/UI/TClientScriptManager.php b/framework/Web/UI/TClientScriptManager.php
index 3d0ced60..18d6089e 100644
--- a/framework/Web/UI/TClientScriptManager.php
+++ b/framework/Web/UI/TClientScriptManager.php
@@ -133,7 +133,7 @@ class TClientScriptManager extends TApplicationComponent
 				$this->_registeredPradoScripts[$name]=true;
 			else
 				throw new TInvalidOperationException('csmanager_pradoscript_invalid',$name);
-			$basePath=$this->getPradoBaseScriptPath();
+			$basePath=$this->getPradoScriptBasePath();
 			foreach(self::$_pradoScripts[$name] as $script)
 			{
 				if(!isset($this->_publishedPradoFiles[$script]))
@@ -145,7 +145,10 @@ class TClientScriptManager extends TApplicationComponent
 		}
 	}
 
-	protected function getPradoBaseScriptPath()
+	/**
+	 * @return string the directory containing the PRADO js script files
+	 */
+	protected function getPradoScriptBasePath()
 	{
 		$basePath = Prado::getFrameworkPath().'/'.self::SCRIPT_PATH;
 		if($this->getApplication()->getMode()===TApplication::STATE_DEBUG)
@@ -155,15 +158,15 @@ class TClientScriptManager extends TApplicationComponent
 	}
 
 	/**
-	 * Renders the <script> tag that will load the javascript library files.
-	 * @param THtmlWriter writer that renders the <script> tag.
+	 * Renders the HTML tags for PRADO js files
+	 * @param THtmlWriter writer
 	 */
 	protected function renderPradoScripts($writer)
 	{
 		$files=implode(',',array_keys($this->_publishedPradoFiles));
 		if($files!=='')
 		{
-			$basePath=$this->getPradoBaseScriptPath();
+			$basePath=$this->getPradoScriptBasePath();
 			$scriptLoader=$basePath.'/'.self::SCRIPT_LOADER;
 			$url=$this->publishFilePath($scriptLoader).'?js='.trim($files,',');
 			if($this->getApplication()->getMode()===TApplication::STATE_DEBUG)
diff --git a/framework/Web/UI/WebControls/TDataBoundControl.php b/framework/Web/UI/WebControls/TDataBoundControl.php
index 798f9155..38ed42dd 100644
--- a/framework/Web/UI/WebControls/TDataBoundControl.php
+++ b/framework/Web/UI/WebControls/TDataBoundControl.php
@@ -462,6 +462,7 @@ abstract class TDataBoundControl extends TWebControl
 	/**

 	 * Validates if the parameter is a valid data source.

 	 * If it is a string or an array, it will be converted as a TList object.

+	 * @param Traversable|array|string data source to be validated

 	 * @return Traversable the data that is traversable

 	 * @throws TInvalidDataTypeException if the data is neither null nor Traversable

 	 */

diff --git a/framework/Web/UI/WebControls/TDatePicker.php b/framework/Web/UI/WebControls/TDatePicker.php
index 02361e54..2a9340e5 100644
--- a/framework/Web/UI/WebControls/TDatePicker.php
+++ b/framework/Web/UI/WebControls/TDatePicker.php
@@ -263,14 +263,15 @@ class TDatePicker extends TTextBox
 

 	/**

 	 * Sets the date for the date picker using timestamp.

-	 * @param integer time stamp for the date picker

+	 * @param float time stamp for the date picker

 	 */

 	public function setTimeStamp($value)

 	{

-		$date = TPropertyValue::ensureInteger($value);

+		$date = TPropertyValue::ensureFloat($value);

 		$formatter = Prado::createComponent('System.Util.TSimpleDateFormatter',

 						$this->getDateFormat());

-		$this->setText($formatter->format($date));

+						$d =$formatter->format($date);

+		$this->setText($d);

 	}

 

 	/**

diff --git a/framework/Web/UI/WebControls/TDropDownListColumn.php b/framework/Web/UI/WebControls/TDropDownListColumn.php
new file mode 100644
index 00000000..bcbd87e4
--- /dev/null
+++ b/framework/Web/UI/WebControls/TDropDownListColumn.php
@@ -0,0 +1,286 @@
+<?php

+/**

+ * TDropDownListColumn class file

+ *

+ * @author Qiang Xue <qiang.xue@gmail.com>

+ * @link http://www.pradosoft.com/

+ * @copyright Copyright &copy; 2006 PradoSoft

+ * @license http://www.pradosoft.com/license/

+ * @version $Revision: $  $Date: $

+ * @package System.Web.UI.WebControls

+ */

+

+Prado::using('System.Web.UI.WebControls.TDataGridColumn');

+Prado::using('System.Web.UI.WebControls.TDropDownList');

+

+/**

+ * TDropDownListColumn class

+ *

+ * TDropDownListColumn represents a column that is bound to a field in a data source.

+ * The cells in the column will be displayed using the data indexed by

+ * {@link setDataField DataField}. You can customize the display by

+ * setting {@link setDataFormatString DataFormatString}.

+ *

+ * If {@link setReadOnly ReadOnly} is false, TDropDownListColumn will display cells in edit mode

+ * with dropdown lists. Otherwise, a static text is displayed.

+ *

+ * There are two approaches to specify the list items available for selection.

+ * The first approach uses template syntax as follows,

+ * <code>

+ *   <com:TDropDownListColumn ....>

+ *     <com:TListItem Value="1" Text="first item" />

+ *     <com:TListItem Value="2" Text="second item" />

+ *     <com:TListItem Value="3" Text="third item" />

+ *   </com:TDropDownListColumn>

+ * </code>

+ * The second approach specifies a data source to be bound to the dropdown lists

+ * by setting {@link setListDataSource ListDataSource}. Like generic list controls,

+ * you may also want to specify which data fields are used for item values and texts

+ * by setting {@link setListValueField ListValueField} and

+ * {@link setListTextField ListTextField}, respectively.

+ * Furthermore, the item texts may be formatted by using {@link setListTextFormatString ListTextFormatString}.

+ * Note, if you specify {@link setListDataSource ListDataSource}, do it before

+ * calling the datagrid's dataBind().

+ *

+ * The dropdown list control in the TDropDownListColumn can be accessed by one of

+ * the following two methods:

+ * <code>

+ * $datagridItem->DropDownListColumnID->DropDownList

+ * $datagridItem->DropDownListColumnID->Controls[0]

+ * </code>

+ * The second method is possible because the dropdown list control created within the

+ * datagrid cell is the first child.

+ *

+ * @author Qiang Xue <qiang.xue@gmail.com>

+ * @version $Revision: $  $Date: $

+ * @package System.Web.UI.WebControls

+ * @since 3.0.4

+ */

+class TDropDownListColumn extends TDataGridColumn

+{

+	private $_stateLoaded=false;

+	private $_dataBound=false;

+	private $_listControl=null;

+

+	public function __construct()

+	{

+		$this->_listControl=new TDropDownList;

+	}

+

+	/**

+	 * Loads items from viewstate.

+	 * This method overrides the parent implementation by loading list items

+	 * @param mixed state values

+	 */

+	public function loadState($state)

+	{

+		parent::loadState($state);

+		$this->_stateLoaded=true;

+		if(!$this->_dataBound)

+			$this->_listControl->getItems()->loadState($this->getViewState('Items',null));

+	}

+

+	/**

+	 * Saves items into viewstate.

+	 * This method overrides the parent implementation by saving list items

+	 */

+	public function saveState()

+	{

+		$this->setViewState('Items',$this->_listControl->getItems()->saveState(),null);

+		return parent::saveState();

+	}

+

+	/**

+	 * Adds object parsed from template to the control.

+	 * This method adds only {@link TListItem} objects into the {@link getItems Items} collection.

+	 * All other objects are ignored.

+	 * @param mixed object parsed from template

+	 */

+	public function addParsedObject($object)

+	{

+		// Do not add items from template if items are loaded from viewstate

+		if(!$this->_stateLoaded && ($object instanceof TListItem))

+		{

+			$object->setSelected(false);

+			$index=$this->_listControl->getItems()->add($object);

+		}

+	}

+

+	/**

+	 * @return string the field name from the data source to bind to the column

+	 */

+	public function getDataField()

+	{

+		return $this->getViewState('DataField','');

+	}

+

+	/**

+	 * @param string the field name from the data source to bind to the column

+	 */

+	public function setDataField($value)

+	{

+		$this->setViewState('DataField',$value,'');

+	}

+

+	/**

+	 * @return string the formatting string used to control how the bound data will be displayed.

+	 */

+	public function getDataFormatString()

+	{

+		return $this->getViewState('DataFormatString','');

+	}

+

+	/**

+	 * @param string the formatting string used to control how the bound data will be displayed.

+	 */

+	public function setDataFormatString($value)

+	{

+		$this->setViewState('DataFormatString',$value,'');

+	}

+

+	/**

+	 * @return boolean whether the items in the column can be edited. Defaults to false.

+	 */

+	public function getReadOnly()

+	{

+		return $this->getViewState('ReadOnly',false);

+	}

+

+	/**

+	 * @param boolean whether the items in the column can be edited

+	 */

+	public function setReadOnly($value)

+	{

+		$this->setViewState('ReadOnly',TPropertyValue::ensureBoolean($value),false);

+	}

+

+	/**

+	 * @return Traversable data source to be bound to the dropdown list boxes.

+	 */

+	public function getListDataSource()

+	{

+		return $this->_listControl->getDataSource();

+	}

+

+	/**

+	 * @param Traversable|array|string data source to be bound to the dropdown list boxes.

+	 */

+	public function setListDataSource($value)

+	{

+		$this->_listControl->setDataSource($value);

+	}

+

+	/**

+	 * @return string the data field used to populate the values of the dropdown list items. Defaults to empty.

+	 */

+	public function getListValueField()

+	{

+		return $this->getViewState('ListValueField','');

+	}

+

+	/**

+	 * @param string the data field used to populate the values of the dropdown list items

+	 */

+	public function setListValueField($value)

+	{

+		$this->setViewState('ListValueField',$value,'');

+	}

+

+	/**

+	 * @return string the data field used to populate the texts of the dropdown list items. Defaults to empty.

+	 */

+	public function getListTextField()

+	{

+		return $this->getViewState('ListTextField','');

+	}

+

+	/**

+	 * @param string the data field used to populate the texts of the dropdown list items

+	 */

+	public function setListTextField($value)

+	{

+		$this->setViewState('ListTextField',$value,'');

+	}

+

+	/**

+	 * @return string the formatting string used to control how the list item texts will be displayed.

+	 */

+	public function getListTextFormatString()

+	{

+		return $this->getViewState('ListTextFormatString','');

+	}

+

+	/**

+	 * @param string the formatting string used to control how the list item texts will be displayed.

+	 */

+	public function setListTextFormatString($value)

+	{

+		$this->setViewState('ListTextFormatString',$value,'');

+	}

+

+	/**

+	 * Initializes the specified cell to its initial values.

+	 * This method overrides the parent implementation.

+	 * It creates a textbox for item in edit mode and the column is not read-only.

+	 * Otherwise it displays a static text.

+	 * The caption of the button and the static text are retrieved

+	 * from the datasource.

+	 * @param TTableCell the cell to be initialized.

+	 * @param integer the index to the Columns property that the cell resides in.

+	 * @param string the type of cell (Header,Footer,Item,AlternatingItem,EditItem,SelectedItem)

+	 */

+	public function initializeCell($cell,$columnIndex,$itemType)

+	{

+		parent::initializeCell($cell,$columnIndex,$itemType);

+		if(!$this->_dataBound && $this->_listControl->getDataSource()!==null)

+		{

+			$this->_listControl->setDataTextField($this->getListTextField());

+			$this->_listControl->setDataValueField($this->getListValueField());

+			$this->_listControl->setDataTextFormatString($this->getListTextFormatString());

+			$this->_listControl->dataBind();

+			$this->_dataBound=true;

+		}

+		switch($itemType)

+		{

+			case TDataGrid::IT_EDITITEM:

+				if(!$this->getReadOnly())

+				{

+					$listControl=clone $this->_listControl;

+					$cell->getControls()->add($listControl);

+					$cell->registerObject('DropDownList',$listControl);

+					$control=$listControl;

+				}

+				else

+					$control=$cell;

+				$control->attachEventHandler('OnDataBinding',array($this,'dataBindColumn'));

+				break;

+			case TDataGrid::IT_ITEM:

+			case TDataGrid::IT_ALTERNATINGITEM:

+			case TDataGrid::IT_SELECTEDITEM:

+				if($this->getDataField()!=='')

+					$cell->attachEventHandler('OnDataBinding',array($this,'dataBindColumn'));

+				break;

+		}

+	}

+

+	/**

+	 * Databinds a cell in the column.

+	 * This method is invoked when datagrid performs databinding.

+	 * It populates the content of the cell with the relevant data from data source.

+	 */

+	public function dataBindColumn($sender,$param)

+	{

+		$item=$sender->getNamingContainer();

+		$data=$item->getDataItem();

+		if(($field=$this->getDataField())!=='')

+			$data=$this->getDataFieldValue($data,$field);

+		$formatString=$this->getDataFormatString();

+		$value=$this->formatDataValue($formatString,$data);

+		if($sender instanceof TTableCell)

+			$sender->setText($value);

+		else if($sender instanceof TDropDownList)

+			$sender->setSelectedValue($data);

+	}

+}

+

+?>
\ No newline at end of file
diff --git a/framework/Web/UI/WebControls/TStyleSheet.php b/framework/Web/UI/WebControls/TStyleSheet.php
index 3e172697..f8f4ab9f 100644
--- a/framework/Web/UI/WebControls/TStyleSheet.php
+++ b/framework/Web/UI/WebControls/TStyleSheet.php
@@ -24,7 +24,7 @@
  *
  * @author Wei Zhuo <weizhuo[at]gmail[dot]com>
  * @version : $  Tue Jul  4 04:38:16 EST 2006 $
- * @package System.Web.UI.WebControl
+ * @package System.Web.UI.WebControls
  * @since 3.0.2
  */
 class TStyleSheet extends TControl