Gecko [ ifk.uw.edu.pl ]

Name	Size	Permission
assets	[ DIR ]	drwxr-xr-x
TAccordion.php	20.81 KB	-rw-r--r--
TBaseDataList.php	5.11 KB	-rw-r--r--
TBaseValidator.php	22.48 KB	-rw-r--r--
TBoundColumn.php	7.67 KB	-rw-r--r--
TBulletedList.php	13.77 KB	-rw-r--r--
TButton.php	10.75 KB	-rw-r--r--
TButtonColumn.php	8.35 KB	-rw-r--r--
TCaptcha.php	15.89 KB	-rw-r--r--
TCaptchaValidator.php	3.99 KB	-rw-r--r--
TCheckBox.php	14.67 KB	-rw-r--r--
TCheckBoxColumn.php	3.74 KB	-rw-r--r--
TCheckBoxList.php	13.88 KB	-rw-r--r--
TClientScript.php	4.36 KB	-rw-r--r--
TColorPicker.php	7.89 KB	-rw-r--r--
TCompareValidator.php	8.06 KB	-rw-r--r--
TConditional.php	4.15 KB	-rw-r--r--
TContent.php	1.56 KB	-rw-r--r--
TContentPlaceHolder.php	1.7 KB	-rw-r--r--
TCustomValidator.php	5.55 KB	-rw-r--r--
TDataBoundControl.php	16.99 KB	-rw-r--r--
TDataGrid.php	60.98 KB	-rw-r--r--
TDataGridColumn.php	17.16 KB	-rw-r--r--
TDataGridItemRenderer.php	715 B	-rw-r--r--
TDataGridPagerStyle.php	6 KB	-rw-r--r--
TDataList.php	51.13 KB	-rw-r--r--
TDataListItemRenderer.php	4.58 KB	-rw-r--r--
TDataRenderer.php	1.11 KB	-rw-r--r--
TDataSourceControl.php	2.39 KB	-rw-r--r--
TDataSourceView.php	3.97 KB	-rw-r--r--
TDataTypeValidator.php	3.92 KB	-rw-r--r--
TDatePicker.php	28.5 KB	-rw-r--r--
TDropDownList.php	4.53 KB	-rw-r--r--
TDropDownListColumn.php	9.92 KB	-rw-r--r--
TEditCommandColumn.php	7.95 KB	-rw-r--r--
TEmailAddressValidator.php	2.79 KB	-rw-r--r--
TExpression.php	1.42 KB	-rw-r--r--
TFileUpload.php	8.11 KB	-rw-r--r--
TFlushOutput.php	2.17 KB	-rw-r--r--
TFont.php	7.76 KB	-rw-r--r--
THead.php	9.05 KB	-rw-r--r--
THeader1.php	738 B	-rw-r--r--
THeader2.php	738 B	-rw-r--r--
THeader3.php	738 B	-rw-r--r--
THeader4.php	737 B	-rw-r--r--
THeader5.php	737 B	-rw-r--r--
THeader6.php	737 B	-rw-r--r--
THiddenField.php	5.62 KB	-rw-r--r--
THtmlArea.php	13.83 KB	-rw-r--r--
THtmlArea4.php	12.29 KB	-rw-r--r--
THtmlElement.php	1.67 KB	-rw-r--r--
THyperLink.php	6.53 KB	-rw-r--r--
THyperLinkColumn.php	7.6 KB	-rw-r--r--
TImage.php	3.9 KB	-rw-r--r--
TImageButton.php	12.71 KB	-rw-r--r--
TImageMap.php	21.65 KB	-rw-r--r--
TInlineFrame.php	7.54 KB	-rw-r--r--
TItemDataRenderer.php	2.28 KB	-rw-r--r--
TJavascriptLogger.php	2.76 KB	-rw-r--r--
TKeyboard.php	5.76 KB	-rw-r--r--
TLabel.php	3.73 KB	-rw-r--r--
TLinkButton.php	10.11 KB	-rw-r--r--
TListBox.php	6.92 KB	-rw-r--r--
TListControl.php	25.02 KB	-rw-r--r--
TListControlValidator.php	5.8 KB	-rw-r--r--
TListItem.php	3.9 KB	-rw-r--r--
TLiteral.php	2.7 KB	-rw-r--r--
TLiteralColumn.php	4.01 KB	-rw-r--r--
TMarkdown.php	2.19 KB	-rw-r--r--
TMultiView.php	10.47 KB	-rw-r--r--
TOutputCache.php	18.47 KB	-rw-r--r--
TPager.php	23.23 KB	-rw-r--r--
TPanel.php	6.27 KB	-rw-r--r--
TPanelStyle.php	7.46 KB	-rw-r--r--
TPlaceHolder.php	663 B	-rw-r--r--
TRadioButton.php	9.58 KB	-rw-r--r--
TRadioButtonList.php	2.46 KB	-rw-r--r--
TRangeValidator.php	10.04 KB	-rw-r--r--
TRatingList.php	8.54 KB	-rw-r--r--
TReCaptcha.php	8.2 KB	-rw-r--r--
TReCaptchaValidator.php	4.4 KB	-rw-r--r--
TRegularExpressionValidator.ph...	4.26 KB	-rw-r--r--
TRepeatInfo.php	14.91 KB	-rw-r--r--
TRepeater.php	29.17 KB	-rw-r--r--
TRepeaterItemRenderer.php	1.36 KB	-rw-r--r--
TRequiredFieldValidator.php	4.63 KB	-rw-r--r--
TSafeHtml.php	2.67 KB	-rw-r--r--
TSlider.php	16.62 KB	-rw-r--r--
TStatements.php	1.45 KB	-rw-r--r--
TStyle.php	21.9 KB	-rw-r--r--
TStyleSheet.php	2.54 KB	-rw-r--r--
TTabPanel.php	20.07 KB	-rw-r--r--
TTable.php	10.15 KB	-rw-r--r--
TTableCell.php	5.58 KB	-rw-r--r--
TTableFooterRow.php	977 B	-rw-r--r--
TTableHeaderCell.php	2.83 KB	-rw-r--r--
TTableHeaderRow.php	977 B	-rw-r--r--
TTableRow.php	5.06 KB	-rw-r--r--
TTemplateColumn.php	7.49 KB	-rw-r--r--
TTextBox.php	18.88 KB	-rw-r--r--
TTextHighlighter.php	5.75 KB	-rw-r--r--
TTextProcessor.php	2.19 KB	-rw-r--r--
TValidationSummary.php	15.16 KB	-rw-r--r--
TWebControl.php	12.36 KB	-rw-r--r--
TWebControlAdapter.php	1.88 KB	-rw-r--r--
TWebControlDecorator.php	10.62 KB	-rw-r--r--
TWizard.php	58.25 KB	-rw-r--r--
TWizardNavigationButtonStyle.p...	3.85 KB	-rw-r--r--
TXmlTransform.php	5.71 KB	-rw-r--r--

