Subversion-Projekte lars-tiefland.prado

<?php
/**
 * TColorPicker class file
 *
 * @author Wei Zhuo <weizhuo[at]gmail[dot]com>
 * @link http://www.pradosoft.com/
 * @copyright Copyright &copy; 2005-2008 PradoSoft
 * @license http://www.pradosoft.com/license/
 * @version $Id: TColorPicker.php 2549 2008-10-29 16:06:10Z carlgmathisen $
 * @package System.Web.UI.WebControls
 */

/**
 * TColorPicker class.
 *
 * Be aware, this control is EXPERIMENTAL and is not stablized yet.
 *
 * @author Wei Zhuo <weizhuo[at]gmail[dot]com>
 * @version $Id: TColorPicker.php 2549 2008-10-29 16:06:10Z carlgmathisen $
 * @package System.Web.UI.WebControls
 * @since 3.0
 */
class TColorPicker extends TTextBox
{
        const SCRIPT_PATH = 'prado/colorpicker';

        private $_clientSide;

        /**
         * @return boolean whether the color picker should pop up when the button is clicked.
         */
        public function getShowColorPicker()
        {
                return $this->getViewState('ShowColorPicker',true);
        }

        /**
         * Sets whether to pop up the color picker when the button is clicked.
         * @param boolean whether to show the color picker popup
         */
        public function setShowColorPicker($value)
        {
                $this->setViewState('ShowColorPicker',TPropertyValue::ensureBoolean($value),true);
        }

        /**
         * @param TColorPickerMode color picker UI mode
         */
        public function setMode($value)
        {
           $this->setViewState('Mode', TPropertyValue::ensureEnum($value, 'TColorPickerMode'), TColorPickerMode::Basic);
        }

        /**
         * @return TColorPickerMode current color picker UI mode. Defaults to TColorPickerMode::Basic.
         */
        public function getMode()
        {
           return $this->getViewState('Mode', TColorPickerMode::Basic);
        }

        /**
         * @param string set the color picker style
         */
        public function setColorPickerStyle($value)
        {
           $this->setViewState('ColorStyle', $value, 'default');
        }

        /**
         * @return string current color picker style
         */
        public function getColorPickerStyle()
        {
           return $this->getViewState('ColorStyle', 'default');
        }

        /**
         * @return string text for the color picker OK button. Default is "OK".
         */
        public function getOKButtonText()
        {
                return $this->getViewState('OKButtonText', 'OK');
        }

        /**
         * @param string text for the color picker OK button
         */
        public function setOKButtonText($value)
        {
                $this->setViewState('OKButtonText', $value, 'OK');
        }

        /**
         * @return string text for the color picker Cancel button. Default is "Cancel".
         */
        public function getCancelButtonText()
        {
                return $this->getViewState('CancelButtonText', 'Cancel');
        }

        /**
         * @param string text for the color picker Cancel button
         */
        public function setCancelButtonText($value)
        {
                $this->setViewState('CancelButtonText', $value, 'Cancel');
        }

        /**
         * @return TColorPickerClientSide javascript event options.
         */
        public function getClientSide()
        {
                if(is_null($this->_clientSide))
                        $this->_clientSide = $this->createClientSide();
                return $this->_clientSide;
        }

        /**
         * @return TColorPickerClientSide javascript validator event options.
         */
        protected function createClientSide()
        {
                return new TColorPickerClientSide;
        }

        /**
         * Get javascript color picker options.
         * @return array color picker client-side options
         */
        protected function getPostBackOptions()
        {
                $options = parent::getPostBackOptions();
                $options['ClassName'] = $this->getCssClass();
                $options['ShowColorPicker'] = $this->getShowColorPicker();
                if($options['ShowColorPicker'])
                {
                        $mode = $this->getMode();
                        if($mode == TColorPickerMode::Full) $options['Mode'] = $mode;
                        else if($mode == TColorPickerMode::Simple) $options['Palette'] = 'Tiny';
                        $options['OKButtonText'] = $this->getOKButtonText();
                        $options['CancelButtonText'] = $this->getCancelButtonText();
                }
                $options = array_merge($options,$this->getClientSide()->getOptions()->toArray());
                return $options;
        }

