diff options
Diffstat (limited to 'framework/Web/UI/WebControls/TImage.php')
-rw-r--r-- | framework/Web/UI/WebControls/TImage.php | 312 |
1 files changed, 156 insertions, 156 deletions
diff --git a/framework/Web/UI/WebControls/TImage.php b/framework/Web/UI/WebControls/TImage.php index 37f9a050..c8dde281 100644 --- a/framework/Web/UI/WebControls/TImage.php +++ b/framework/Web/UI/WebControls/TImage.php @@ -1,157 +1,157 @@ -<?php
-/**
- * TImage class file.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @link http://www.pradosoft.com/
+<?php +/** + * TImage class file. + * + * @author Qiang Xue <qiang.xue@gmail.com> + * @link http://www.pradosoft.com/ * @copyright Copyright © 2005-2012 PradoSoft - * @license http://www.pradosoft.com/license/
- * @version $Id$
- * @package System.Web.UI.WebControls
- */
-
-/**
- * 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 setAlternateText AlternateText}
- * or {@link setDescriptionUrl DescriptionUrl} property, respectively.
- *
- * @author Qiang Xue <qiang.xue@gmail.com>
- * @version $Id$
- * @package System.Web.UI.WebControls
- * @since 3.0
- */
-class TImage extends TWebControl implements IDataRenderer
-{
- /**
- * @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',$desc);
- if(($align=$this->getImageAlign())!=='')
- $writer->addAttribute('align',$align);
- parent::addAttributesToRender($writer);
- }
-
- /**
- * Renders the body content of the image.
- * Nothing to be rendered within image tags.
- * @param THtmlWriter the writer for rendering
- */
- public function renderContents($writer)
- {
- }
-
- /**
- * @return string the alternative text displayed in the TImage component when the image is unavailable.
- */
- public function getAlternateText()
- {
- return $this->getViewState('AlternateText','');
- }
-
- /**
- * Sets the alternative text to be displayed in the TImage when the image is unavailable.
- * @param string the alternative text
- */
- public function setAlternateText($value)
- {
- $this->setViewState('AlternateText',$value,'');
- }
-
- /**
- * @return string the alignment of the image with respective to other elements on the page, defaults to empty.
- */
- public function getImageAlign()
- {
- return $this->getViewState('ImageAlign','');
- }
-
- /**
- * 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',$value,'');
- }
-
- /**
- * @return string the URL of the image file
- */
- public function getImageUrl()
- {
- return $this->getViewState('ImageUrl','');
- }
-
- /**
- * @param string the URL of the image file
- */
- public function setImageUrl($value)
- {
- $this->setViewState('ImageUrl',$value,'');
- }
-
- /**
- * Returns the URL of the image file.
- * This method is required by {@link IDataRenderer}.
- * It is the same as {@link getImageUrl()}.
- * @return string the URL of the image file.
- * @see getImageUrl
- * @since 3.1.0
- */
- public function getData()
- {
- return $this->getImageUrl();
- }
-
- /**
- * Sets the URL of the image.
- * This method is required by {@link IDataRenderer}.
- * It is the same as {@link setImageUrl()}.
- * @param string the URL of the image file.
- * @see setImageUrl
- * @since 3.1.0
- */
- public function setData($value)
- {
- $this->setImageUrl($value);
- }
-
- /**
- * @return string the URL to long description
- */
- public function getDescriptionUrl()
- {
- return $this->getViewState('DescriptionUrl','');
- }
-
- /**
- * @param string the URL to the long description of the image.
- */
- public function setDescriptionUrl($value)
- {
- $this->setViewState('DescriptionUrl',$value,'');
- }
-}
-
+ * @license http://www.pradosoft.com/license/ + * @version $Id$ + * @package System.Web.UI.WebControls + */ + +/** + * 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 setAlternateText AlternateText} + * or {@link setDescriptionUrl DescriptionUrl} property, respectively. + * + * @author Qiang Xue <qiang.xue@gmail.com> + * @version $Id$ + * @package System.Web.UI.WebControls + * @since 3.0 + */ +class TImage extends TWebControl implements IDataRenderer +{ + /** + * @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',$desc); + if(($align=$this->getImageAlign())!=='') + $writer->addAttribute('align',$align); + parent::addAttributesToRender($writer); + } + + /** + * Renders the body content of the image. + * Nothing to be rendered within image tags. + * @param THtmlWriter the writer for rendering + */ + public function renderContents($writer) + { + } + + /** + * @return string the alternative text displayed in the TImage component when the image is unavailable. + */ + public function getAlternateText() + { + return $this->getViewState('AlternateText',''); + } + + /** + * Sets the alternative text to be displayed in the TImage when the image is unavailable. + * @param string the alternative text + */ + public function setAlternateText($value) + { + $this->setViewState('AlternateText',$value,''); + } + + /** + * @return string the alignment of the image with respective to other elements on the page, defaults to empty. + */ + public function getImageAlign() + { + return $this->getViewState('ImageAlign',''); + } + + /** + * 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',$value,''); + } + + /** + * @return string the URL of the image file + */ + public function getImageUrl() + { + return $this->getViewState('ImageUrl',''); + } + + /** + * @param string the URL of the image file + */ + public function setImageUrl($value) + { + $this->setViewState('ImageUrl',$value,''); + } + + /** + * Returns the URL of the image file. + * This method is required by {@link IDataRenderer}. + * It is the same as {@link getImageUrl()}. + * @return string the URL of the image file. + * @see getImageUrl + * @since 3.1.0 + */ + public function getData() + { + return $this->getImageUrl(); + } + + /** + * Sets the URL of the image. + * This method is required by {@link IDataRenderer}. + * It is the same as {@link setImageUrl()}. + * @param string the URL of the image file. + * @see setImageUrl + * @since 3.1.0 + */ + public function setData($value) + { + $this->setImageUrl($value); + } + + /** + * @return string the URL to long description + */ + public function getDescriptionUrl() + { + return $this->getViewState('DescriptionUrl',''); + } + + /** + * @param string the URL to the long description of the image. + */ + public function setDescriptionUrl($value) + { + $this->setViewState('DescriptionUrl',$value,''); + } +} + |