ASCEE/pyqtgraph
5
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Docstring updates for ParameterTree

Browse Source
This commit is contained in:
Luke Campagnola 2014-05-10 15:30:51 -04:00
parent 6a4a653989
commit 88c55c9f98
1 changed files with 39 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
pyqtgraph/parametertree/ParameterTree.py
View File

@ -7,9 +7,16 @@ from .ParameterItem import ParameterItem
class ParameterTree(TreeWidget): class ParameterTree(TreeWidget):
"""Widget used to display or control data from a ParameterSet""" """Widget used to display or control data from a hierarchy of Parameters"""
def __init__(self, parent=None, showHeader=True): def __init__(self, parent=None, showHeader=True):
"""
============== ========================================================
**Arguments:**
parent (QWidget) An optional parent widget
showHeader (bool) If True, then the QTreeView header is displayed.
============== ========================================================
"""
TreeWidget.__init__(self, parent) TreeWidget.__init__(self, parent)
self.setVerticalScrollMode(self.ScrollPerPixel) self.setVerticalScrollMode(self.ScrollPerPixel)
self.setHorizontalScrollMode(self.ScrollPerPixel) self.setHorizontalScrollMode(self.ScrollPerPixel)
@ -25,10 +32,35 @@ class ParameterTree(TreeWidget):
self.setRootIsDecorated(False) self.setRootIsDecorated(False)
def setParameters(self, param, showTop=True): def setParameters(self, param, showTop=True):
"""
Set the top-level :class:`Parameter <pyqtgraph.parametertree.Parameter>`
to be displayed in this ParameterTree.
If *showTop* is False, then the top-level parameter is hidden and only
its children will be visible. This is a convenience method equivalent
to::
tree.clear()
tree.addParameters(param, showTop)
"""
self.clear() self.clear()
self.addParameters(param, showTop=showTop) self.addParameters(param, showTop=showTop)
def addParameters(self, param, root=None, depth=0, showTop=True): def addParameters(self, param, root=None, depth=0, showTop=True):
"""
Adds one top-level :class:`Parameter <pyqtgraph.parametertree.Parameter>`
to the view.
============== ==========================================================
**Arguments:**
param The :class:`Parameter <pyqtgraph.parametertree.Parameter>`
to add.
root The item within the tree to which *param* should be added.
By default, *param* is added as a top-level item.
showTop If False, then *param* will be hidden, and only its
children will be visible in the tree.
============== ==========================================================
"""
item = param.makeTreeItem(depth=depth) item = param.makeTreeItem(depth=depth)
if root is None: if root is None:
root = self.invisibleRootItem() root = self.invisibleRootItem()
@ -45,11 +77,14 @@ class ParameterTree(TreeWidget):
self.addParameters(ch, root=item, depth=depth+1) self.addParameters(ch, root=item, depth=depth+1)
def clear(self): def clear(self):
"""
Remove all parameters from the tree.
"""
self.invisibleRootItem().takeChildren() self.invisibleRootItem().takeChildren()
def focusNext(self, item, forward=True): def focusNext(self, item, forward=True):
## Give input focus to the next (or previous) item after 'item' """Give input focus to the next (or previous) item after *item*
"""
while True: while True:
parent = item.parent() parent = item.parent()
if parent is None: if parent is None: