standardize the use of unix eol; use svn properties to enforce native eol

1 files changed, 705 insertions, 705 deletions

diff --git a/framework/Web/UI/ActiveControls/TCallbackClientScript.php b/framework/Web/UI/ActiveControls/TCallbackClientScript.php
index 6dcbe3d0..291f22f2 100644
--- a/framework/Web/UI/ActiveControls/TCallbackClientScript.php
+++ b/framework/Web/UI/ActiveControls/TCallbackClientScript.php
@@ -1,705 +1,705 @@
-<?php

-/**

- * TCallbackClientScript class file

- *

- * @author Wei Zhuo <weizhuo[at]gamil[dot]com>

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

- * @copyright Copyright &copy; 2005-2012 PradoSoft

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

- * @version $Id$

- * @package System.Web.UI.ActiveControls

- */

-

-/**

- * TCallbackClientScript class.

- *

- * The TCallbackClientScript class provides corresponding methods that can be

- * executed on the client-side (i.e. the browser client that is viewing

- * the page) during a callback response.

- *

- * The avaiable methods includes setting/clicking input elements, changing Css

- * styles, hiding/showing elements, and adding visual effects to elements on the

- * page. The client-side methods can be access through the CallbackClient

- * property available in TPage.

- *

- * For example, to hide "$myTextBox" element during callback response, do

- * <code>

- * $this->getPage()->getCallbackClient()->hide($myTextBox);

- * </code>

- *

- * @author Wei Zhuo <weizhuo[at]gamil[dot]com>

- * @version $Id$

- * @package System.Web.UI.ActiveControls

- * @since 3.1

- */

-class TCallbackClientScript extends TApplicationComponent