        /**
         * @param string asset file in the self::SCRIPT_PATH directory.
         * @return string asset file url.
         */
        protected function getAssetUrl($file='')
        {
                $base = $this->getPage()->getClientScript()->getPradoScriptAssetUrl();
                return $base.'/'.self::SCRIPT_PATH.'/'.$file;
        }

        /**
         * Publish the color picker Css asset files.
         */
        public function onPreRender($param)
        {
                parent::onPreRender($param);
                $this->publishColorPickerAssets();
        }

        /**
         * Publish the color picker assets.
         */
        protected function publishColorPickerAssets()
        {
                $cs = $this->getPage()->getClientScript();
                $key = "prado:".get_class($this);
                $imgs['button.gif'] = $this->getAssetUrl('button.gif');
                $imgs['background.png'] = $this->getAssetUrl('background.png');
                $options = TJavaScript::encode($imgs);
                $code = "Prado.WebUI.TColorPicker.UIImages = {$options};";
                $cs->registerEndScript($key, $code);
                $cs->registerPradoScript("colorpicker");
                $url = $this->getAssetUrl($this->getColorPickerStyle().'.css');
                if(!$cs->isStyleSheetFileRegistered($url))
                        $cs->registerStyleSheetFile($url, $url);
        }

        /**
         * Renders additional body content.
         * This method overrides parent implementation by adding
         * additional color picker button.
         * @param THtmlWriter writer
         */
        public function renderEndTag($writer)
        {
                parent::renderEndTag($writer);

                $color = $this->getText();
                $writer->addAttribute('class', 'TColorPicker_button');
                $writer->renderBeginTag('span');

                $writer->addAttribute('id', $this->getClientID().'_button');
                $writer->addAttribute('src', $this->getAssetUrl('button.gif'));
                if($color !== '')
                        $writer->addAttribute('style', "background-color:{$color};");
                $writer->addAttribute('width', '20');
                $writer->addAttribute('height', '20');
                $writer->addAttribute('alt', '');
                $writer->renderBeginTag('img');
                $writer->renderEndTag();
                $writer->renderEndTag();
        }

        /**
         * Gets the name of the javascript class responsible for performing postback for this control.
         * This method overrides the parent implementation.
         * @return string the javascript class name
         */
        protected function getClientClassName()
        {
                return 'Prado.WebUI.TColorPicker';
        }
}

/**
 * TColorPickerMode class.
 * TColorPickerMode defines the enumerable type for the possible UI mode
 * that a {@link TColorPicker} control can take.
 *
 * The following enumerable values are defined:
 * - Simple
 * - Basic
 * - Full
 *
 * @author Qiang Xue <qiang.xue@gmail.com>
 * @version $Id: TColorPicker.php 2549 2008-10-29 16:06:10Z carlgmathisen $
 * @package System.Web.UI.WebControls
 * @since 3.0.4
 */
class TColorPickerMode extends TEnumerable
{
        const Simple='Simple';
        const Basic='Basic';
        const Full='Full';
}

/**
 * TColorPickerClientSide class.
 *
 * Client-side javascript code options.
 *
 * @author Wei Zhuo <weizhuo[at]gmail[dot]com>
 * @version $Id: TColorPicker.php 2549 2008-10-29 16:06:10Z carlgmathisen $
 * @package System.Web.UI.WebControls
 * @since 3.1
 */
class TColorPickerClientSide extends TClientSideOptions
{
        /**
         * @return string javascript code for when a color is selected.
         */
        public function getOnColorSelected()
        {
                return $this->getOption('OnColorSelected');
        }

        /**
         * @param string javascript code for when a color is selected.
         */
        public function setOnColorSelected($javascript)
        {
                $this->setFunction('OnColorSelected', $javascript);
        }
}