class XToolBar(QToolBar):
collapseToggled = Signal(bool)
def __init__(self, *args):
super(XToolBar, self).__init__(*args)
# set custom properties
self._collapseButton = None
self._collapsable = True
self._collapsed = True
self._collapsedSize = 14
self._autoCollapsible = False
self._precollapseSize = None
self._shadowed = False
self._colored = False
# set standard options
self.layout().setSpacing(0)
self.layout().setContentsMargins(1, 1, 1, 1)
self.setMovable(False)
self.clear()
self.setMouseTracking(True)
self.setOrientation(Qt.Horizontal)
self.setCollapsed(False)
def autoCollapsible(self):
"""
Returns whether or not this toolbar is auto-collapsible. When
True, it will enter its collapsed state when the user hovers out
of the bar.
:return <bool>
"""
return self._autoCollapsible
def clear(self):
"""
Clears out this toolbar from the system.
"""
# preserve the collapse button
super(XToolBar, self).clear()
# clears out the toolbar
if self.isCollapsable():
self._collapseButton = QToolButton(self)
self._collapseButton.setAutoRaise(True)
self._collapseButton.setSizePolicy(QSizePolicy.Expanding,
QSizePolicy.Expanding)
self.addWidget(self._collapseButton)
self.refreshButton()
# create connection
self._collapseButton.clicked.connect(self.toggleCollapsed)
elif self._collapseButton:
self._collapseButton.setParent(None)
self._collapseButton.deleteLater()
self._collapseButton = None
def count(self):
"""
Returns the number of actions linked with this toolbar.
:return <int>
"""
return len(self.actions())
def collapseButton(self):
"""
Returns the collapsing button for this toolbar.
:return <QToolButton>
"""
return self._collapseButton
def isCollapsable(self):
"""
Returns whether or not this toolbar is collapsable.
:return <bool>
"""
return self._collapsable
def isCollapsed(self):
"""
Returns whether or not this toolbar is in a collapsed state.
:return <bool>
"""
return self._collapsed and self.isCollapsable()
def isColored(self):
"""
Returns whether or not to colorize the buttons on the toolbar
when they are highlighted.
:return <bool>
"""
return self._colored
def isShadowed(self):
"""
Returns whether or not to show this toolbar with shadows.
:return <bool>
"""
return self._shadowed
def refreshButton(self):
"""
Refreshes the button for this toolbar.
"""
collapsed = self.isCollapsed()
btn = self._collapseButton
if not btn:
return
btn.setMaximumSize(MAX_SIZE, MAX_SIZE)
# set up a vertical scrollbar
if self.orientation() == Qt.Vertical:
btn.setMaximumHeight(12)
else:
btn.setMaximumWidth(12)
icon = ''
# collapse/expand a vertical toolbar
if self.orientation() == Qt.Vertical:
if collapsed:
self.setFixedWidth(self._collapsedSize)
btn.setMaximumHeight(MAX_SIZE)
btn.setArrowType(Qt.RightArrow)
else:
self.setMaximumWidth(MAX_SIZE)
self._precollapseSize = None
btn.setMaximumHeight(12)
btn.setArrowType(Qt.LeftArrow)
else:
if collapsed:
self.setFixedHeight(self._collapsedSize)
btn.setMaximumWidth(MAX_SIZE)
btn.setArrowType(Qt.DownArrow)
else:
self.setMaximumHeight(1000)
self._precollapseSize = None
btn.setMaximumWidth(12)
btn.setArrowType(Qt.UpArrow)
for index in range(1, self.layout().count()):
item = self.layout().itemAt(index)
if not item.widget():
continue
if collapsed:
item.widget().setMaximumSize(0, 0)
else:
item.widget().setMaximumSize(MAX_SIZE, MAX_SIZE)
if not self.isCollapsable():
btn.hide()
else:
btn.show()
def resizeEvent(self, event):
super(XToolBar, self).resizeEvent(event)
if not self._collapsed:
if self.orientation() == Qt.Vertical:
self._precollapseSize = self.width()
else:
self._precollapseSize = self.height()
def setAutoCollapsible(self, state):
"""
Sets whether or not this toolbar is auto-collapsible.
:param state | <bool>
"""
self._autoCollapsible = state
def setCollapsed(self, state):
"""
Sets whether or not this toolbar is in a collapsed state.
:return <bool> changed
"""
if state == self._collapsed:
return False
self._collapsed = state
self.refreshButton()
if not self.signalsBlocked():
self.collapseToggled.emit(state)
return True
def setCollapsable(self, state):
"""
Sets whether or not this toolbar is collapsable.
:param state | <bool>
"""
if self._collapsable == state:
return
self._collapsable = state
self.clear()
def setOrientation(self, orientation):
"""
Sets the orientation for this toolbar to the inputed value, and \
updates the contents margins and collapse button based on the vaule.
:param orientation | <Qt.Orientation>
"""
super(XToolBar, self).setOrientation(orientation)
self.refreshButton()
def setShadowed(self, state):
"""
Sets whether or not this toolbar is shadowed.
:param state | <bool>
"""
self._shadowed = state
if state:
self._colored = False
for child in self.findChildren(XToolButton):
child.setShadowed(state)
def setColored(self, state):
"""
Sets whether or not this toolbar is shadowed.
:param state | <bool>
"""
self._colored = state
if state:
self._shadowed = False
for child in self.findChildren(XToolButton):
child.setColored(state)
def toggleCollapsed(self):
"""
Toggles the collapsed state for this toolbar.
:return <bool> changed
"""
return self.setCollapsed(not self.isCollapsed())
x_shadowed = Property(bool, isShadowed, setShadowed)
x_colored = Property(bool, isColored, setColored)
class XToolBar(QToolBar):
collapseToggled = Signal(bool)
def __init__(self, *args):
super(XToolBar, self).__init__(*args)
# set custom properties
self._collapseButton = None
self._collapsable = True
self._collapsed = True
self._collapsedSize = 14
self._autoCollapsible = False
self._precollapseSize = None
self._shadowed = False
self._colored = False
# set standard options
self.layout().setSpacing(0)
self.layout().setContentsMargins(1, 1, 1, 1)
self.setMovable(False)
self.clear()
self.setMouseTracking(True)
self.setOrientation(Qt.Horizontal)
self.setCollapsed(False)
def autoCollapsible(self):
"""
Returns whether or not this toolbar is auto-collapsible. When
True, it will enter its collapsed state when the user hovers out
of the bar.
:return <bool>
"""
return self._autoCollapsible
def clear(self):
"""
Clears out this toolbar from the system.
"""
# preserve the collapse button
super(XToolBar, self).clear()
# clears out the toolbar
if self.isCollapsable():
self._collapseButton = QToolButton(self)
self._collapseButton.setAutoRaise(True)
self._collapseButton.setSizePolicy(QSizePolicy.Expanding,
QSizePolicy.Expanding)
self.addWidget(self._collapseButton)
self.refreshButton()
# create connection
self._collapseButton.clicked.connect(self.toggleCollapsed)
elif self._collapseButton:
self._collapseButton.setParent(None)
self._collapseButton.deleteLater()
self._collapseButton = None
def count(self):
"""
Returns the number of actions linked with this toolbar.
:return <int>
"""
return len(self.actions())
def collapseButton(self):
"""
Returns the collapsing button for this toolbar.
:return <QToolButton>
"""
return self._collapseButton
def isCollapsable(self):
"""
Returns whether or not this toolbar is collapsable.
:return <bool>
"""
return self._collapsable
def isCollapsed( self ):
"""
Returns whether or not this toolbar is in a collapsed state.
:return <bool>
"""
return self._collapsed and self.isCollapsable()
def isColored(self):
"""
Returns whether or not to colorize the buttons on the toolbar
when they are highlighted.
:return <bool>
"""
return self._colored
def isShadowed(self):
"""
Returns whether or not to show this toolbar with shadows.
:return <bool>
"""
return self._shadowed
def refreshButton(self):
"""
Refreshes the button for this toolbar.
"""
collapsed = self.isCollapsed()
btn = self._collapseButton
if not btn:
return
btn.setMaximumSize(MAX_SIZE, MAX_SIZE)
# set up a vertical scrollbar
if self.orientation() == Qt.Vertical:
btn.setMaximumHeight(12)
else:
btn.setMaximumWidth(12)
icon = ''
# collapse/expand a vertical toolbar
if self.orientation() == Qt.Vertical:
if collapsed:
self.setFixedWidth(self._collapsedSize)
btn.setMaximumHeight(MAX_SIZE)
btn.setArrowType(Qt.RightArrow)
else:
self.setMaximumWidth(MAX_SIZE)
self._precollapseSize = None
btn.setMaximumHeight(12)
btn.setArrowType(Qt.LeftArrow)
else:
if collapsed:
self.setFixedHeight(self._collapsedSize)
btn.setMaximumWidth(MAX_SIZE)
btn.setArrowType(Qt.DownArrow)
else:
self.setMaximumHeight(1000)
self._precollapseSize = None
btn.setMaximumWidth(12)
btn.setArrowType(Qt.UpArrow)
for index in range(1, self.layout().count()):
item = self.layout().itemAt(index)
if not item.widget():
continue
if collapsed:
item.widget().setMaximumSize(0, 0)
else:
item.widget().setMaximumSize(MAX_SIZE, MAX_SIZE)
if not self.isCollapsable():
btn.hide()
else:
btn.show()
def resizeEvent(self, event):
super(XToolBar, self).resizeEvent(event)
if not self._collapsed:
if self.orientation() == Qt.Vertical:
self._precollapseSize = self.width()
else:
self._precollapseSize = self.height()
def setAutoCollapsible(self, state):
"""
Sets whether or not this toolbar is auto-collapsible.
:param state | <bool>
"""
self._autoCollapsible = state
def setCollapsed(self, state):
"""
Sets whether or not this toolbar is in a collapsed state.
:return <bool> changed
"""
if state == self._collapsed:
return False
self._collapsed = state
self.refreshButton()
if not self.signalsBlocked():
self.collapseToggled.emit(state)
return True
def setCollapsable(self, state):
"""
Sets whether or not this toolbar is collapsable.
:param state | <bool>
"""
if self._collapsable == state:
return
self._collapsable = state
self.clear()
def setOrientation( self, orientation ):
"""
Sets the orientation for this toolbar to the inputed value, and \
updates the contents margins and collapse button based on the vaule.
:param orientation | <Qt.Orientation>
"""
super(XToolBar, self).setOrientation(orientation)
self.refreshButton()
def setShadowed(self, state):
"""
Sets whether or not this toolbar is shadowed.
:param state | <bool>
"""
self._shadowed = state
if state:
self._colored = False
for child in self.findChildren(XToolButton):
child.setShadowed(state)
def setColored(self, state):
"""
Sets whether or not this toolbar is shadowed.
:param state | <bool>
"""
self._colored = state
if state:
self._shadowed = False
for child in self.findChildren(XToolButton):
child.setColored(state)
def toggleCollapsed( self ):
"""
Toggles the collapsed state for this toolbar.
:return <bool> changed
"""
return self.setCollapsed(not self.isCollapsed())
x_shadowed = Property(bool, isShadowed, setShadowed)
x_colored = Property(bool, isColored, setColored)
