Built-in Parameter Types¶
Parameters¶
- class pyqtgraph.parametertree.parameterTypes.ActionParameter(**opts)[source]¶
Used for displaying a button within the tree.
sigActivated(self)
is emitted when the button is clicked.- itemClass¶
alias of
pyqtgraph.parametertree.parameterTypes.action.ActionParameterItem
- class pyqtgraph.parametertree.parameterTypes.CalendarParameter(**opts)[source]¶
Displays a Qt calendar whose date is specified by a ‘format’ option.
Options:
format
Format for displaying the date and converting from a string. Can be any value accepted by QDate.toString and fromString, or a stringified version of a QDateFormat enum, i.e. ‘ISODate’, ‘TextDate’ (default), etc.
- class pyqtgraph.parametertree.parameterTypes.ChecklistParameter(**opts)[source]¶
Can be set just like a
ListParameter
, but allows for multiple values to be selected simultaneously.Options
exclusive
When False, any number of options can be selected. The resulting
value()
is a list of all checked values. When True, it behaves like alist
type – only one value can be selected. If no values are selected andexclusive
is set to True, the first available limit is selected. The return value of anexclusive
checklist is a single value rather than a list with one element.- itemClass¶
alias of
pyqtgraph.parametertree.parameterTypes.checklist.ChecklistParameterItem
- class pyqtgraph.parametertree.parameterTypes.ColorMapParameter(*args, **kargs)[source]¶
- itemClass¶
alias of
pyqtgraph.parametertree.parameterTypes.colormap.ColorMapParameterItem
- class pyqtgraph.parametertree.parameterTypes.ColorParameter(*args, **kargs)[source]¶
- itemClass¶
alias of
pyqtgraph.parametertree.parameterTypes.color.ColorParameterItem
- class pyqtgraph.parametertree.parameterTypes.FileParameter(**opts)[source]¶
Interfaces with the myriad of file options available from a QFileDialog.
Note that the output can either be a single file string or list of files, depending on whether fileMode=’ExistingFiles’ is specified.
Note that in all cases, absolute file paths are returned unless relativeTo is specified as elaborated below.
Options:
parent
Dialog parent
winTitle
Title of dialog window
nameFilter
File filter as required by the Qt dialog
directory
Where in the file system to open this dialog
selectFile
File to preselect
relativeTo
Parent directory that, if provided, will be removed from the prefix of all returned paths. So, if ‘/my/text/file.txt’ was selected, and relativeTo=’my/text/’, the return value would be ‘file.txt’. This uses os.path.relpath under the hood, so expect that behavior.
kwargs
Any enum value accepted by a QFileDialog and its value. Values can be a string or list of strings, i.e. fileMode=’AnyFile’, options=[‘ShowDirsOnly’, ‘DontResolveSymlinks’]
- class pyqtgraph.parametertree.parameterTypes.FontParameter(**opts)[source]¶
Creates and controls a QFont value. Be careful when selecting options from the font dropdown. since not all fonts are available on all systems
- class pyqtgraph.parametertree.parameterTypes.GroupParameter(**opts)[source]¶
Group parameters are used mainly as a generic parent item that holds (and groups!) a set of child parameters.
It also provides a simple mechanism for displaying a button or combo that can be used to add new parameters to the group. To enable this, the group must be initialized with the ‘addText’ option (the text will be displayed on a button which, when clicked, will cause addNew() to be called). If the ‘addList’ option is specified as well, then a dropdown-list of addable items will be displayed instead of a button.
- addNew(typ=None)[source]¶
This method is called when the user has requested to add a new item to the group. By default, it emits
sigAddNew(self, typ)
.
- itemClass¶
alias of
pyqtgraph.parametertree.parameterTypes.basetypes.GroupParameterItem
- class pyqtgraph.parametertree.parameterTypes.ListParameter(**opts)[source]¶
Parameter with a list of acceptable values.
By default, this parameter is represtented by a
ListParameterItem
, displaying a combo box to select a value from the list.In addition to the generic
Parameter
options, this parameter type accepts alimits
argument specifying the list of allowed values.The values may generally be of any data type, as long as they can be represented as a string. If the string representation provided is undesirable, the values may be given as a dictionary mapping the desired string representation to the value.
- itemClass¶
alias of
pyqtgraph.parametertree.parameterTypes.list.ListParameterItem
- class pyqtgraph.parametertree.parameterTypes.PenParameter(**opts)[source]¶
Controls the appearance of a QPen value.
When saveState is called, the value is encoded as (color, width, style, capStyle, joinStyle, cosmetic)
Options:
color
pen color, can be any argument accepted by
mkColor()
(defaults to black)width
integer width >= 0 (defaults to 1)
style
String version of QPenStyle enum, i.e. ‘SolidLine’ (default), ‘DashLine’, etc.
capStyle
String version of QPenCapStyle enum, i.e. ‘SquareCap’ (default), ‘RoundCap’, etc.
joinStyle
String version of QPenJoinStyle enum, i.e. ‘BevelJoin’ (default), ‘RoundJoin’, etc.
cosmetic
Boolean, whether or not the pen is cosmetic (defaults to True)
- class pyqtgraph.parametertree.parameterTypes.ProgressBarParameter(**opts)[source]¶
Displays a progress bar whose value can be set between 0 and 100
- class pyqtgraph.parametertree.parameterTypes.SimpleParameter(*args, **kargs)[source]¶
Parameter representing a single value.
This parameter is backed by
WidgetParameterItem
to represent the following parameter names through various subclasses:‘int’
‘float’
‘bool’
‘str’
‘color’
‘colormap’
- class pyqtgraph.parametertree.parameterTypes.SliderParameter(**opts)[source]¶
Options
limits
[start, stop] numbers
step:
Defaults to 1, the spacing between each slider tick
span:
Instead of limits + step, span can be set to specify the range of slider options (e.g. np.linspace(-pi, pi, 100))
format:
Format string to determine number of decimals to show, etc. Defaults to display based on span dtype
precision:
int number of decimals to keep for float tick spaces
- class pyqtgraph.parametertree.parameterTypes.TextParameter(**opts)[source]¶
Editable string, displayed as large text box in the tree.
- itemClass¶
alias of
pyqtgraph.parametertree.parameterTypes.text.TextParameterItem
ParameterItems¶
- class pyqtgraph.parametertree.parameterTypes.ActionParameterItem(param, depth)[source]¶
ParameterItem displaying a clickable button.
- class pyqtgraph.parametertree.parameterTypes.BoolParameterItem(param, depth)[source]¶
Registered parameter type which displays a QCheckBox
- class pyqtgraph.parametertree.parameterTypes.ChecklistParameterItem(param, depth)[source]¶
Wraps a
GroupParameterItem
to managebool
parameter children. Also provides convenience buttons to select or clear all values at once. Note these conveniences are disabled whenexclusive
is True.
- class pyqtgraph.parametertree.parameterTypes.ColorMapParameterItem(param, depth)[source]¶
Registered parameter type which displays a
GradientWidget
- class pyqtgraph.parametertree.parameterTypes.ColorParameterItem(param, depth)[source]¶
Registered parameter type which displays a
ColorButton
- class pyqtgraph.parametertree.parameterTypes.GroupParameterItem(param, depth)[source]¶
Group parameters are used mainly as a generic parent item that holds (and groups!) a set of child parameters. It also provides a simple mechanism for displaying a button or combo that can be used to add new parameters to the group.
- class pyqtgraph.parametertree.parameterTypes.ListParameterItem(param, depth)[source]¶
WidgetParameterItem subclass providing comboBox that lets the user select from a list of options.
- class pyqtgraph.parametertree.parameterTypes.NumericParameterItem(param, depth)[source]¶
Subclasses WidgetParameterItem to provide the following types:
Registered Types:
int
Displays a
SpinBox
in integer mode.float
Displays a
SpinBox
.