mcontrol.class

Ir para a documentação deste ficheiro.

<?php
abstract class MControl extends MComponent
{
 
    const FORM_MODE_WHOLE_ROW  = 0;
    const FORM_MODE_SHOW_SIDE  = 1;
    const FORM_MODE_SHOW_ABOVE = 2;
    const FORM_MODE_SHOW_NBSP  = 3;
    
    const CLASS_CAPTION = 'm-caption';
    const CLASS_CAPTION_REQUIRED = 'm-caption-required';
 
    const TOOLTIP_PLACEMENT_BOTTOM = 'bottom';
    const TOOLTIP_PLACEMENT_TOP = 'top';
    const TOOLTIP_PLACEMENT_LEFT = 'left';
    const TOOLTIP_PLACEMENT_RIGHT = 'right';
    const TOOLTIP_PLACEMENT_AUTO = 'auto';
 
    static  $_number = 0;
 
    private $_numberId;
 
    public $id;
 
    public $uniqueId;
 
    public $cssClass;
 
    public $enabled;
 
    public $style;
 
    public $visible;
 
    public $attrs; // array with HTML attributes
 
    public $attributes;
 
    public $formMode;
 
    public $maintainState;
 
    public $readonly;
 
    public $caption;
 
    public $jsHint;
 
    public $inner;
 
    public $controlBox;
    public $box;
 
    public $cssp;
 
    public $parent;
 
    public $controls;
 
    public $controlsId;
    //    var $controlsCount;
 
    public $eventHandlers;
 
    public $painter;
 
 
    public function __construct( $name = NULL )
    {
        parent::__construct( $name );
 
        $this->_numberId = MControl::$_number++;
        $this->id        = ( ( $this->name == NULL ) ? 'm'.$this->_numberId : $this->name );
        $this->cssClass  = '';
        $this->enabled   = true;
        $this->attrs     = new MStringList();
        $this->style     = new MStringList();
        $this->visible   = true;
        $this->formMode  = self::FORM_MODE_WHOLE_ROW;
        $this->maintainState = false;
        $this->readonly   = false;
        $this->cssp       = false;
        $this->uniqueId   = $this->id;
        $this->controls   = new MObjectList();
        $this->controlsId = new MObjectList();
        $this->eventHandlers = array ( );
        $this->inner   = '';
        $this->box     = NULL;
        $this->painter = $this->manager->GetPainter();
    }
 
    public function __clone()
    {
        $this->attrs      = clone $this->attrs; 
        $this->style      = clone $this->style; 
        $this->controls   = clone $this->controls; 
        $this->controlsId = clone $this->controlsId; 
    }
 
    public function __set( $name, $value )
    {
        switch ( $name )
            {
            case 'color':
            case 'font':
            case 'border':
                $this->_addStyle( $name, $value );
 
                break;
 
            case 'fontSize':
                $this->_addStyle( 'font-size', $value );
 
                break;
 
            case 'fontStyle':
                $this->_addStyle( 'font-style', $value );
 
                break;
 
            case 'fontFamily':
                $this->_addStyle( 'font-family', $value );
 
                break;
 
            case 'fontWeight':
                $this->_addStyle( 'font-weight', $value );
 
                break;
 
            case 'cursor':
                $this->_addStyle( 'cursor', $value );
                $this->addBoxStyle('cursor', $value);
 
                break;
 
            case 'textAlign':
                $this->_addStyle  ( 'text-align', $value );
                $this->addBoxStyle( 'text-align', $value );
 
                break;
 
            case 'textIndent':
                $this->_addStyle  ( 'text-indent', $value );
                $this->addBoxStyle( 'text-indent', $value );
 
                break;
 
            case 'lineHeight':
                $this->_addStyle( 'line-height', $value );
 
                break;
 
            case 'padding':
            case 'width':
            case 'height':
            case 'float':
            case 'clear':
            case 'visibility':
                $this->addBoxStyle( $name, $value );
 
                break;
 
            case 'top':
            case 'left':
            case 'position':
                $this->addBoxStyle( $name, $value );
 
                break;
 
            case 'zIndex':
                $this->addBoxStyle( 'z-index', $value );
 
                $this->cssp = true;
                break;
 
            case 'backgroundColor':
                $this->addBoxStyle( 'background-color', $value );
 
                break;
 
            case 'verticalAlign':
                $this->addBoxStyle( 'vertical-align', $value );
 
                break;
            }
    }
 
 
    public function __get( $name )
    {
        switch ( $name )
            {
            case 'top':
            case 'left':
            case 'width':
            case 'height':
            case 'padding':
            case 'float':
            case 'position':
                return $this->getBox()->style->get( $name );
 
                break;
            }
    }
 
 
    protected function _AddStyle($name, $value)
    {
        if ( $value != '' )
        {
            $this->style->addValue($name, $value);
        }
    }
 
 
    public function setReadOnly($status)
    {
        $this->readonly = $status;
    }
 