Code Editor : TDataBoundControl.php

<?php
/**
 * TDataBoundControl class file
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @link http://www.pradosoft.com/
 * @copyright Copyright &copy; 2005-2014 PradoSoft
 * @license http://www.pradosoft.com/license/
 * @package System.Web.UI.WebControls
 */

Prado::using('System.Web.UI.WebControls.TDataSourceControl');
Prado::using('System.Web.UI.WebControls.TDataSourceView');
Prado::using('System.Collections.TPagedDataSource');

/**
 * TDataBoundControl class.
 *
 * TDataBoundControl is the based class for controls that need to populate
 * data from data sources. It provides basic properties and methods that allow
 * the derived controls to associate with data sources and retrieve data from them.
 *
 * TBC....
 *
 * TDataBoundControl is equipped with paging capabilities. By setting
 * {@link setAllowPaging AllowPaging} to true, the input data will be paged
 * and only one page of data is actually populated into the data-bound control.
 * This saves a lot of memory when dealing with larget datasets.
 *
 * To specify the number of data items displayed on each page, set
 * the {@link setPageSize PageSize} property, and to specify which
 * page of data to be displayed, set {@link setCurrentPageIndex CurrentPageIndex}.
 *
 * When the size of the original data is too big to be loaded all in the memory,
 * one can enable custom paging. In custom paging, the total number of data items
 * is specified manually via {@link setVirtualItemCount VirtualItemCount},
 * and the data source only needs to contain the current page of data. To enable
 * custom paging, set {@link setAllowCustomPaging AllowCustomPaging} to true.
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @package System.Web.UI.WebControls
 * @since 3.0
 */