-{

-	/**

-	 * @var TList list of client functions to execute.

-	 */

-	private $_actions;

-

-	/**

-	 * Constructor.

-	 */

-	public function __construct()

-	{

-		$this->_actions = new TList;

-	}

-

-	/**

-	 * @return array list of client function to be executed during callback

-	 * response.

-	 */

-	public function getClientFunctionsToExecute()

-	{

-		return $this->_actions->toArray();

-	}

-

-	/**

-	 * Executes a client-side statement.

-	 * @param string javascript function name

-	 * @param array list of arguments for the function

-	 */

-	public function callClientFunction($function, $params=null)

-	{

-		if(!is_array($params))

-			$params = array($params);

-

-		if(count($params) > 0)

-		{

-			if($params[0] instanceof TControl)

-				$params[0] = $params[0]->getClientID();

-		}

-		$this->_actions->add(array($function => $params));

-	}

-

-	/**

-	 * Client script to set the value of a particular input element.

-	 * @param TControl control element to set the new value

-	 * @param string new value

-	 */

-	public function setValue($input, $text)

-	{

-		$this->callClientFunction('Prado.Element.setValue', array($input, $text));

-	}

-

-	/**

-	 * Client script to select/clear/check a drop down list, check box list,

-	 * or radio button list.

-	 * The second parameter determines the selection method. Valid methods are

-	 *  - <b>Value</b>, select or check by value

-	 *  - <b>Values</b>, select or check by a list of values

-	 *  - <b>Index</b>, select or check by index (zero based index)

-	 *  - <b>Indices</b>, select or check by a list of index (zero based index)

-	 *  - <b>Clear</b>, clears or selections or checks in the list

-	 *  - <b>All</b>, select all

-	 *  - <b>Invert</b>, invert the selection.

-	 * @param TControl list control

-	 * @param string selection method

-	 * @param string|int the value or index to select/check.

-	 * @param string selection control type, either 'check' or 'select'

-	 */

-	public function select($control, $method='Value', $value=null, $type=null)

-	{

-		$method = TPropertyValue::ensureEnum($method,

-				'Value', 'Index', 'Clear', 'Indices', 'Values', 'All', 'Invert');

-		$type = ($type===null) ? $this->getSelectionControlType($control) : $type;

-		$total = $this->getSelectionControlIsListType($control) ? $control->getItemCount() : 1;

-		$this->callClientFunction('Prado.Element.select',

-				array($control, $type.$method, $value, $total));

-	}

-

-	private function getSelectionControlType($control)

-	{

-		if(is_string($control)) return 'check';

-		if($control instanceof TCheckBoxList)

-			return 'check';

-		if($control instanceof TCheckBox)

-			return 'check';

-		return 'select';

-	}

-

-	private function getSelectionControlIsListType($control)

-	{

-		return $control instanceof TListControl;

-	}

-

-	/**

-	 * Client script to click on an element. <b>This client-side function is unpredictable.</b>

-	 * 

-	 * @param TControl control element or element id

-	 */

-	public function click($control)

-	{

-		$this->callClientFunction('Prado.Element.click', $control);

-	}

-

-	/**

-	 * Client script to check or uncheck a checkbox or radio button.

-	 * @param TControl control element or element id

-	 * @param boolean check or uncheck the checkbox or radio button.

-	 */

-	public function check($checkbox, $checked=true)

-	{

-		$this->select($checkbox, "Value", $checked);

-	}

-

-	/**

-	 * Raise the client side event (given by $eventName) on a particular element.

-	 * @param TControl control element or element id

-	 * @param string Event name, e.g. "click"

-	 */

-	public function raiseClientEvent($control, $eventName)

-	{

-		$this->callClientFunction('Event.fireEvent',

-				array($control, strtolower($eventName)));

-	}

-

-	/**

-	 * Sets the attribute of a particular control.

-	 * @param TControl control element or element id

-	 * @param string attribute name

-	 * @param string attribute value

-	 */

-	public function setAttribute($control, $name, $value)

-	{

-        // Attributes should be applied on Surrounding tag, except for 'disabled' attribute

-		if ($control instanceof ISurroundable && strtolower($name)!=='disabled')

-            $control=$control->getSurroundingTagID();

-		$this->callClientFunction('Prado.Element.setAttribute',array($control, $name, $value));

-	}

-

-	/**

-	 * Sets the options of a select input element.

-	 * @param TControl control element or element id

-	 * @param TCollection a list of new options

-	 */

-	public function setListItems($control, $items)

-	{

-		$options = array();

-		if($control instanceof TListControl)

-		{

-			$promptText		= $control->getPromptText();

-			$promptValue	= $control->getPromptValue();

-			

-			if($promptValue==='')

-				$promptValue = $promptText;

-	

-			if($promptValue!=='')

-				$options[] = array($promptText, $promptValue);

-		}

-		

-		foreach($items as $item)

-		{

-			if($item->getHasAttributes())

-				$options[] =  array($item->getText(),$item->getValue(), $item->getAttributes()->itemAt('Group'));

-			else

-				$options[] = array($item->getText(),$item->getValue());

-		}

-		$this->callClientFunction('Prado.Element.setOptions', array($control, $options));

-	}

-

-	/**

-	 * Shows an element by changing its CSS display style as empty.

-	 * @param TControl control element or element id

-	 */

-	public function show($element)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction('Element.show', $element);

-	}

-

-	/**

-	 * Hides an element by changing its CSS display style to "none".

-	 * @param TControl control element or element id

-	 */

-	public function hide($element)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction('Element.hide', $element);

-	}

-

-	/**

-	 * Toggles the visibility of the element.

-	 * @param TControl control element or element id

-	 * @param string visual effect, such as, 'appear' or 'slide' or 'blind'.

-	 * @param array additional options.

-	 */

-	public function toggle($element, $effect=null, $options=array())

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction('Element.toggle', array($element,$effect,$options));

-	}

-

-	/**

-	 * Removes an element from the HTML page.

-	 * @param TControl control element or element id

-	 */

-	public function remove($element)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction('Element.remove', $element);

-	}

-

-	public function addPostDataLoader($name)

-	{

-		$this->callClientFunction('Prado.CallbackRequest.addPostLoaders', $name);

-	}

-

