From 1bc5daba808067a1db85ab8b8a401c217c9a8097 Mon Sep 17 00:00:00 2001
From: xue <>
Date: Sat, 26 Nov 2005 03:04:23 +0000
Subject:

---
 framework/Web/UI/WebControls/TImage.php | 46 +++++++++++++++++++++------------
 1 file changed, 29 insertions(+), 17 deletions(-)

(limited to 'framework/Web/UI/WebControls/TImage.php')

diff --git a/framework/Web/UI/WebControls/TImage.php b/framework/Web/UI/WebControls/TImage.php
index 0033209a..dd0387a5 100644
--- a/framework/Web/UI/WebControls/TImage.php
+++ b/framework/Web/UI/WebControls/TImage.php
@@ -3,9 +3,9 @@
  * TImage class file.
  *
  * @author Qiang Xue <qiang.xue@gmail.com>
- * @link http://www.xisc.com/
- * @copyright Copyright &copy; 2004-2005, Qiang Xue
- * @license http://www.opensource.org/licenses/bsd-license.php BSD License
+ * @link http://www.pradosoft.com/
+ * @copyright Copyright &copy; 2005 PradoSoft
+ * @license http://www.pradosoft.com/license/
  * @version $Revision: $  $Date: $
  * @package System.Web.UI.WebControls
  */
@@ -13,6 +13,13 @@
 /**
  * TImage class
  *
+ * TImage displays an image on a page. The image is specified via the
+ * {@link setImageUrl ImageUrl} property which takes a relative or absolute
+ * URL to the image file. The alignment of the image displayed is set by
+ * the {@link setImageAlign ImageAlign} property. To set alternative texts
+ * or long description of the image, use {@link setAlternativeText AlternativeText}
+ * or {@link setDescriptionUrl DescriptionUrl} property, respectively.
+ *
  * @author Qiang Xue <qiang.xue@gmail.com>
  * @version $Revision: $  $Date: $
  * @package System.Web.UI.WebControls
@@ -20,30 +27,34 @@
  */
 class TImage extends TWebControl
 {
-	public static $IMAGE_ALIGN=array('NotSet','AbsBottom','AbsMiddle','Baseline','Bottom','Left','Middle','Right','TextTop','Top');
-	// todo: TControl::resolveClientUrl()
 	/**
-	 * @return string tag name of the image
+	 * @return string tag name of image control
 	 */
 	protected function getTagName()
 	{
 		return 'img';
 	}
 
+	/**
+	 * Adds attributes related to an HTML image element to renderer.
+	 * @param THtmlWriter the writer used for the rendering purpose
+	 */
 	protected function addAttributesToRender($writer)
 	{
 		$writer->addAttribute('src',$this->getImageUrl());
 		$writer->addAttribute('alt',$this->getAlternateText());
 		if(($desc=$this->getDescriptionUrl())!=='')
-			$writer->addAttribute('longdesc',$this->resolveClientUrl($desc));
-		if(($align=$this->getImageAlign())!=='NotSet')
-			$writer->addAttribute('align',strtolower($align));
+			$writer->addAttribute('longdesc',$desc);
+		if(($align=$this->getImageAlign())!=='')
+			$writer->addAttribute('align',$align);
+		if(($width=$this->getBorderWidth())==='')
+			$writer->addStyleAttribute('border-width','0px');
 		parent::addAttributesToRender($writer);
 	}
 
 	/**
 	 * Renders the body content of the image.
-	 * None will be rendered for an image.
+	 * Nothing to be rendered within image tags.
 	 * @param THtmlWriter the writer for rendering
 	 */
 	protected function renderContents($writer)
@@ -68,7 +79,7 @@ class TImage extends TWebControl
 	}
 
 	/**
-	 * @return string the alignment of the image with respective to other elements on the page.
+	 * @return string the alignment of the image with respective to other elements on the page, defaults to empty.
 	 */
 	public function getImageAlign()
 	{
@@ -77,15 +88,18 @@ class TImage extends TWebControl
 
 	/**
 	 * Sets the alignment of the image with respective to other elements on the page.
+	 * Possible values include: absbottom, absmiddle, baseline, bottom, left,
+	 * middle, right, texttop, and top. If an empty string is passed in,
+	 * imagealign attribute will not be rendered.
 	 * @param string the alignment of the image
 	 */
 	public function setImageAlign($value)
 	{
-		$this->setViewState('ImageAlign',TPropertyValue::ensureEnum($value,self::$IMAGE_ALIGN),'NotSet');
+		$this->setViewState('ImageAlign',$value,'');
 	}
 
 	/**
-	 * @return string the location of the image file to be displayed
+	 * @return string the URL of the image file
 	 */
 	public function getImageUrl()
 	{
@@ -93,8 +107,7 @@ class TImage extends TWebControl
 	}
 
 	/**
-	 * Sets the location of the image file to be displayed.
-	 * @param string the location of the image file (file path or URL)
+	 * @param string the URL of the image file
 	 */
 	public function setImageUrl($value)
 	{
@@ -110,8 +123,7 @@ class TImage extends TWebControl
 	}
 
 	/**
-	 * Sets the link to long description
-	 * @param string the link to long description
+	 * @param string the URL to the long description of the image.
 	 */
 	public function setDescriptionUrl($value)
 	{
-- 
cgit v1.2.3