class.ilFormPropertyGUI.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */

class ilFormPropertyGUI
{
        protected $type;
        protected $title;
        protected $postvar;
        protected $info;
        protected $alert;
        protected $required = false;
        protected $parentgui;
        protected $parentform;
        protected $hidden_title = "";
        protected $multi;
        protected $multi_values; 
        
        function __construct($a_title = "", $a_postvar = "")
        {
                $this->setTitle($a_title);
                $this->setPostVar($a_postvar);
                $this->setDisabled(false);
        }

        function &executeCommand()
        {
                global $ilCtrl;
                
                $next_class = $ilCtrl->getNextClass($this);
                $cmd = $ilCtrl->getCmd();
                
                return $this->$cmd();
        }

        protected function setType($a_type)
        {
                $this->type = $a_type;
        }

        function getType()
        {
                return $this->type;
        }

        function setTitle($a_title)
        {
                $this->title = $a_title;
        }

        function getTitle()
        {
                return $this->title;
        }

        function setPostVar($a_postvar)
        {
                $this->postvar = $a_postvar;
        }

        function getPostVar()
        {
                return $this->postvar;
        }

        function getFieldId()
        {
                $id = str_replace("[", "__", $this->getPostVar());
                $id = str_replace("]", "__", $id);
                
                return $id;
        }

        function setInfo($a_info)
        {
                $this->info = $a_info;
        }

        function getInfo()
        {
                return $this->info;
        }

        function setAlert($a_alert)
        {
                $this->alert = $a_alert;
        }

        function getAlert()
        {
                return $this->alert;
        }

        function setRequired($a_required)
        {
                $this->required = $a_required;
        }

        function getRequired()
        {
                return $this->required;
        }
        
        function setDisabled($a_disabled)
        {
                $this->disabled = $a_disabled;
        }

        function getDisabled()
        {
                return $this->disabled;
        }
        
        function checkInput()
        {
                return false;           // please overwrite
        }

        function setParentForm($a_parentform)
        {
                $this->setParent($a_parentform);
        }

        function getParentForm()
        {
                return $this->getParent();
        }

        function setParent($a_val)
        {
                $this->parent_gui = $a_val;
        }
        
        function getParent()
        {
                return $this->parent_gui;
        }

        public function getSubForm()
        {
                return "";
        }

        public function hideSubForm()
        {
                return false;
        }

        function setHiddenTitle($a_val)
        {
                $this->hidden_title = $a_val;
        }
        
        function getHiddenTitle()
        {
                return $this->hidden_title;
        }
        
        function getItemByPostVar($a_post_var)
        {
                if ($this->getPostVar() == $a_post_var)
                {
                        return $this;
                }
                
                return false;
        }
        
        function serializeData()
        {
                return serialize($this->getValue());
        }
        
        function unserializeData($a_data)
        {
                $data = unserialize($a_data);

                if ($data)
                {
                        $this->setValue($data);
                }
                else
                {
                        $this->setValue(false);
                }
        }
        
        function writeToSession()
        {
                $parent = $this->getParent();
                if (!is_object($parent))
                {
                        die("You must set parent for ".get_class($this)." to use serialize feature.");
                }
                $_SESSION["form_".$parent->getId()][$this->getFieldId()] =
                        $this->serializeData();
        }

        function clearFromSession()
        {
                $parent = $this->getParent();
                if (!is_object($parent))
                {
                        die("You must set parent for ".get_class($this)." to use serialize feature.");
                }
                $_SESSION["form_".$parent->getId()][$this->getFieldId()] = false;
        }

        function readFromSession()
        {
                $parent = $this->getParent();
                if (!is_object($parent))
                {
                        die("You must set parent for ".get_class($this)." to use serialize feature.");
                }
                $this->unserializeData($_SESSION["form_".$parent->getId()][$this->getFieldId()]);
        }
        
        function getHiddenTag($a_post_var, $a_value)
        {
                return '<input type="hidden" name="'.$a_post_var.'" value="'.ilUtil::prepareFormOutput($a_value).'" />';
        }
        
        public function setMulti($a_multi)
        {
                trigger_error("not supported for form property type", E_USER_WARNING);
        }

        public function getMulti()
        {
                return $this->multi;
        }
        
        public function setMultiValues(array $a_values)
        {
                $this->multi_values = array_unique($a_values);
        }
        
        public function getMultiValues()
        {
                return $this->multi_values;
        }
        
        protected function getMultiIconsHTML($a_sortable = false)
        {
                global $lng;
                
                $id = $this->getFieldId();
                
                $html = '<input align="absmiddle" type="image" id="ilMultiAdd~'.$id.'~0"'.
                        ' src="'.ilUtil::getImagePath('edit_add.png').'" alt="'.
                $lng->txt("add").'" title="'.$lng->txt("add").'" onclick="javascript: return false;" />'.
                '<input align="absmiddle" type="image" id="ilMultiRmv~'.$id.'~0"'.
                ' src="'.ilUtil::getImagePath('edit_remove.png').'" alt="'.$lng->txt("remove").
                '" title="'.$lng->txt("remove").'"  onclick="javascript: return false;" />';    
                
                if($a_sortable)
                {
                        $html .= '&nbsp;<input align="absmiddle" type="image" id="ilMultiDwn~'.$id.'~0"'.
                                ' src="'.ilUtil::getImagePath('icon_down_s.png').'" alt="'.
                        $lng->txt("down").'" title="'.$lng->txt("down").'" onclick="javascript: return false;" />'.
                        '<input align="absmiddle" type="image" id="ilMultiUp~'.$id.'~0"'.
                        ' src="'.ilUtil::getImagePath('icon_up_s.png').'" alt="'.$lng->txt("up").
                        '" title="'.$lng->txt("up").'"  onclick="javascript: return false;" />';        
                }
                
                return $html;
        }
}
?>