-	/**

-	 * Update the element's innerHTML with new content.

-	 * @param TControl control element or element id

-	 * @param TControl new HTML content, if content is of a TControl, the

-	 * controls render method is called.

-	 */

-	public function update($element, $content)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->replace($element, $content, 'Element.update');

-	}

-

-	/**

-	 * Add a Css class name to the element.

-	 * @param TControl control element or element id

-	 * @param string CssClass name to add.

-	 */

-	public function addCssClass($element, $cssClass)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction('Element.addClassName', array($element, $cssClass));

-	}

-

-	/**

-	 * Remove a Css class name from the element.

-	 * @param TControl control element or element id

-	 * @param string CssClass name to remove.

-	 */

-	public function removeCssClass($element, $cssClass)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction('Element.removeClassName', array($element, $cssClass));

-	}

-

-	/**

-	 * Sets the CssClass of an element.

-	 * @param TControl control element or element id

-	 * @param string new CssClass name for the element.

-	 */

-	/*public function setCssClass($element, $cssClass)

-	{

-		$this->callClientFunction('Prado.Element.CssClass.set', array($element, $cssClass));

-	}*/

-

-	/**

-	 * Scroll the top of the browser viewing area to the location of the

-	 * element.

-	 * @param TControl control element or element id

-	 */

-	public function scrollTo($element)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction('Element.scrollTo', $element);

-	}

-

-	/**

-	 * Focus on a particular element.

-	 * @param TControl control element or element id.

-	 */

-	public function focus($element)

-	{

-		$this->callClientFunction('Prado.Element.focus', $element);

-	}

-

-	/**

-	 * Sets the style of element. The style must be a key-value array where the

-	 * key is the style property and the value is the style value.

-	 * @param TControl control element or element id

-	 * @param array list of key-value pairs as style property and style value.

-	 */

-	public function setStyle($element, $styles)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction('Prado.Element.setStyle', array($element, $styles));

-	}

-

-	/**

-	 * Append a HTML fragement to the element.

-	 * @param TControl control element or element id

-	 * @param string HTML fragement or the control to be rendered

-	 */

-	public function appendContent($element, $content)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->replace($element, $content, 'Prado.Element.Insert.append');

-	}

-

-	/**

-	 * Prepend a HTML fragement to the element.

-	 * @param TControl control element or element id

-	 * @param string HTML fragement or the control to be rendered

-	 */

-	public function prependContent($element, $content)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->replace($element, $content, 'Prado.Element.Insert.prepend');

-	}

-

-	/**

-	 * Insert a HTML fragement after the element.

-	 * @param TControl control element or element id

-	 * @param string HTML fragement or the control to be rendered

-	 */

-	public function insertContentAfter($element, $content)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->replace($element, $content, 'Prado.Element.Insert.after');

-	}

-

-	/**

-	 * Insert a HTML fragement in before the element.

-	 * @param TControl control element or element id

-	 * @param string HTML fragement or the control to be rendered

-	 */

-	public function insertContentBefore($element, $content)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->replace($element, $content, 'Prado.Element.Insert.before');

-	}

-

-	/**

-	 * Replace the content of an element with new content. The new content can

-	 * be a string or a TControl component. If the <tt>content</tt> parameter is

-	 * a TControl component, its rendered method will be called and its contents

-	 * will be used for replacement.

-	 * @param TControl control element or HTML element id.

-	 * @param string HTML fragement or the control to be rendered

-	 * @param string replacement method, default is to replace the outter

-	 * html content.

-	 * @param string provide a custom boundary.

-	 * @see insertAbout

-	 * @see insertBelow

-	 * @see insertBefore

-	 * @see insertAfter

-	 */

-	protected function replace($element, $content, $method="Element.replace", $boundary=null)

-	{

-		if($content instanceof TControl)

-		{

-			$boundary = $this->getRenderedContentBoundary($content);

-			$content = null;

-		}

-		else if($content instanceof THtmlWriter)

-		{

-			$boundary = $this->getResponseContentBoundary($content);

-			$content = null;

-		}

-

-		$this->callClientFunction('Prado.Element.replace',

-					array($element, $method, $content, $boundary));

-	}