    public function setEnabled($state)
    {
        $this->enabled = $state;
    }
 
    public function setName($name)
    {
        MUtil::setIfNull($this->id, $name);
 
        parent::setName($name);
    }
 
 
    public function setId($id)
    {
        $this->id = $id;
        MUtil::setIfNull( $this->name, $id );
    }
    
    public function setNameAndId($name)
    {
        $this->setName($name);
        $this->setId($name);
    }
 
 
    public function getId()
    {
        return $this->id;
    }
 
 
    function getName()
    {
        return $this->name;
    }
 
 
    function getUniqueId()
    {
        return $this->uniqueId;
    }
 
 
    function setClass( $cssClass, $add = true )
    {
        if ( $add )
        {
            $this->cssClass .= MUtil::IfNull($this->cssClass, '', ' ') . $cssClass;
        }
        else
        {
            $this->cssClass = $cssClass;
        }
 
    }
 
 
    public function addStyleFile( $styleFile )
    {
        if ( !array_key_exists("REQUISICAO_PELA_API", $GLOBALS) || !$GLOBALS['REQUISICAO_PELA_API'])
        {
            $this->page->AddStyle($styleFile);
        }
    }
 
 
    public function getClass()
    {
        return $this->cssClass;
    }
 
 
    function addStyle($name, $value)
    {
        $this->$name = $value;
    }
 
    function setStyle($style)
    {
        $this->style->items = $style;
    }
 
    function getStyle()
    {
        return $this->style->hasItems() ? " style=\"" . $this->style->getText(':', ';') . "\"" : '';
    }
 
 
    function addAttribute( $name, $value = '' )
    {
        $this->attrs->addValue( $name, ( $value != '' ) ? "\"$value\"" : '' );
    }
 
    function setTooltip($title, $placement = self::TOOLTIP_PLACEMENT_AUTO)
    {
        $this->getBox()->addAttribute('title', $title);
        $this->getBox()->addAttribute('rel', 'tooltip');
        $this->getBox()->addAttribute('data-html', 'true');
        $this->getBox()->addAttribute('data-placement', $placement);
    }
 
    function setAttribute( $name, $value )
    {
        $this->addAttribute( $name, $value );
    }
 
 
    function setAttributes($attr)
    {
        if ( $attr != NULL )
        {
            if ( is_array($attr) )
            {
                foreach( $attr as $ak => $av )
                {
                    $this->setAttribute($ak, $av);
                }
            }
            else if ( is_string($attr) )
            {
                $attr = str_replace( "\"", '', trim($attr) );
 
                foreach ( explode(' ', $attr) as $a )
                {
                    $a = explode('=', $a);
                    $this->setAttribute($a[0], $a[1]);
                }
            }
        }
    }
 
    function attributes( $mergeDuplicates=false )
    {
        if ( $mergeDuplicates )
        {
            $items = $this->attrs->getItems();
 
            $items_new = array( );
            foreach( $items as $id=>$item )
            {
                if ( isset($items_new[ strtolower($id) ]) )
                {
                    $items_new[ strtolower($id) ] = substr($items_new[ strtolower($id) ], 0, -1) .';' . substr($item, 1);
                }
                else
                {
                    $items_new[ strtolower($id) ] = $item;
                }
            }
            $this->attrs->setItems( $items_new );
        }
        return $this->attrs->hasItems() ? ' ' . $this->attrs->getText("=", " ") : '';
    }
 
    function getAttributes( $mergeDuplicates=false )
    {
        return $this->attributes( $mergeDuplicates ) . $this->getStyle();
    }
 
