1 files changed, 155 insertions, 0 deletions
diff --git a/lib/prado/framework/Web/UI/WebControls/TImage.php b/lib/prado/framework/Web/UI/WebControls/TImage.php
new file mode 100644
index 0000000..8538545
--- /dev/null
+++ b/lib/prado/framework/Web/UI/WebControls/TImage.php
@@ -0,0 +1,155 @@
+<?php
+/**
+ * TImage class file.
+ *
+ * @author Qiang Xue <qiang.xue@gmail.com>
+ * @link https://github.com/pradosoft/prado
+ * @copyright Copyright &copy; 2005-2015 The PRADO Group
+ * @license https://github.com/pradosoft/prado/blob/master/COPYRIGHT
+ * @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>
+ * @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,'');
+	}
+}
+