-

-	/**

-	 * Replace the content of an element with new content contained in writer.

-	 * @param TControl control element or HTML element id.

-	 * @param string HTML fragement or the control to be rendered

-	 */

-	public function replaceContent($element,$content)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->replace($element, $content);

-	}

-

-	/**

-	 * Evaluate a block of javascript enclosed in a boundary.

-	 * @param THtmlWriter writer for the content.

-	 */

-	public function evaluateScript($writer)

-	{

-		$this->replace(null, $writer, 'Prado.Element.evaluateScript');

-	}

-

-	/**

-	 * Appends a block of inline javascript enclosed in a boundary.

-	 * Similar to to evaluateScript(), but functions declared in the

-	 * inline block will be available to page elements.

-	 * @param THtmlWriter writer for the content.

-	 */

-	public function appendScriptBlock($content)

-	{

-		if($content instanceof TControl)

-		{

-			$boundary = $this->getRenderedContentBoundary($content);

-		}

-		else if($content instanceof THtmlWriter)

-		{

-			$boundary = $this->getResponseContentBoundary($content);

-		}

-		

-		$this->callClientFunction('Prado.Element.appendScriptBlock', array($boundary));

-	}

-

-	/**

-	 * Renders the control and return the content boundary from

-	 * TCallbackResponseWriter. This method should only be used by framework

-	 * component developers. The render() method is defered to be called in the

-	 * TActivePageAdapter class.

-	 * @param TControl control to be rendered on callback response.

-	 * @return string the boundary for which the rendered content is wrapped.

-	 */

-	private function getRenderedContentBoundary($control)

-	{

-		$writer = $this->getResponse()->createHtmlWriter();

-		$adapter = $control->getPage()->getAdapter();

-		$adapter->registerControlToRender($control, $writer);

-		return $writer->getWriter()->getBoundary();

-	}

-

-	/**

-	 * @param THtmlWriter the writer responsible for rendering html content.

-	 * @return string content boundary.

-	 */

-	private function getResponseContentBoundary($html)

-	{

-		if($html instanceof THtmlWriter)

-		{

-			if($html->getWriter() instanceof TCallbackResponseWriter)

-				return $html->getWriter()->getBoundary();

-		}

-		return null;

-	}

-

-	/**

-	 * Add a visual effect the element.

-	 * @param string visual effect function name.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function visualEffect($type, $element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->callClientFunction($type, array($element, $options));

-	}

-

-	/**

-	 * Visual Effect: Gradually make the element appear.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function appear($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Appear', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Blind down.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function blindDown($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.BlindDown', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Blind up.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function blindUp($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.BlindUp', $element, $options);

-

-	}

-

-	/**

-	 * Visual Effect: Drop out.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function dropOut($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.DropOut', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Gradually fade the element.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function fade($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Fade', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Fold.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function fold($element, $options = null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Fold', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Gradually make an element grow to a predetermined size.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function grow($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Grow', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Gradually grow and fade the element.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function puff($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Puff', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Pulsate.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function pulsate($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Pulsate', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Shake the element.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function shake($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Shake', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Shrink the element.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function shrink($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Shrink', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Slide down.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function slideDown($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.SlideDown', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Side up.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function slideUp($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.SlideUp', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Squish the element.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function squish($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.Squish', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: Switch Off effect.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function switchOff($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Effect.SwitchOff', $element, $options);

-	}

-

-	/**

-	 * Visual Effect: High light the element for about 2 seconds.

-	 * @param TControl control element or element id

-	 * @param array visual effect key-value pair options.

-	 */

-	public function highlight($element, $options=null)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$this->visualEffect('Prado.Effect.Highlight', $element, $options);

-	}

-

-	/**

-	 * Set the opacity on a html element or control.

-	 * @param TControl control element or element id

-	 * @param float opacity value between 1 and 0

-	 */

-	public function setOpacity($element, $value)