    function setFormMode( $mode )
    {
        $this->formMode = $mode;
    }
 
    function setJsHint( $hint )
    {
        if ( $hint != '' )
        {
            $this->jsHint = $hint;
            $this->page->addScript('x/x_core.js');
            $this->page->addScript('x/x_dom.js');
            $this->page->addScript('x/x_event.js');
            $this->page->addScript('x/x_tip.js');
            $this->page->onLoad("new xTooltipGroup('tipHint', '', 'left', 3, 0);");
        }
    }
 
    function setPosition($left, $top, $position = 'absolute')
    {
        $this->addBoxStyle('position', $position);
        $this->addBoxStyle('left', "{$left}px");
        $this->addBoxStyle('top', "{$top}px");
    }
 
    function setWidth($value)
    {
        if ( ! $value )
        {
            return;
        }
 
        if ( strpos($value, '%') === false && $value != 'auto')
        {
            $v = "{$value}px";
        }
        else
        {
            $v = $value;
        }
 
        $this->addBoxStyle('width', $v);
    }
 
    function setHeight($value)
    {
        if ( ! $value )
        {
            return;
        }
 
        if ( strpos($value, '%') === false )
        {
            $v = "{$value}px";
        }
        else
        {
            $v = $value;
        }
 
        $this->addBoxStyle('height', $v);
    }
 
    function setColor($value)
    {
        $this->AddStyle('color', $value);
    }
 
    function setVisibility($value)
    {
        $value = ($value ? 'visible' : 'hidden');
        $this->visibility = $value;
    }
 
    function setFont($value)
    {
        $this->addStyle('font', $value);
    }
 
    function setCaption($caption)
    {
        $this->caption = $caption;
    }
 
    function setInner($inner)
    {
        $this->inner = $inner;
    }
 
    function getInner()
    {
        return $this->inner;
    }
 
    private function _AddControl($control, $pos = 0, $op = 'add')
    {
        if(is_array($control))
        {
            foreach($control as $c)
            {
                $this->_AddControl($c);
            }
        }
        elseif ( $control instanceof MControl )
        {
            if ( $op == 'add' )
            {
                $this->controlsId->add($control, $control->GetId() );
                $this->controls->add($control);
            }
            elseif ( $op == 'ins' )
            {
                $this->controlsId->add($control, $control->GetId() );
                $this->controls->insert($control, $pos);
            }
            elseif ( $op == 'set' )
            {
                $this->controlsId->set( $control->GetId(), $control );
                $this->controls->set($pos, $control);
            }
 
            $control->parent = $this;
        }
        elseif ( ! is_null($control) )
        {
            if ( ! is_object($control) )
            {
                throw new EControlException(
                          "Using non-object with _AddControl;<br/>type: " . gettype($control) . ';<br/>value: ' . $control
                              . ';<br/>Try using Label control instead');
            }
            else
            {
                throw new EControlException('Using non-control with _AddControl; class: ' . get_class($control).'; name: '.$control->name.'; id: '.$control->id);
            }
        }
    }
 
    function addControl($control)
    {
        $this->_AddControl($control);
    }
 
    function insertControl($control, $pos = 0, $width = null, $float = null)
    {
        $this->_AddControl($control, $pos, 'ins');
    }
 
    public function setControl($control, $pos = 0)
    {
        $this->_AddControl($control, $pos, 'set');
    }
 
    function setControls($controls)
    {
        $this->clearControls();
 
        foreach ( $controls as $c )
            $this->addControl($c);
    }
 
    function getControls()
    {
        return $this->controls->items;
    }
 
    public function getControl($pos)
    {
        return $this->controls->get($pos);
    }
 
    function getControlById($id)
    {
        return $this->controlsId->get($id);
    }
 
    function findControlById($id)
    {
        $k = NULL;
        $controls = $this->controlsId->items;
 
        foreach ( $controls as $c )
        {
            if ( $c->id == $id )
            {
                return $c;
            }
 
            elseif ( ( $k = $c->FindControlById($id) ) != NULL )
                break;
        }
 
        return $k;
    }
 
    function setControlById($control, $id)
    {
        $this->controlsId->set($id, $control);
    }
 
    function clearControls()
    {
        $this->controls->clear();
        $this->controlsId->clear();
    }
 