abstract class TDataBoundControl extends TWebControl
{
	private $_initialized=false;
	private $_dataSource=null;
	private $_requiresBindToNull=false;
	private $_requiresDataBinding=false;
	private $_prerendered=false;
	private $_currentView=null;
	private $_currentDataSource=null;
	private $_currentViewValid=false;
	private $_currentDataSourceValid=false;
	private $_currentViewIsFromDataSourceID=false;
	private $_parameters=null;
	private $_isDataBound=false;

/**
	 * @return Traversable data source object, defaults to null.
	 */
	public function getDataSource()
	{
		return $this->_dataSource;
	}

/**
	 * Sets the data source object associated with the databound control.
	 * The data source must implement Traversable interface.
	 * If an array is given, it will be converted to xxx.
	 * If a string is given, it will be converted to xxx.
	 * @param Traversable|array|string data source object
	 */
	public function setDataSource($value)
	{
		$this->_dataSource=$this->validateDataSource($value);
		$this->onDataSourceChanged();
	}

/**
	 * @return string ID path to the data source control. Defaults to empty.
	 */
	public function getDataSourceID()
	{
		return $this->getViewState('DataSourceID','');
	}

/**
	 * @param string ID path to the data source control. The data source
	 * control must be locatable via {@link TControl::findControl} call.
	 */
	public function setDataSourceID($value)
	{
		$dsid=$this->getViewState('DataSourceID','');
		if($dsid!=='' && $value==='')
			$this->_requiresBindToNull=true;
		$this->setViewState('DataSourceID',$value,'');
		$this->onDataSourceChanged();
	}

/**
	 * @return boolean if the databound control uses the data source specified
	 * by {@link setDataSourceID}, or it uses the data source object specified
	 * by {@link setDataSource}.
	 */
	protected function getUsingDataSourceID()
	{
		return $this->getDataSourceID()!=='';
	}

/**
	 * Sets {@link setRequiresDataBinding RequiresDataBinding} as true if the control is initialized.
	 * This method is invoked when either {@link setDataSource} or {@link setDataSourceID} is changed.
	 */
	public function onDataSourceChanged()
	{
		$this->_currentViewValid=false;
		$this->_currentDataSourceValid=false;
		if($this->getInitialized())
			$this->setRequiresDataBinding(true);
	}

/**
	 * @return boolean whether the databound control has been initialized.
	 * By default, the control is initialized after its viewstate has been restored.
	 */
	protected function getInitialized()
	{
		return $this->_initialized;
	}

/**
	 * Sets a value indicating whether the databound control is initialized.
	 * If initialized, any modification to {@link setDataSource DataSource} or
	 * {@link setDataSourceID DataSourceID} will set {@link setRequiresDataBinding RequiresDataBinding}
	 * as true.
	 * @param boolean a value indicating whether the databound control is initialized.
	 */
	protected function setInitialized($value)
	{
		$this->_initialized=TPropertyValue::ensureBoolean($value);
	}

/**
	 * @return boolean whether databind has been invoked in the previous page request
	 */
	protected function getIsDataBound()
	{
		return $this->_isDataBound;
	}

/**
	 * @param boolean if databind has been invoked in this page request
	 */
	protected function setIsDataBound($value)
	{
		$this->_isDataBound=$value;
	}

/**
	 * @return boolean whether a databind call is required (by the data bound control)
	 */
	protected function getRequiresDataBinding()
	{
		return $this->_requiresDataBinding;
	}

/**
	 * @return boolean whether paging is enabled. Defaults to false.
	 */
	public function getAllowPaging()
	{
		return $this->getViewState('AllowPaging',false);
	}

/**
	 * @param boolean whether paging is enabled
	 */
	public function setAllowPaging($value)
	{
		$this->setViewState('AllowPaging',TPropertyValue::ensureBoolean($value),false);
	}

/**
	 * @return boolean whether the custom paging is enabled. Defaults to false.
	 */
	public function getAllowCustomPaging()
	{
		return $this->getViewState('AllowCustomPaging',false);
	}

/**
	 * Sets a value indicating whether the custom paging should be enabled.
	 * When the pager is in custom paging mode, the {@link setVirtualItemCount VirtualItemCount}
	 * property is used to determine the paging, and the data items in the
	 * {@link setDataSource DataSource} are considered to be in the current page.
	 * @param boolean whether the custom paging is enabled
	 */
	public function setAllowCustomPaging($value)
	{
		$this->setViewState('AllowCustomPaging',TPropertyValue::ensureBoolean($value),false);
	}

/**
	 * @return integer the zero-based index of the current page. Defaults to 0.
	 */
	public function getCurrentPageIndex()
	{
		return $this->getViewState('CurrentPageIndex',0);
	}

/**
	 * @param integer the zero-based index of the current page
	 * @throws TInvalidDataValueException if the value is less than 0
	 */
	public function setCurrentPageIndex($value)
	{
		if(($value=TPropertyValue::ensureInteger($value))<0)
			$value=0;
		$this->setViewState('CurrentPageIndex',$value,0);
	}

/**
	 * @return integer the number of data items on each page. Defaults to 10.
	 */
	public function getPageSize()
	{
		return $this->getViewState('PageSize',10);
	}

/**
	 * @param integer the number of data items on each page.
	 * @throws TInvalidDataValueException if the value is less than 1
	 */
	public function setPageSize($value)
	{
		if(($value=TPropertyValue::ensureInteger($value))<1)
			throw new TInvalidDataValueException('databoundcontrol_pagesize_invalid',get_class($this));
		$this->setViewState('PageSize',TPropertyValue::ensureInteger($value),10);
	}

/**
	 * @return integer number of pages of data items available
	 */
	public function getPageCount()
	{
		return $this->getViewState('PageCount',1);
	}

/**
	 * @return integer virtual number of data items in the data source. Defaults to 0.
	 * @see setAllowCustomPaging
	 */
	public function getVirtualItemCount()
	{
		return $this->getViewState('VirtualItemCount',0);
	}

/**
	 * @param integer virtual number of data items in the data source.
	 * @throws TInvalidDataValueException if the value is less than 0
	 * @see setAllowCustomPaging
	 */
	public function setVirtualItemCount($value)
	{
		if(($value=TPropertyValue::ensureInteger($value))<0)
			throw new TInvalidDataValueException('databoundcontrol_virtualitemcount_invalid',get_class($this));
		$this->setViewState('VirtualItemCount',$value,0);
	}

/**
	 * Sets a value indicating whether a databind call is required by the data bound control.
	 * If true and the control has been prerendered while it uses the data source
	 * specified by {@link setDataSourceID}, a databind call will be called by this method.
	 * @param boolean whether a databind call is required.
	 */
	protected function setRequiresDataBinding($value)
	{
		$value=TPropertyValue::ensureBoolean($value);
		if($value && $this->_prerendered)
		{
			$this->_requiresDataBinding=true;
			$this->ensureDataBound();
		}
		else
			$this->_requiresDataBinding=$value;
	}

/**
	 * Ensures any pending {@link dataBind} is called.
	 * This method calls {@link dataBind} if the data source is specified
	 * by {@link setDataSourceID} or if {@link getRequiresDataBinding RequiresDataBinding}
	 * is true.
	 */
	protected function ensureDataBound()
	{
		if($this->_requiresDataBinding && ($this->getUsingDataSourceID() || $this->_requiresBindToNull))
		{
			$this->dataBind();
			$this->_requiresBindToNull=false;
		}
	}

/**
	 * @return TPagedDataSource creates a paged data source
	 */
	protected function createPagedDataSource()
	{
		$ds=new TPagedDataSource;
		$ds->setCurrentPageIndex($this->getCurrentPageIndex());
		$ds->setPageSize($this->getPageSize());
		$ds->setAllowPaging($this->getAllowPaging());
		$ds->setAllowCustomPaging($this->getAllowCustomPaging());
		$ds->setVirtualItemCount($this->getVirtualItemCount());
		return $ds;
	}

/**
	 * Performs databinding.
	 * This method overrides the parent implementation by calling
	 * {@link performSelect} which fetches data from data source and does
	 * the actual binding work.
	 */
	public function dataBind()
	{
		$this->setRequiresDataBinding(false);
		$this->dataBindProperties();
		$this->onDataBinding(null);

if(($view=$this->getDataSourceView())!==null)
			$data=$view->select($this->getSelectParameters());
		else
			$data=null;

if($data instanceof Traversable)
		{
			if($this->getAllowPaging())
			{
				$ds=$this->createPagedDataSource();
				$ds->setDataSource($data);
				$this->setViewState('PageCount',$ds->getPageCount());
				if($ds->getCurrentPageIndex()>=$ds->getPageCount())
				{
					$ds->setCurrentPageIndex($ds->getPageCount()-1);
					$this->setCurrentPageIndex($ds->getCurrentPageIndex());
				}
				$this->performDataBinding($ds);
			}
			else
			{
				$this->clearViewState('PageCount');
				$this->performDataBinding($data);
			}
		}
		$this->setIsDataBound(true);
		$this->onDataBound(null);
	}

public function dataSourceViewChanged($sender,$param)
	{
		if(!$this->_ignoreDataSourceViewChanged)
			$this->setRequiresDataBinding(true);
	}

protected function getDataSourceView()
	{
		if(!$this->_currentViewValid)
		{
			if($this->_currentView && $this->_currentViewIsFromDataSourceID)
				$this->_currentView->detachEventHandler('DataSourceViewChanged',array($this,'dataSourceViewChanged'));
			if(($dataSource=$this->determineDataSource())!==null)
			{
				if(($view=$dataSource->getView($this->getDataMember()))===null)
					throw new TInvalidDataValueException('databoundcontrol_datamember_invalid',$this->getDataMember());
				if($this->_currentViewIsFromDataSourceID=$this->getUsingDataSourceID())
					$view->attachEventHandler('OnDataSourceViewChanged',array($this,'dataSourceViewChanged'));
				$this->_currentView=$view;
			}
			else
				$this->_currentView=null;
			$this->_currentViewValid=true;
		}
		return $this->_currentView;
	}

protected function determineDataSource()
	{
		if(!$this->_currentDataSourceValid)
		{
			if(($dsid=$this->getDataSourceID())!=='')
			{
				if(($dataSource=$this->getNamingContainer()->findControl($dsid))===null)
					throw new TInvalidDataValueException('databoundcontrol_datasourceid_inexistent',$dsid);
				else if(!($dataSource instanceof IDataSource))
					throw new TInvalidDataValueException('databoundcontrol_datasourceid_invalid',$dsid);
				else
					$this->_currentDataSource=$dataSource;
			}
			else if(($dataSource=$this->getDataSource())!==null)
				$this->_currentDataSource=new TReadOnlyDataSource($dataSource,$this->getDataMember());
			else
				$this->_currentDataSource=null;
			$this->_currentDataSourceValid=true;
		}
		return $this->_currentDataSource;
	}

abstract protected function performDataBinding($data);

/**
	 * Raises OnDataBound event.
	 * This method should be invoked after a databind is performed.
	 * It is mainly used by framework and component developers.
	 */
	public function onDataBound($param)
	{
		$this->raiseEvent('OnDataBound',$this,$param);
	}

/**
	 * Sets page's OnPreLoad event handler as {@link pagePreLoad}.
	 * If viewstate is disabled and the current request is a postback,
	 * {@link setRequiresDataBinding RequiresDataBinding} will be set true.
	 * This method overrides the parent implementation.
	 * @param TEventParameter event parameter
	 */
	public function onInit($param)
	{
		parent::onInit($param);
		$page=$this->getPage();
		$page->attachEventHandler('OnPreLoad',array($this,'pagePreLoad'));
	}

/**
	 * Sets {@link getInitialized} as true.
	 * This method is invoked when page raises PreLoad event.
	 * @param mixed event sender
	 * @param TEventParameter event parameter
	 */
	public function pagePreLoad($sender,$param)
	{
		$this->_initialized=true;
		$isPostBack=$this->getPage()->getIsPostBack();
		if(!$isPostBack || ($isPostBack && (!$this->getEnableViewState(true) || !$this->getIsDataBound())))
			$this->setRequiresDataBinding(true);
	}

/**
	 * Ensures any pending databind is performed.
	 * This method overrides the parent implementation.
	 * @param TEventParameter event parameter
	 */
	public function onPreRender($param)
	{
		$this->_prerendered=true;
		$this->ensureDataBound();
		parent::onPreRender($param);
	}

/**
	 * 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
	 */
	protected function validateDataSource($value)
	{
		if(is_string($value))
		{
			$list=new TList;
			foreach(TPropertyValue::ensureArray($value) as $key=>$value)
			{
				if(is_array($value))
					$list->add($value);
				else
					$list->add(array($value,is_string($key)?$key:$value));
			}
			return $list;
		}
		else if(is_array($value))
			return new TMap($value);
		else if($value instanceof TDbDataReader) {
			// read array from TDbDataReader since it's forward-only stream and can only be traversed once
			return $value->readAll();
		}
		else if(($value instanceof Traversable) || $value===null)
			return $value;
		else
			throw new TInvalidDataTypeException('databoundcontrol_datasource_invalid',get_class($this));
	}

public function getDataMember()
	{
		return $this->getViewState('DataMember','');
	}

public function setDataMember($value)
	{
		$this->setViewState('DataMember',$value,'');
	}

public function getSelectParameters()
	{
		if(!$this->_parameters)
			$this->_parameters=new TDataSourceSelectParameters;
		return $this->_parameters;
	}
}

