summaryrefslogtreecommitdiff
path: root/framework/Web/UI/WebControls
diff options
context:
space:
mode:
Diffstat (limited to 'framework/Web/UI/WebControls')
-rw-r--r--framework/Web/UI/WebControls/TImage.php46
-rw-r--r--framework/Web/UI/WebControls/TImageButton.php11
-rw-r--r--framework/Web/UI/WebControls/TPanel.php6
-rw-r--r--framework/Web/UI/WebControls/TTextBox.php6
4 files changed, 40 insertions, 29 deletions
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)
{
diff --git a/framework/Web/UI/WebControls/TImageButton.php b/framework/Web/UI/WebControls/TImageButton.php
index 724dcf5c..d715480d 100644
--- a/framework/Web/UI/WebControls/TImageButton.php
+++ b/framework/Web/UI/WebControls/TImageButton.php
@@ -3,15 +3,15 @@
* TImageButton 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
*/
/**
- * TImage class file
+ * Includes TImage class file
*/
Prado::using('System.Web.UI.WebControls.TImage');
@@ -19,7 +19,7 @@ Prado::using('System.Web.UI.WebControls.TImage');
* TImageButton class
*
* TImageButton displays an image on the Web page and responds to mouse clicks on the image.
- * It is similar to the TButton component except that the TImageButton also captures the
+ * It is similar to the {@link TButton} control except that the TImageButton also captures the
* coordinates where the image is clicked.
*
* Write a <b>OnClick</b> event handler to programmatically determine the coordinates
@@ -42,7 +42,6 @@ Prado::using('System.Web.UI.WebControls.TImage');
* @package System.Web.UI.WebControls
* @since 3.0
*/
-
class TImageButton extends TImage implements IPostBackDataHandler, IPostBackEventHandler
{
private $_x=0;
diff --git a/framework/Web/UI/WebControls/TPanel.php b/framework/Web/UI/WebControls/TPanel.php
index 0f85a52f..ae6a1244 100644
--- a/framework/Web/UI/WebControls/TPanel.php
+++ b/framework/Web/UI/WebControls/TPanel.php
@@ -3,9 +3,9 @@
* TPanel 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
*/
diff --git a/framework/Web/UI/WebControls/TTextBox.php b/framework/Web/UI/WebControls/TTextBox.php
index b8c594f3..5e57e240 100644
--- a/framework/Web/UI/WebControls/TTextBox.php
+++ b/framework/Web/UI/WebControls/TTextBox.php
@@ -3,9 +3,9 @@
* TTextBox 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
*/
generated by cgit v1.2.3 (git 2.46.0) at 2024-11-08 15:14:17 +0000