home *** CD-ROM | disk | FTP | other *** search
/ Cricao de Sites - 650 Layouts Prontos / WebMasters.iso / Servidores / xampp-win32-1.6.7-installer.exe / php / PEAR / HTML / QuickForm2 / Element / InputImage.php < prev    next >
Encoding:
PHP Script  |  2008-07-02  |  5.7 KB  |  163 lines

  1. <?php
  2. /**
  3.  * Class for <input type="image" /> elements
  4.  *
  5.  * PHP version 5
  6.  *
  7.  * LICENSE:
  8.  * 
  9.  * Copyright (c) 2006, 2007, Alexey Borzov <avb@php.net>,
  10.  *                           Bertrand Mansion <golgote@mamasam.com>
  11.  * All rights reserved.
  12.  *
  13.  * Redistribution and use in source and binary forms, with or without
  14.  * modification, are permitted provided that the following conditions
  15.  * are met:
  16.  *
  17.  *    * Redistributions of source code must retain the above copyright
  18.  *      notice, this list of conditions and the following disclaimer.
  19.  *    * Redistributions in binary form must reproduce the above copyright
  20.  *      notice, this list of conditions and the following disclaimer in the 
  21.  *      documentation and/or other materials provided with the distribution.
  22.  *    * The names of the authors may not be used to endorse or promote products 
  23.  *      derived from this software without specific prior written permission.
  24.  *
  25.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
  26.  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  27.  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  28.  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  29.  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  30.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  31.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  32.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  33.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  34.  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  35.  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  36.  *
  37.  * @category   HTML
  38.  * @package    HTML_QuickForm2
  39.  * @author     Alexey Borzov <avb@php.net>
  40.  * @author     Bertrand Mansion <golgote@mamasam.com>
  41.  * @license    http://opensource.org/licenses/bsd-license.php New BSD License
  42.  * @version    CVS: $Id: InputImage.php,v 1.5 2007/06/30 20:36:00 avb Exp $
  43.  * @link       http://pear.php.net/package/HTML_QuickForm2
  44.  */
  45.  
  46. /**
  47.  * Base class for <input> elements
  48.  */
  49. require_once 'HTML/QuickForm2/Element/Input.php';
  50.  
  51. /**
  52.  * Class for <input type="image" /> elements
  53.  *
  54.  * @category   HTML
  55.  * @package    HTML_QuickForm2
  56.  * @author     Alexey Borzov <avb@php.net>
  57.  * @author     Bertrand Mansion <golgote@mamasam.com>
  58.  * @version    Release: 0.2.0
  59.  */
  60. class HTML_QuickForm2_Element_InputImage extends HTML_QuickForm2_Element_Input
  61. {
  62.     protected $attributes = array('type' => 'image');
  63.  
  64.    /**
  65.     * Coordinates of user click within the image, array contains keys 'x' and 'y'
  66.     * @var  array
  67.     */
  68.     protected $coordinates = null;
  69.  
  70.    /**
  71.     * Image buttons can not be frozen
  72.     *
  73.     * @param    bool    Whether element should be frozen or editable. This 
  74.     *                   parameter is ignored in case of image elements
  75.     * @return   bool    Always returns false
  76.     */  
  77.     public function toggleFrozen($freeze = null)
  78.     {
  79.         return false;
  80.     }
  81.  
  82.    /**
  83.     * Image button's value cannot be set via this method
  84.     *
  85.     * @param    mixed   Element's value, this parameter is ignored
  86.     * @return   HTML_QuickForm2_Element_InputImage
  87.     */
  88.     public function setValue($value)
  89.     {
  90.         return $this;
  91.     }
  92.  
  93.    /**
  94.     * Returns the element's value
  95.     *
  96.     * The value is only returned if the form was actually submitted and this
  97.     * image button was clicked. Returns null in all other cases.
  98.     *
  99.     * @return   array|null  An array with keys 'x' and 'y' containing the 
  100.     *                       coordinates of user click if the image was clicked, 
  101.     *                       null otherwise 
  102.     */ 
  103.     public function getValue()
  104.     {
  105.         return $this->getAttribute('disabled')? null: $this->coordinates;
  106.     }
  107.  
  108.    /**
  109.     * Returns the HTML representation of the element
  110.     *
  111.     * The method changes the element's name to foo[bar][] if it was foo[bar]
  112.     * originally. If it is not done, then one of the click coordinates will be
  113.     * lost, see {@link http://bugs.php.net/bug.php?id=745}  
  114.     * 
  115.     * @return   string
  116.     */
  117.     public function __toString()
  118.     {
  119.         if (false === strpos($this->attributes['name'], '[') ||
  120.             '[]' == substr($this->attributes['name'], -2))
  121.         {
  122.             return parent::__toString();
  123.         } else {
  124.             $this->attributes['name'] .= '[]';
  125.             $html = parent::__toString();
  126.             $this->attributes['name']  = substr($this->attributes['name'], 0, -2);
  127.             return $html;
  128.         }
  129.     }
  130.  
  131.     protected function updateValue()
  132.     {
  133.         foreach ($this->getDataSources() as $ds) {
  134.             if ($ds instanceof HTML_QuickForm2_DataSource_Submit) {
  135.                 $name = $this->getName();
  136.                 if (false === strpos($name, '[') &&
  137.                     null !== ($value = $ds->getValue($name . '_x')))
  138.                 {
  139.                     $this->coordinates = array(
  140.                         'x' => $value,
  141.                         'y' => $ds->getValue($name . '_y')
  142.                     );
  143.                     return;
  144.  
  145.                 } elseif (false !== strpos($name, '[')) {
  146.                     if ('[]' == substr($name, -2)) {
  147.                         $name = substr($name, 0, -2);
  148.                     }
  149.                     if (null !== ($value = $ds->getValue($name))) {
  150.                         $this->coordinates = array(
  151.                             'x' => $value[0],
  152.                             'y' => $value[1]
  153.                         );
  154.                         return;
  155.                     }
  156.                 }
  157.             }
  158.         }
  159.         $this->coordinates = null;
  160.     }
  161. }
  162. ?>
  163.