/**
 * TListItemType class.
 * TListItemType defines the enumerable type for the possible types
 * that databound list items could take.
 *
 * The following enumerable values are defined:
 * - Header: header item
 * - Footer: footer item
 * - Item: content item (neither header nor footer)
 * - Separator: separator between items
 * - AlternatingItem: alternating content item
 * - EditItem: content item in edit mode
 * - SelectedItem: selected content item
 * - Pager: pager
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @package System.Web.UI.WebControls
 * @since 3.0.4
 */
class TListItemType extends TEnumerable
{
	const Header='Header';
	const Footer='Footer';
	const Item='Item';
	const Separator='Separator';
	const AlternatingItem='AlternatingItem';
	const EditItem='EditItem';
	const SelectedItem='SelectedItem';
	const Pager='Pager';
}

/**
 * IItemDataRenderer interface.
 *
 * IItemDataRenderer defines the interface that an item renderer
 * needs to implement. Besides the {@link getData Data} property, a list item
 * renderer also needs to provide {@link getItemIndex ItemIndex} and
 * {@link getItemType ItemType} property.
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @package System.Web.UI.WebControls
 * @since 3.1.0
 */
interface IItemDataRenderer extends IDataRenderer
{
	/**
	 * Returns a value indicating the zero-based index of the item in the corresponding data control's item collection.
	 * If the item is not in the collection (e.g. it is a header item), it returns -1.
	 * @return integer zero-based index of the item.
	 */
	public function getItemIndex();

/**
	 * Sets the zero-based index for the item.
	 * If the item is not in the item collection (e.g. it is a header item), -1 should be used.
	 * @param integer zero-based index of the item.
	 */
	public function setItemIndex($value);

/**
	 * @return TListItemType the item type.
	 */
	public function getItemType();

/**
	 * @param TListItemType the item type.
	 */
	public function setItemType($value);
}

${this.title}

Code Editor : TDataBoundControl.php