# Source code for taurus.qt.qtgui.container.taurusbasecontainer

    #!/usr/bin/env python

    # ###########################################################################
    #
    # This file is part of Taurus
    #
    # http://taurus-scada.org
    #
    # Copyright 2011 CELLS / ALBA Synchrotron, Bellaterra, Spain
    #
    # Taurus is free software: you can redistribute it and/or modify
    # it under the terms of the GNU Lesser General Public License as published by
    # the Free Software Foundation, either version 3 of the License, or
    # (at your option) any later version.
    #
    # Taurus is distributed in the hope that it will be useful,
    # but WITHOUT ANY WARRANTY; without even the implied warranty of
    # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    # GNU Lesser General Public License for more details.
    #
    # You should have received a copy of the GNU Lesser General Public License
    # along with Taurus.  If not, see <http://www.gnu.org/licenses/>.
    #
    # ###########################################################################

    """This module provides base class for all taurus container widgets
    """

    __docformat__ = "restructuredtext"

    from taurus.external.qt import Qt

    from taurus.qt.qtgui.base import TaurusBaseComponent, TaurusBaseWidget

    class TaurusBaseContainer(TaurusBaseWidget):
        """Base class for the Taurus container widgets. This type of taurus
        container classes are specially useful if you define a parent taurus model
        to them and set all contained taurus widgets to use parent model.
        Example::

            from taurus.qt.qtgui.container import TaurusWidget
            from taurus.qt.qtgui.display import TaurusLabel

            widget = TaurusWidget()
            layout = Qt.QVBoxLayout()
            widget.setLayout(layout)
            widget.model = 'sys/database/2'
            stateWidget = TaurusLabel()
            layout.addWidget(stateWidget)
            stateWidget.model = 'sys/database/2/state'
        """

        def __init__(self, name="", parent=None, designMode=False):
            name = name or self.__class__.__name__

            self.call__init__(
                TaurusBaseWidget, name, parent, designMode=designMode
            )

            self.defineStyle()
            self.designMode = designMode

        def taurusChildren(self, objs=None):
            """returns a list of all taurus children of this taurus container
            (recurses down skipping non-taurus widgets)

            :param objs: if given, the search starts at the objects passed in this
                list
            :type objs: list<objects>
            :return:
            :rtype: list<TaurusBaseWidget>
            """
            if objs is None:
                objs = self.children()
            result = []
            for o in objs:
                if isinstance(o, TaurusBaseWidget):
                    result.append(o)
                else:
                    result += self.taurusChildren(o.children())
            return result

        def defineStyle(self):
            self.updateStyle()

        def sizeHint(self):
            #        if self.designMode:
            #            return Qt.QSize(150, 150)
            return Qt.QWidget.sizeHint(self)

        # -~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~
        # TaurusBaseWidget over writing
        # -~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~

        def isReadOnly(self):
            return True

        def updateStyle(self):
            if self.getShowQuality():
                self.setAutoFillBackground(True)
                # TODO: get quality/state from model and update accordingly
            else:
                self.setAutoFillBackground(False)
                # TODO: restore colors
            TaurusBaseWidget.updateStyle(self)

        # -~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~
        # Pending operations related methods
        # -~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~

        def getPendingOperations(self):
            pending_ops = []

            for child in Qt.QObject.children(self):
                if isinstance(child, TaurusBaseComponent):
                    pending_ops += child.getPendingOperations()
            return pending_ops

        def resetPendingOperations(self):
            self.debug("Reset changes")
            for child in Qt.QObject.children(self):
                if isinstance(child, TaurusBaseComponent):
                    child.resetPendingOperations()

        def hasPendingOperations(self):
            ret = False
            for child in Qt.QObject.children(self):
                if isinstance(child, TaurusBaseComponent):
                    ret |= child.hasPendingOperations()
            return ret

        def handleEvent(self, evt_src, evt_type, evt_value):
            if not self._setText or not self.getShowText():
                return
            modelObj = self.getModelObj()
            if modelObj:
                txt = modelObj.getDisplayName(complete=False)
            else:
                txt = self.getNoneValue()
            self._setText(txt)