    //
    //  EventHandler
    // 
    function eventHandler()
    {
        $subject = $this;
 
        $event = $_REQUEST['__EVENTTARGETVALUE'] ?? null;
        $args  = $_REQUEST['__EVENTARGUMENT'] ?? null;
 
        if ($event != '')
        {
            $eventTokens = explode(':', $event);
            $sender = $subject->FindControlById( $eventTokens[0] );
            $func   = str_replace(':', '_', $event);
 
            if ( method_exists($subject, $func) )
            {
                $subject->$func($sender, $args);
            }
            elseif ( $sender instanceof MControl )
            {
                $eventType = $eventTokens[1];
                $func      = $sender->eventHandlers[$eventType]['handler'];
 
                if ( ! is_null($func) )
                {
                    if ( method_exists($subject, $func) )
                    {
                        $subject->$func($sender, $args);
                    }
                    elseif ( function_exists($func) )
                    {
                        $func($sender, $args);
                    }
                }
            }
        }
        if($eventTokens = explode(';', MIOLO::_REQUEST('event')))
        {
            $e = str_replace(':', '_', $eventTokens[0]);
 
            if ( (strtolower($e) !== strtolower($func ?? '')) && (method_exists($subject, $e) ) )
            {
                $params = $eventTokens[1];
                $subject->$e(NULL, $params);
            }
        }
    }
 
 
    function attachEventHandler( $name, $handler, $param = NULL )
    {
        $this->eventHandlers[$name]['handler'] = $handler;
        $this->eventHandlers[$name]['param']   = $param;
    }
 
 
    function getBox()
    {
        $this->cssp = true;
 
        if ( is_null($this->box) )
        {
            $this->box = new mSpan( 'm_' . MUtil::NVL( $this->name, $this->uniqueId ) );
        }
 
        return $this->box;
    }
 
 
    function setBoxId( $id )
    {
        $this->getBox()->setId( $id );
    }
 
 
    function setBoxClass( $cssClass, $add = true )
    {
        $this->getBox()->setClass( $cssClass, $add );
    }
 
 
    function getBoxClass()
    {
        return $this->getBox()->cssClass;
    }
 
 
    function setBoxAttributes($attr)
    {
        $this->getBox()->setAttributes($attr);
    }
 
    function getBoxAttributes()
    {
        return $this->getBox()->getAttributes();
    }
 
    function addBoxStyle($name, $value = '')
    {
        $this->GetBox()->_AddStyle($name, $value);
    }
 
 
    public function generateBox( $content )
    {
        $box = $this->getBox();
        $box->inner = $content;
 
        return $box->getRender('div');
    }
 
    function getRender( $method )
    {
        return $this->painter->$method( $this );
    }
 
 
    public function getInnerToString()
    {
        return $this->painter->generateToString( $this->getInner() );
    }
 
 
    public function generateInner()
    {
        if ( $this->inner == '' )
        {
            if ( $this->controls->hasItems() )
            {
                $this->inner = $this->controls->items;
            }
        }
    }
 
 
    public function generate()
    {
        $this->generateInner();
        $content = $this->getInner();
 
        if ( $this->jsHint != '' )
        {
            $hint = new mSpan('', $content, 'tipHint');
            $hint->addAttribute( "title", "{$this->jsHint}" );
 
            $content = $hint->generate();
        }
 
        if ( MForm::$showHints && $this->hint != '' )
        {
            $hint = new MSpan(NULL, $this->hint, 'm-hint');
 
            if ( is_string($content) )
            {
                $content .= $hint->generate();
            }
            else
            {
                $content = new MDiv(NULL, array($content, $hint));
            }
        }
 
        $MIOLO = MIOLO::getInstance();
        if ( strpos(MIOLO::getInstance()->getTheme()->id, "sbootstrap") !== false )
        {
            if (property_exists($this, 'label') && !empty($this->label) && $this->label != '&nbsp;')
            {
                if ($this instanceof MTextField || $this instanceof MListControl || $this instanceof MChoiceControl)
                {
                    $divContainer = new MDiv('', $content, 'm-new-container');
                    $content = $divContainer->generate();
                }
            }
        }
 
        return ( $this->cssp ? $this->generateBox($content) : $this->painter->generateToString($content) );
    }
}
 
?>