BarSet QML Type
Represents one set of bars in a bar graph. More...
Import Statement: | import QtGraphs |
In C++: | QBarSet |
- List of all members, including inherited members
- BarSet is part of Qt Graphs QML Types for 2D.
Properties
- borderColor : color
- borderWidth : real
- color : color
- count : int
- label : string
- labelColor : color
- selectedBars : list
- selectedColor : color
- values : QVariantList
Signals
- borderColorChanged(color)
- borderWidthChanged(real width)
- colorChanged(color)
- countChanged()
- labelChanged()
- labelColorChanged(color)
- selectedBarsChanged(list<int> indexes)
- selectedColorChanged(color color)
- update()
- updatedBars()
- valueAdded(int index, int count)
- valueChanged(int index)
- valueRemoved(int index, int count)
- valuesAdded(int index, int count)
- valuesChanged()
- valuesRemoved(int index, int count)
Methods
- append(list<real> values)
- append(real value)
- real at(int index)
- clear()
- int count()
- deselectAllBars()
- deselectBar(int index)
- deselectBars(list<int> indexes)
- insert(int index, real value)
- bool isBarSelected(int index)
- remove(int index, int count)
- replace(int index, real value)
- selectAllBars()
- selectBar(int index)
- selectBars(list<int> indexes)
- setBarSelected(int index, bool selected)
- real sum()
- toggleSelection(list<int> indexes)
Detailed Description
A bar set contains one data value for each category. The first value of a set is assumed to belong to the first category, the second one to the second category, and so on. If the set has fewer values than there are categories, the missing values are assumed to be located at the end of the set. For missing values in the middle of a set, the numerical value of zero is used. Labels for zero value sets are not shown.
See also BarSeries.
Property Documentation
borderColor : color |
The border color of the bar set.
borderWidth : real |
By default, the width is -1, meaning the border width is defined by the theme.
color : color |
The fill color of the bar set.
count : int |
The number of values in the bar set.
label : string |
The label of the bar set.
labelColor : color |
The text (label) color of the bar set.
selectedBars : list |
The indexes of the bars which are currently selected.
selectedColor : color |
The fill color of the selected set.
values : QVariantList |
The values of the bar set. You can set a list of either real or point types as values.
If you set a list of real types as values, they directly define the bar set values.
If you set a list of point types as values, the x-coordinate of the point specifies its zero-based index in the bar set. The size of the bar set is the highest x-coordinate value + 1. If a point is missing for any x-coordinate between zero and the highest value, it gets the value zero.
For example, the following bar sets have equal values:
Signal Documentation
borderColorChanged(color) |
This signal is emitted when the border color of the bar set changes to color.
Note: The corresponding handler is onBorderColorChanged
.
borderWidthChanged(real width) |
This signal is emitted when the barset's border width changes. The new width is width.
Note: The corresponding handler is onBorderWidthChanged
.
colorChanged(color) |
This signal is emitted when the fill color of the bar set changes to color.
Note: The corresponding handler is onColorChanged
.
countChanged() |
This signal is emitted when the barset's value count changes.
Note: The corresponding handler is onCountChanged
.
labelChanged() |
This signal is emitted when the label of the bar set changes.
Note: The corresponding handler is onLabelChanged
.
See also label.
labelColorChanged(color) |
This signal is emitted when the text (label) color of the bar set changes to color.
Note: The corresponding handler is onLabelColorChanged
.
This signal is emitted when the selected bar changes. indexes is a list selected bar indexes.
Note: The corresponding handler is onSelectedBarsChanged
.
selectedColorChanged(color color) |
This signal is emitted when the selected bar color changes. The new color is color.
Note: The corresponding handler is onSelectedColorChanged
.
update() |
This signal is emitted when the barset is updated.
Note: The corresponding handler is onUpdate
.
updatedBars() |
This signal is emitted when the bars in this set are updated.
Note: The corresponding handler is onUpdatedBars
.
This signal is emitted when new values are added to the bar set. index indicates the position of the first inserted value, and count is the number of inserted values.
Note: The corresponding handler is onValueAdded
.
valueChanged(int index) |
This signal is emitted when the value at the position specified by index is modified.
Note: The corresponding handler is onValueChanged
.
This signal is emitted when values are removed from the bar set. index indicates the position of the first removed value, and count is the number of removed values.
Note: The corresponding handler is onValueRemoved
.
This signal is emitted when new values are added to the bar set. index indicates the position of the first inserted value, and count is the number of inserted values.
Note: The corresponding handler is onValuesAdded
.
valuesChanged() |
This signal is emitted when the values of the bar set change.
Note: The corresponding handler is onValuesChanged
.
This signal is emitted when values are removed from the bar set. index indicates the position of the first removed value, and count is the number of removed values.
Note: The corresponding handler is onValuesRemoved
.
Method Documentation
Appends the list of real values specified by values to the end of the bar set.
See also append().
append(real value) |
Appends the new value specified by value to the end of the bar set.
Returns the value specified by index from the bar set. If the index is out of bounds, 0.0 is returned.
clear() |
Removes all values from the set.
int count() |
Returns the number of values in a bar set.
deselectAllBars() |
deselectBar(int index) |
Marks multiple bars passed in an indexes list as deselected.
Note: Emits BarSet::selectedBarsChanged.
See also setBarSelected().
Inserts value in the position specified by index. The values following the inserted value are moved up one position.
See also remove().
Returns true
if the bar at the given index is among selected bars and false
otherwise.
Note: Selected bars are drawn using the selected color if it was specified using BarSet::setSelectedColor.
See also selectedBars, setBarSelected(), and selectedColor.
Removes the number of values specified by count from the bar set starting with the value specified by index.
If you leave out count, only the value specified by index is removed.
Adds the value specified by value to the bar set at the position specified by index.
selectAllBars() |
Marks all bars in the set as selected.
Note: Emits BarSet::selectedBarsChanged.
See also setBarSelected().
selectBar(int index) |
Marks the bar at index as selected.
Note: Emits BarSet::selectedBarsChanged.
See also setBarSelected().
Marks multiple bars passed in an indexes list as selected.
Note: Emits BarSet::selectedBarsChanged.
See also setBarSelected().
Marks the bar at index as either selected or deselected as specified by selected.
Note: Selected bars are drawn using the selected color if it was specified. Emits BarSet::selectedBarsChanged.
See also isBarSelected() and selectedColor.
real sum() |
Returns the sum of all values in the bar set.
Changes the selection state of bars at the given indexes to the opposite one.
Note: Emits BarSet::selectedBarsChanged.
See also setBarSelected().
© 2024 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.