one class per file: framework/Web/UI/WebControls

1 files changed, 1 insertions, 609 deletions

diff --git a/framework/Web/UI/WebControls/TImageMap.php b/framework/Web/UI/WebControls/TImageMap.php
index 23409b1c..3ca178b2 100644
--- a/framework/Web/UI/WebControls/TImageMap.php
+++ b/framework/Web/UI/WebControls/TImageMap.php
@@ -217,612 +217,4 @@ class TImageMap extends TImage implements IPostBackEventHandler
 	{
 		$this->raiseEvent('OnClick',$this,$param);
 	}
-}
-
-/**
- * TImageMapEventParameter class.
- *
- * TImageMapEventParameter represents a postback event parameter
- * when a hotspot is clicked and posts back in a {@link TImageMap}.
- * To retrieve the post back value associated with the hotspot being clicked,
- * access {@link getPostBackValue PostBackValue}.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @package System.Web.UI.WebControls
- * @since 3.0
- */
-class TImageMapEventParameter extends TEventParameter
-{
-	private $_postBackValue;
-
-	/**
-	 * Constructor.
-	 * @param string post back value associated with the hotspot clicked
-	 */
-	public function __construct($postBackValue)
-	{
-		$this->_postBackValue=$postBackValue;
-	}
-
-	/**
-	 * @return string post back value associated with the hotspot clicked
-	 */
-	public function getPostBackValue()
-	{
-		return $this->_postBackValue;
-	}
-}
-
-/**
- * THotSpotCollection class.
- *
- * THotSpotCollection represents a collection of hotspots in an imagemap.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @package System.Web.UI.WebControls
- * @since 3.0
- */
-class THotSpotCollection extends TList
-{
-	/**
-	 * Inserts an item at the specified position.
-	 * This overrides the parent implementation by inserting only {@link THotSpot}.
-	 * @param integer the speicified position.
-	 * @param mixed new item
-	 * @throws TInvalidDataTypeException if the item to be inserted is not a THotSpot.
-	 */
-	public function insertAt($index,$item)
-	{
-		if($item instanceof THotSpot)
-			parent::insertAt($index,$item);
-		else
-			throw new TInvalidDataTypeException('hotspotcollection_hotspot_required');
-	}
-}
-
-
-/**
- * THotSpot class.
- *
- * THotSpot implements the basic functionality common to all hot spot shapes.
- * Derived classes include {@link TCircleHotSpot}, {@link TPolygonHotSpot}
- * and {@link TRectangleHotSpot}.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @package System.Web.UI.WebControls
- * @since 3.0
- */
-abstract class THotSpot extends TComponent
-{
-	private $_viewState=array();
-
-	/**
-	 * Returns a viewstate value.
-	 *
-	 * This function is very useful in defining getter functions for component properties
-	 * that must be kept in viewstate.
-	 * @param string the name of the viewstate value to be returned
-	 * @param mixed the default value. If $key is not found in viewstate, $defaultValue will be returned
-	 * @return mixed the viewstate value corresponding to $key
-	 */
-	protected function getViewState($key,$defaultValue=null)
-	{
-		return isset($this->_viewState[$key])?$this->_viewState[$key]:$defaultValue;
-	}
-
-	/**
-	 * Sets a viewstate value.
-	 *
-	 * This function is very useful in defining setter functions for control properties
-	 * that must be kept in viewstate.
-	 * Make sure that the viewstate value must be serializable and unserializable.
-	 * @param string the name of the viewstate value
-	 * @param mixed the viewstate value to be set
-	 * @param mixed default value. If $value===$defaultValue, the item will be cleared from the viewstate.
-	 */
-	protected function setViewState($key,$value,$defaultValue=null)
-	{
-		if($value===$defaultValue)
-			unset($this->_viewState[$key]);
-		else
-			$this->_viewState[$key]=$value;
-	}
-
-	/**
-	 * @return string shape of the hotspot, can be 'circle', 'rect', 'poly', etc.
-	 */
-	abstract public function getShape();
-	/**
-	 * @return string coordinates defining the hotspot shape.
-	 */
-	abstract public function getCoordinates();
-
-	/**
-	 * @return string the access key that allows you to quickly navigate to the HotSpot region. Defaults to ''.
-	 */
-	public function getAccessKey()
-	{
-		return $this->getViewState('AccessKey','');
-	}
-
-	/**
-	 * @param string the access key that allows you to quickly navigate to the HotSpot region.
-	 */
-	public function setAccessKey($value)
-	{
-		$this->setViewState('AccessKey',TPropertyValue::ensureString($value),'');
-	}
-
-	/**
-	 * @return string the alternate text to display for a HotSpot object. Defaults to ''.
-	 */
-	public function getAlternateText()
-	{
-		return $this->getViewState('AlternateText','');
-	}
-
-	/**
-	 * @param string the alternate text to display for a HotSpot object.
-	 */
-	public function setAlternateText($value)
-	{
-		$this->setViewState('AlternateText',TPropertyValue::ensureString($value),'');
-	}
-
-	/**
-	 * @return THotSpotMode the behavior of a HotSpot object when it is clicked. Defaults to THotSpotMode::NotSet.
-	 */
-	public function getHotSpotMode()
-	{
-		return $this->getViewState('HotSpotMode',THotSpotMode::NotSet);
-	}
-
-	/**
-	 * @param THotSpotMode the behavior of a HotSpot object when it is clicked.
-	 */
-	public function setHotSpotMode($value)
-	{
-		$this->setViewState('HotSpotMode',TPropertyValue::ensureEnum($value,'THotSpotMode'),THotSpotMode::NotSet);
-	}
-
-	/**
-	 * @return string the URL to navigate to when a HotSpot object is clicked. Defaults to ''.
-	 */
-	public function getNavigateUrl()
-	{
-		return $this->getViewState('NavigateUrl','');
-	}
-
-	/**
-	 * @param string the URL to navigate to when a HotSpot object is clicked.
-	 */
-	public function setNavigateUrl($value)
-	{
-		$this->setViewState('NavigateUrl',TPropertyValue::ensureString($value),'');
-	}
-
-	/**
-	 * @return string a value that is post back when the HotSpot is clicked. Defaults to ''.
-	 */
-	public function getPostBackValue()
-	{
-		return $this->getViewState('PostBackValue','');
-	}
-
-	/**
-	 * @param string a value that is post back when the HotSpot is clicked.
-	 */
-	public function setPostBackValue($value)
-	{
-		$this->setViewState('PostBackValue',TPropertyValue::ensureString($value),'');
-	}
-
-	/**
-	 * @return integer the tab index of the HotSpot region. Defaults to 0.
-	 */
-	public function getTabIndex()
-	{
-		return $this->getViewState('TabIndex',0);
-	}
-
-	/**
-	 * @param integer the tab index of the HotSpot region.
-	 */
-	public function setTabIndex($value)
-	{
-		$this->setViewState('TabIndex',TPropertyValue::ensureInteger($value),0);
-	}
-
-	/**
-	 * @return boolean whether postback event trigger by this hotspot will cause input validation, default is true
-	 */
-	public function getCausesValidation()
-	{
-		return $this->getViewState('CausesValidation',true);
-	}
-
-	/**
-	 * @param boolean whether postback event trigger by this hotspot will cause input validation
-	 */
-	public function setCausesValidation($value)
-	{
-		$this->setViewState('CausesValidation',TPropertyValue::ensureBoolean($value),true);
-	}
-
-	/**
-	 * @return string the group of validators which the hotspot causes validation upon postback
-	 */
-	public function getValidationGroup()
-	{
-		return $this->getViewState('ValidationGroup','');
-	}
-
-	/**
-	 * @param string the group of validators which the hotspot causes validation upon postback
-	 */
-	public function setValidationGroup($value)
-	{
-		$this->setViewState('ValidationGroup',$value,'');
-	}
-
-	/**
-	 * @return string  the target window or frame to display the new page when the HotSpot region
-	 * is clicked. Defaults to ''.
-	 */
-	public function getTarget()
-	{
-		return $this->getViewState('Target','');
-	}
-
-	/**
-	 * @param string  the target window or frame to display the new page when the HotSpot region
-	 * is clicked.
-	 */
-	public function setTarget($value)
-	{
-		$this->setViewState('Target',TPropertyValue::ensureString($value),'');
-	}
-
-	/**
-	 * @return boolean whether the hotspot has custom attributes
-	 */
-	public function getHasAttributes()
-	{
-		if($attributes=$this->getViewState('Attributes',null))
-			return $attributes->getCount()>0;
-		else
-			return false;
-	}
-
-	/**
-	 * Returns the list of custom attributes.
-	 * Custom attributes are name-value pairs that may be rendered
-	 * as HTML tags' attributes.
-	 * @return TAttributeCollection the list of custom attributes
-	 */
-	public function getAttributes()
-	{
-		if($attributes=$this->getViewState('Attributes',null))
-			return $attributes;
-		else
-		{
-			$attributes=new TAttributeCollection;
-			$this->setViewState('Attributes',$attributes,null);
-			return $attributes;
-		}
-	}
-
-	/**
-	 * @return boolean whether the named attribute exists
-	 */
-	public function hasAttribute($name)
-	{
-		if($attributes=$this->getViewState('Attributes',null))
-			return $attributes->contains($name);
-		else
-			return false;
-	}
-
-	/**
-	 * @return string attribute value, null if attribute does not exist
-	 */
-	public function getAttribute($name)
-	{
-		if($attributes=$this->getViewState('Attributes',null))
-			return $attributes->itemAt($name);
-		else
-			return null;
-	}
-
-	/**
-	 * Sets a custom hotspot attribute.
-	 * @param string attribute name
-	 * @param string value of the attribute
-	 */
-	public function setAttribute($name,$value)
-	{
-		$this->getAttributes()->add($name,$value);
-	}
-
-	/**
-	 * Removes the named attribute.
-	 * @param string the name of the attribute to be removed.
-	 * @return string attribute value removed, null if attribute does not exist.
-	 */
-	public function removeAttribute($name)
-	{
-		if($attributes=$this->getViewState('Attributes',null))
-			return $attributes->remove($name);
-		else
-			return null;
-	}
-
-	/**
-	 * Renders this hotspot.
-	 * @param THtmlWriter
-	 */
-	public function render($writer)
-	{
-		$writer->addAttribute('shape',$this->getShape());
-		$writer->addAttribute('coords',$this->getCoordinates());
-		if(($mode=$this->getHotSpotMode())===THotSpotMode::NotSet)
-			$mode=THotSpotMode::Navigate;
-		if($mode===THotSpotMode::Navigate)
-		{
-			$writer->addAttribute('href',$this->getNavigateUrl());
-			if(($target=$this->getTarget())!=='')
-				$writer->addAttribute('target',$target);
-		}
-		else if($mode===THotSpotMode::Inactive)
-			$writer->addAttribute('nohref','true');
-		$text=$this->getAlternateText();
-		$writer->addAttribute('title',$text);
-		$writer->addAttribute('alt',$text);
-		if(($accessKey=$this->getAccessKey())!=='')
-			$writer->addAttribute('accesskey',$accessKey);
-		if(($tabIndex=$this->getTabIndex())!==0)
-			$writer->addAttribute('tabindex',"$tabIndex");
-		if($this->getHasAttributes())
-		{
-			foreach($this->getAttributes() as $name=>$value)
-				$writer->addAttribute($name,$value);
-		}
-		$writer->renderBeginTag('area');
-		$writer->renderEndTag();
-	}
-}
-
-/**
- * Class TCircleHotSpot.
- *
- * TCircleHotSpot defines a circular hot spot region in a {@link TImageMap}
- * control.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @package System.Web.UI.WebControls
- * @since 3.0
- */
-class TCircleHotSpot extends THotSpot
-{
-	/**
-	 * @return string shape of this hotspot.
-	 */
-	public function getShape()
-	{
-		return 'circle';
-	}
-
-	/**
-	 * @return string coordinates defining this hotspot shape
-	 */
-	public function getCoordinates()
-	{
-		return $this->getX().','.$this->getY().','.$this->getRadius();
-	}
-
-	/**
-	 * @return integer radius of the circular HotSpot region. Defaults to 0.
-	 */
-	public function getRadius()
-	{
-		return $this->getViewState('Radius',0);
-	}
-
-	/**
-	 * @param integer radius of the circular HotSpot region.
-	 */
-	public function setRadius($value)
-	{
-		$this->setViewState('Radius',TPropertyValue::ensureInteger($value),0);
-	}
-
-	/**
-	 * @return integer the X coordinate of the center of the circular HotSpot region. Defaults to 0.
-	 */
-	public function getX()
-	{
-		return $this->getViewState('X',0);
-	}
-
-	/**
-	 * @param integer the X coordinate of the center of the circular HotSpot region.
-	 */
-	public function setX($value)
-	{
-		$this->setViewState('X',TPropertyValue::ensureInteger($value),0);
-	}
-
-	/**
-	 * @return integer the Y coordinate of the center of the circular HotSpot region. Defaults to 0.
-	 */
-	public function getY()
-	{
-		return $this->getViewState('Y',0);
-	}
-
-	/**
-	 * @param integer the Y coordinate of the center of the circular HotSpot region.
-	 */
-	public function setY($value)
-	{
-		$this->setViewState('Y',TPropertyValue::ensureInteger($value),0);
-	}
-}
-
-/**
- * Class TRectangleHotSpot.
- *
- * TRectangleHotSpot defines a rectangle hot spot region in a {@link
- * TImageMap} control.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @package System.Web.UI.WebControls
- * @since 3.0
- */
-class TRectangleHotSpot extends THotSpot
-{
-	/**
-	 * @return string shape of this hotspot.
-	 */
-	public function getShape()
-	{
-		return 'rect';
-	}
-
-	/**
-	 * @return string coordinates defining this hotspot shape
-	 */
-	public function getCoordinates()
-	{
-		return $this->getLeft().','.$this->getTop().','.$this->getRight().','.$this->getBottom();
-	}
-
-	/**
-	 * @return integer the Y coordinate of the bottom side of the rectangle HotSpot region. Defaults to 0.
-	 */
-	public function getBottom()
-	{
-		return $this->getViewState('Bottom',0);
-	}
-
-	/**
-	 * @param integer the Y coordinate of the bottom side of the rectangle HotSpot region.
-	 */
-	public function setBottom($value)
-	{
-		$this->setViewState('Bottom',TPropertyValue::ensureInteger($value),0);
-	}
-
-	/**
-	 * @return integer the X coordinate of the right side of the rectangle HotSpot region. Defaults to 0.
-	 */
-	public function getLeft()
-	{
-		return $this->getViewState('Left',0);
-	}
-
-	/**
-	 * @param integer the X coordinate of the right side of the rectangle HotSpot region.
-	 */
-	public function setLeft($value)
-	{
-		$this->setViewState('Left',TPropertyValue::ensureInteger($value),0);
-	}
-
-	/**
-	 * @return integer the X coordinate of the right side of the rectangle HotSpot region. Defaults to 0.
-	 */
-	public function getRight()
-	{
-		return $this->getViewState('Right',0);
-	}
-
-	/**
-	 * @param integer the X coordinate of the right side of the rectangle HotSpot region.
-	 */
-	public function setRight($value)
-	{
-		$this->setViewState('Right',TPropertyValue::ensureInteger($value),0);
-	}
-
-	/**
-	 * @return integer the Y coordinate of the top side of the rectangle HotSpot region. Defaults to 0.
-	 */
-	public function getTop()
-	{
-		return $this->getViewState('Top',0);
-	}
-
-	/**
-	 * @param integer the Y coordinate of the top side of the rectangle HotSpot region.
-	 */
-	public function setTop($value)
-	{
-		$this->setViewState('Top',TPropertyValue::ensureInteger($value),0);
-	}
-}
-
-/**
- * Class TPolygonHotSpot.
- *
- * TPolygonHotSpot defines a polygon hot spot region in a {@link
- * TImageMap} control.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @package System.Web.UI.WebControls
- * @since 3.0
- */
-class TPolygonHotSpot extends THotSpot
-{
-	/**
-	 * @return string shape of this hotspot.
-	 */
-	public function getShape()
-	{
-		return 'poly';
-	}
-
-	/**
-	 * @return string coordinates of the vertices defining the polygon.
-	 * Coordinates are concatenated together with comma ','. Each pair
-	 * represents (x,y) of a vertex.
-	 */
-	public function getCoordinates()
-	{
-		return $this->getViewState('Coordinates','');
-	}
-
-	/**
-	 * @param string coordinates of the vertices defining the polygon.
-	 * Coordinates are concatenated together with comma ','. Each pair
-	 * represents (x,y) of a vertex.
-	 */
-	public function setCoordinates($value)
-	{
-		$this->setViewState('Coordinates',$value,'');
-	}
-}
-
-
-/**
- * THotSpotMode class.
- * THotSpotMode defines the enumerable type for the possible hot spot modes.
- *
- * The following enumerable values are defined:
- * - NotSet: the mode is not specified
- * - Navigate: clicking on the hotspot will redirect the browser to a different page
- * - PostBack: clicking on the hotspot will cause a postback
- * - Inactive: the hotspot is inactive (not clickable)
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @package System.Web.UI.WebControls
- * @since 3.0.4
- */
-class THotSpotMode extends TEnumerable
-{
-	const NotSet='NotSet';
-	const Navigate='Navigate';
-	const PostBack='PostBack';
-	const Inactive='Inactive';
-}
-
+}
\ No newline at end of file