-	{

-        if ($element instanceof ISurroundable) 

-            $element=$element->getSurroundingTagID();

-		$value = TPropertyValue::ensureFloat($value);

-		$this->callClientFunction('Element.setOpacity', array($element,$value));

-	}

-}

-

+<?php
+/**
+ * TCallbackClientScript class file
+ *
+ * @author Wei Zhuo <weizhuo[at]gamil[dot]com>
+ * @link http://www.pradosoft.com/
+ * @copyright Copyright &copy; 2005-2012 PradoSoft
+ * @license http://www.pradosoft.com/license/
+ * @version $Id$
+ * @package System.Web.UI.ActiveControls
+ */
+
+/**
+ * TCallbackClientScript class.
+ *
+ * The TCallbackClientScript class provides corresponding methods that can be
+ * executed on the client-side (i.e. the browser client that is viewing
+ * the page) during a callback response.
+ *
+ * The avaiable methods includes setting/clicking input elements, changing Css
+ * styles, hiding/showing elements, and adding visual effects to elements on the
+ * page. The client-side methods can be access through the CallbackClient
+ * property available in TPage.
+ *
+ * For example, to hide "$myTextBox" element during callback response, do
+ * <code>
+ * $this->getPage()->getCallbackClient()->hide($myTextBox);
+ * </code>
+ *
+ * @author Wei Zhuo <weizhuo[at]gamil[dot]com>
+ * @version $Id$
+ * @package System.Web.UI.ActiveControls
+ * @since 3.1
+ */
+class TCallbackClientScript extends TApplicationComponent
+{
+	/**
+	 * @var TList list of client functions to execute.
+	 */
+	private $_actions;
+
+	/**
+	 * Constructor.
+	 */
+	public function __construct()
+	{
+		$this->_actions = new TList;
+	}
+
+	/**
+	 * @return array list of client function to be executed during callback
+	 * response.
+	 */
+	public function getClientFunctionsToExecute()
+	{
+		return $this->_actions->toArray();
+	}
+
+	/**
+	 * Executes a client-side statement.
+	 * @param string javascript function name
+	 * @param array list of arguments for the function
+	 */
+	public function callClientFunction($function, $params=null)
+	{
+		if(!is_array($params))
+			$params = array($params);
+
+		if(count($params) > 0)
+		{
+			if($params[0] instanceof TControl)
+				$params[0] = $params[0]->getClientID();
+		}
+		$this->_actions->add(array($function => $params));
+	}
+
+	/**
+	 * Client script to set the value of a particular input element.
+	 * @param TControl control element to set the new value
+	 * @param string new value
+	 */
+	public function setValue($input, $text)
+	{
+		$this->callClientFunction('Prado.Element.setValue', array($input, $text));
+	}
+
+	/**
+	 * Client script to select/clear/check a drop down list, check box list,
+	 * or radio button list.
+	 * The second parameter determines the selection method. Valid methods are
+	 *  - <b>Value</b>, select or check by value
+	 *  - <b>Values</b>, select or check by a list of values
+	 *  - <b>Index</b>, select or check by index (zero based index)
+	 *  - <b>Indices</b>, select or check by a list of index (zero based index)
+	 *  - <b>Clear</b>, clears or selections or checks in the list
+	 *  - <b>All</b>, select all
+	 *  - <b>Invert</b>, invert the selection.
+	 * @param TControl list control
+	 * @param string selection method
+	 * @param string|int the value or index to select/check.
+	 * @param string selection control type, either 'check' or 'select'
+	 */
+	public function select($control, $method='Value', $value=null, $type=null)
+	{
+		$method = TPropertyValue::ensureEnum($method,
+				'Value', 'Index', 'Clear', 'Indices', 'Values', 'All', 'Invert');
+		$type = ($type===null) ? $this->getSelectionControlType($control) : $type;
+		$total = $this->getSelectionControlIsListType($control) ? $control->getItemCount() : 1;
+		$this->callClientFunction('Prado.Element.select',
+				array($control, $type.$method, $value, $total));
+	}
+
+	private function getSelectionControlType($control)
+	{
+		if(is_string($control)) return 'check';
+		if($control instanceof TCheckBoxList)
+			return 'check';
+		if($control instanceof TCheckBox)
+			return 'check';
+		return 'select';
+	}
+
+	private function getSelectionControlIsListType($control)
+	{
+		return $control instanceof TListControl;
+	}
+
+	/**
+	 * Client script to click on an element. <b>This client-side function is unpredictable.</b>
+	 * 
+	 * @param TControl control element or element id
+	 */
+	public function click($control)
+	{
+		$this->callClientFunction('Prado.Element.click', $control);
+	}
+
+	/**
+	 * Client script to check or uncheck a checkbox or radio button.
+	 * @param TControl control element or element id
+	 * @param boolean check or uncheck the checkbox or radio button.
+	 */
+	public function check($checkbox, $checked=true)
+	{
+		$this->select($checkbox, "Value", $checked);
+	}
+
+	/**
+	 * Raise the client side event (given by $eventName) on a particular element.
+	 * @param TControl control element or element id
+	 * @param string Event name, e.g. "click"
+	 */
+	public function raiseClientEvent($control, $eventName)
+	{
+		$this->callClientFunction('Event.fireEvent',
+				array($control, strtolower($eventName)));
+	}
+
+	/**
+	 * Sets the attribute of a particular control.
+	 * @param TControl control element or element id
+	 * @param string attribute name
+	 * @param string attribute value
+	 */
+	public function setAttribute($control, $name, $value)
+	{
+        // Attributes should be applied on Surrounding tag, except for 'disabled' attribute
+		if ($control instanceof ISurroundable && strtolower($name)!=='disabled')
+            $control=$control->getSurroundingTagID();
+		$this->callClientFunction('Prado.Element.setAttribute',array($control, $name, $value));
+	}
+
+	/**
+	 * Sets the options of a select input element.
+	 * @param TControl control element or element id
+	 * @param TCollection a list of new options
+	 */
+	public function setListItems($control, $items)
+	{
+		$options = array();
+		if($control instanceof TListControl)
+		{
+			$promptText		= $control->getPromptText();
+			$promptValue	= $control->getPromptValue();
+			
+			if($promptValue==='')
+				$promptValue = $promptText;
+	
+			if($promptValue!=='')
+				$options[] = array($promptText, $promptValue);
+		}
+		
+		foreach($items as $item)
+		{
+			if($item->getHasAttributes())
+				$options[] =  array($item->getText(),$item->getValue(), $item->getAttributes()->itemAt('Group'));
+			else
+				$options[] = array($item->getText(),$item->getValue());
+		}
+		$this->callClientFunction('Prado.Element.setOptions', array($control, $options));
+	}
+
+	/**
+	 * Shows an element by changing its CSS display style as empty.
+	 * @param TControl control element or element id
+	 */
+	public function show($element)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction('Element.show', $element);
+	}
+
+	/**
+	 * Hides an element by changing its CSS display style to "none".
+	 * @param TControl control element or element id
+	 */
+	public function hide($element)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction('Element.hide', $element);
+	}
+
+	/**
+	 * Toggles the visibility of the element.
+	 * @param TControl control element or element id
+	 * @param string visual effect, such as, 'appear' or 'slide' or 'blind'.
+	 * @param array additional options.
+	 */
+	public function toggle($element, $effect=null, $options=array())
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction('Element.toggle', array($element,$effect,$options));
+	}
+
+	/**
+	 * Removes an element from the HTML page.
+	 * @param TControl control element or element id
+	 */
+	public function remove($element)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction('Element.remove', $element);
+	}
+
+	public function addPostDataLoader($name)
+	{
+		$this->callClientFunction('Prado.CallbackRequest.addPostLoaders', $name);
+	}
+
+	/**
+	 * Update the element's innerHTML with new content.
+	 * @param TControl control element or element id
+	 * @param TControl new HTML content, if content is of a TControl, the
+	 * controls render method is called.
+	 */
+	public function update($element, $content)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->replace($element, $content, 'Element.update');
+	}
+
+	/**
+	 * Add a Css class name to the element.
+	 * @param TControl control element or element id
+	 * @param string CssClass name to add.
+	 */
+	public function addCssClass($element, $cssClass)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction('Element.addClassName', array($element, $cssClass));
+	}
+
+	/**
+	 * Remove a Css class name from the element.
+	 * @param TControl control element or element id
+	 * @param string CssClass name to remove.
+	 */
+	public function removeCssClass($element, $cssClass)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction('Element.removeClassName', array($element, $cssClass));
+	}
+
+	/**
+	 * Sets the CssClass of an element.
+	 * @param TControl control element or element id
+	 * @param string new CssClass name for the element.
+	 */
+	/*public function setCssClass($element, $cssClass)
+	{
+		$this->callClientFunction('Prado.Element.CssClass.set', array($element, $cssClass));
+	}*/
+
+	/**
+	 * Scroll the top of the browser viewing area to the location of the
+	 * element.
+	 * @param TControl control element or element id
+	 */
+	public function scrollTo($element)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction('Element.scrollTo', $element);
+	}
+
+	/**
+	 * Focus on a particular element.
+	 * @param TControl control element or element id.
+	 */
+	public function focus($element)
+	{
+		$this->callClientFunction('Prado.Element.focus', $element);
+	}
+
+	/**
+	 * Sets the style of element. The style must be a key-value array where the
+	 * key is the style property and the value is the style value.
+	 * @param TControl control element or element id
+	 * @param array list of key-value pairs as style property and style value.
+	 */
+	public function setStyle($element, $styles)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction('Prado.Element.setStyle', array($element, $styles));
+	}
+
+	/**
+	 * Append a HTML fragement to the element.
+	 * @param TControl control element or element id
+	 * @param string HTML fragement or the control to be rendered
+	 */
+	public function appendContent($element, $content)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->replace($element, $content, 'Prado.Element.Insert.append');
+	}
+
+	/**
+	 * Prepend a HTML fragement to the element.
+	 * @param TControl control element or element id
+	 * @param string HTML fragement or the control to be rendered
+	 */
+	public function prependContent($element, $content)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->replace($element, $content, 'Prado.Element.Insert.prepend');
+	}
+
+	/**
+	 * Insert a HTML fragement after the element.
+	 * @param TControl control element or element id
+	 * @param string HTML fragement or the control to be rendered
+	 */
+	public function insertContentAfter($element, $content)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->replace($element, $content, 'Prado.Element.Insert.after');
+	}
+
+	/**
+	 * Insert a HTML fragement in before the element.
+	 * @param TControl control element or element id
+	 * @param string HTML fragement or the control to be rendered
+	 */
+	public function insertContentBefore($element, $content)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->replace($element, $content, 'Prado.Element.Insert.before');
+	}
+
+	/**
+	 * Replace the content of an element with new content. The new content can
+	 * be a string or a TControl component. If the <tt>content</tt> parameter is
+	 * a TControl component, its rendered method will be called and its contents
+	 * will be used for replacement.
+	 * @param TControl control element or HTML element id.
+	 * @param string HTML fragement or the control to be rendered
+	 * @param string replacement method, default is to replace the outter
+	 * html content.
+	 * @param string provide a custom boundary.
+	 * @see insertAbout
+	 * @see insertBelow
+	 * @see insertBefore
+	 * @see insertAfter
+	 */
+	protected function replace($element, $content, $method="Element.replace", $boundary=null)
+	{
+		if($content instanceof TControl)
+		{
+			$boundary = $this->getRenderedContentBoundary($content);
+			$content = null;
+		}
+		else if($content instanceof THtmlWriter)
+		{
+			$boundary = $this->getResponseContentBoundary($content);
+			$content = null;
+		}
+
+		$this->callClientFunction('Prado.Element.replace',
+					array($element, $method, $content, $boundary));
+	}
+
+	/**
+	 * Replace the content of an element with new content contained in writer.
+	 * @param TControl control element or HTML element id.
+	 * @param string HTML fragement or the control to be rendered
+	 */
+	public function replaceContent($element,$content)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->replace($element, $content);
+	}
+
+	/**
+	 * Evaluate a block of javascript enclosed in a boundary.
+	 * @param THtmlWriter writer for the content.
+	 */
+	public function evaluateScript($writer)
+	{
+		$this->replace(null, $writer, 'Prado.Element.evaluateScript');
+	}
+
+	/**
+	 * Appends a block of inline javascript enclosed in a boundary.
+	 * Similar to to evaluateScript(), but functions declared in the
+	 * inline block will be available to page elements.
+	 * @param THtmlWriter writer for the content.
+	 */
+	public function appendScriptBlock($content)
+	{
+		if($content instanceof TControl)
+		{
+			$boundary = $this->getRenderedContentBoundary($content);
+		}
+		else if($content instanceof THtmlWriter)
+		{
+			$boundary = $this->getResponseContentBoundary($content);
+		}
+		
+		$this->callClientFunction('Prado.Element.appendScriptBlock', array($boundary));
+	}
+
+	/**
+	 * Renders the control and return the content boundary from
+	 * TCallbackResponseWriter. This method should only be used by framework
+	 * component developers. The render() method is defered to be called in the
+	 * TActivePageAdapter class.
+	 * @param TControl control to be rendered on callback response.
+	 * @return string the boundary for which the rendered content is wrapped.
+	 */
+	private function getRenderedContentBoundary($control)
+	{
+		$writer = $this->getResponse()->createHtmlWriter();
+		$adapter = $control->getPage()->getAdapter();
+		$adapter->registerControlToRender($control, $writer);
+		return $writer->getWriter()->getBoundary();
+	}
+
+	/**
+	 * @param THtmlWriter the writer responsible for rendering html content.
+	 * @return string content boundary.
+	 */
+	private function getResponseContentBoundary($html)
+	{
+		if($html instanceof THtmlWriter)
+		{
+			if($html->getWriter() instanceof TCallbackResponseWriter)
+				return $html->getWriter()->getBoundary();
+		}
+		return null;
+	}
+
+	/**
+	 * Add a visual effect the element.
+	 * @param string visual effect function name.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function visualEffect($type, $element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->callClientFunction($type, array($element, $options));
+	}
+
+	/**
+	 * Visual Effect: Gradually make the element appear.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function appear($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Appear', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Blind down.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function blindDown($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.BlindDown', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Blind up.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function blindUp($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.BlindUp', $element, $options);
+
+	}
+
+	/**
+	 * Visual Effect: Drop out.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function dropOut($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.DropOut', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Gradually fade the element.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function fade($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Fade', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Fold.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function fold($element, $options = null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Fold', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Gradually make an element grow to a predetermined size.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function grow($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Grow', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Gradually grow and fade the element.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function puff($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Puff', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Pulsate.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function pulsate($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Pulsate', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Shake the element.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function shake($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Shake', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Shrink the element.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function shrink($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Shrink', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Slide down.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function slideDown($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.SlideDown', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Side up.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function slideUp($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.SlideUp', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Squish the element.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function squish($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.Squish', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: Switch Off effect.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function switchOff($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Effect.SwitchOff', $element, $options);
+	}
+
+	/**
+	 * Visual Effect: High light the element for about 2 seconds.
+	 * @param TControl control element or element id
+	 * @param array visual effect key-value pair options.
+	 */
+	public function highlight($element, $options=null)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$this->visualEffect('Prado.Effect.Highlight', $element, $options);
+	}
+
+	/**
+	 * Set the opacity on a html element or control.
+	 * @param TControl control element or element id
+	 * @param float opacity value between 1 and 0
+	 */
+	public function setOpacity($element, $value)
+	{
+        if ($element instanceof ISurroundable) 
+            $element=$element->getSurroundingTagID();
+		$value = TPropertyValue::ensureFloat($value);
+		$this->callClientFunction('Element.setOpacity', array($element,$value));
+	}
+}
+