qarbon.qt.gui.groupbox

A colapsable container widget with (optional) title.

Here is a simple example that shows how to create a GroupBox with some content inside:

from qarbon.external.qt import QtGui
from qarbon.qt.gui.application import Application
from qarbon.qt.gui.icon import Icon
from qarbon.qt.gui.groupbox import GroupBox

app = Application()
panel = QtGui.QWidget()
layout = QtGui.QVBoxLayout()
panel.setLayout(layout)
gb = GroupBox()
layout.addWidget(gb)

gb.title = "Configuration"
gb.icon = Icon("applications-accessories")

content = QtGui.QWidget()
gb.setContent(content)
contentLayout = QtGui.QHBoxLayout()
content.setLayout(contentLayout)
label = QtGui.QLabel("File:")
edit = QtGui.QLineEdit()
button = QtGui.QPushButton(Icon("folder-open"), "Open a file...")
contentLayout.addWidget(label)
contentLayout.addWidget(edit)
contentLayout.addWidget(button)

panel.show()
app.exec_()

Classes

GroupBox

An expandable/collapsible container widget

class qarbon.qt.gui.groupbox.GroupBox(parent=None)

Bases: PyQt4.QtGui.QWidget

An expandable/collapsible container widget

DefaultContentVisible = True

DefaultTitleBarVisible = True

DefaultTitleBarHeight = 16

DefaultStyle = {'content_start_color': 'rgb(224, 224, 224)', 'content_border_radius': '4px', 'title_stop_color': 'rgb(0, 65, 200)', 'title_border_radius': '4px', 'title_font_color': 'white', 'title_start_color': 'rgb(60, 150, 255)', 'content_stop_color': 'rgb(255, 255, 255)'}

content()

Returns the contents widget

Returns:the current content widget or None if no content is set Return type:QWidget

setContent(qwidget)

Sets the content widget

Parameters:qwidget (QWidget) – the content widget or None

titleBar()

Returns the title bar widget

Returns:the title bar widget Return type:QFrame

titleButton()

Returns the title button widget

Returns:the title button widget Return type:QToolButton

collapseButton()

Returns the collapse button widget

Returns:the collapse button widget Return type:QToolButton

setTitle(title)

Sets this widget’s title

:param title:the new widget title :type title: str

getTitle()

Returns this widget’s title

Returns:this widget’s title Return type:str

setTitleIcon(icon)

Sets this widget’s title icon

Parameters:icon – (Qt.QIcon) the new widget title icon

getTitleIcon()

Returns this widget’s title icon

Returns:this widget’s title icon Return type:QIcon

switchContentVisible()

Switches this widget’s contents visibility

isContentVisible()

Returns this widget’s contents visibility

Returns:this widget’s contents visibility Return type:bool

resetContentVisible()

Resets this widget’s contents visibility

setContentVisible(show)

Sets this widget’s contents visibility

Parameters:show (bool) – the new widget contents visibility

isTitleVisible()

Returns this widget’s title visibility

Returns:this widget’s title visibility Return type:bool

resetTitleVisible()

Resets this widget’s title visibility

setTitleVisible(show)

Sets this widget’s title visibility

Parameters:show (bool) – the new widget title visibility

getTitleHeight()

Returns this widget’s title height

Returns:this widget’s title height Return type:int

setTitleHeight(height)

Sets this widget’s title height

Parameters:height (int) – the new widget title height

resetTitleHeight()

Resets this widget’s title height

getStyleMap()

Returns this widget’s style

Returns:this widget’s style Return type:dict

setStyleMap(style_map)

Sets this widget’s title style Used key/values for style_map:

• ‘title_start_color’ : brush (Ex.: ‘#E0E0E0’)
• ‘title_stop_color’ : brush (Ex.: ‘#E0E0E0’)
• ‘title_font_color’ : brush (Ex.: ‘#E0E0E0’)
• ‘title_border_radius’: radius (Ex.: ‘5px’)
• ‘content_start_color’ : brush (Ex.: ‘#E0E0E0’)
• ‘content_stop_color’ : brush (Ex.: ‘#E0E0E0’)
• ‘content_border_radius’: radius (Ex.: ‘5px’)

Parameters:style_map (dict) – the new widget title style

resetStyleMap()

Resets this widget’s title style

classmethod getQtDesignerPluginInfo()

title = <PyQt4.QtCore.pyqtProperty object at 0x36d26d0>

This property contains the widget’s title

Access functions:

• getTitle()
• setTitle()

titleIcon = <PyQt4.QtCore.pyqtProperty object at 0x36d2710>

This property contains the widget’s title icon

Access functions:

• getTitleIcon()
• setTitleIcon()

titleHeight = <PyQt4.QtCore.pyqtProperty object at 0x36d2750>

This property contains the widget’s title height

Access functions:

• getTitleHeight()
• setTitleHeight()
• resetTitleHeight()

titleVisible = <PyQt4.QtCore.pyqtProperty object at 0x36d2790>

This property contains the widget’s title visibility

Access functions:

• isTitleVisible()
• setTitleVisible()

styleMap = <PyQt4.QtCore.pyqtProperty object at 0x36d27d0>

This property contains the widget’s style map

Access functions:

• getStyleMap()
• setStyleMap()
• resetStyleMap()

contentVisible = <PyQt4.QtCore.pyqtProperty object at 0x36d2810>

This property contains the widget’s content’s visibility

Access functions:

• isContentVisible()
• setContentVisible()
• resetContentVisible()