![]() |
.Simulation
|
A bracket for referencing/highlighting certain parts in the plot. More...
Public Types | |
enum | BracketStyle { bsSquare, bsRound, bsCurly, bsCalligraphic } |
Public Member Functions | |
QCPItemBracket (QCustomPlot *parentPlot) | |
Creates a bracket item and sets default values. More... | |
QPen | pen () const |
QPen | selectedPen () const |
double | length () const |
BracketStyle | style () const |
void | setPen (const QPen &pen) |
Sets the pen that will be used to draw the bracket. More... | |
void | setSelectedPen (const QPen &pen) |
Sets the pen that will be used to draw the bracket when selected. More... | |
void | setLength (double length) |
Sets the length in pixels how far the bracket extends in the direction towards the embraced span of the bracket (i.e. More... | |
void | setStyle (BracketStyle style) |
Sets the style of the bracket, i.e. More... | |
virtual double | selectTest (const QPointF &pos) const |
This function is used to decide whether a click hits an item or not. More... | |
![]() | |
QCPAbstractItem (QCustomPlot *parentPlot) | |
Base class constructor which initializes base class members. | |
bool | clipToAxisRect () const |
QCPAxis * | clipKeyAxis () const |
QCPAxis * | clipValueAxis () const |
bool | selectable () const |
bool | selected () const |
void | setClipToAxisRect (bool clip) |
Sets whether the item shall be clipped to the axis rect or whether it shall be visible on the entire QCustomPlot. More... | |
void | setClipAxes (QCPAxis *keyAxis, QCPAxis *valueAxis) |
Sets both clip axes. More... | |
void | setClipKeyAxis (QCPAxis *axis) |
Sets the clip key axis. More... | |
void | setClipValueAxis (QCPAxis *axis) |
Sets the clip value axis. More... | |
void | setSelectable (bool selectable) |
Sets whether the user can (de-)select this item by clicking on the QCustomPlot surface. More... | |
void | setSelected (bool selected) |
Sets whether this item is selected or not. More... | |
QList< QCPItemPosition * > | positions () const |
Returns all positions of the item in a list. More... | |
QList< QCPItemAnchor * > | anchors () const |
Returns all anchors of the item in a list. More... | |
QCPItemPosition * | position (const QString &name) const |
Returns the QCPItemPosition with the specified name. More... | |
QCPItemAnchor * | anchor (const QString &name) const |
Returns the QCPItemAnchor with the specified name. More... | |
bool | hasAnchor (const QString &name) const |
Returns whether this item has an anchor with the specified name. More... | |
![]() | |
QCPLayerable (QCustomPlot *parentPlot) | |
Creates a new QCPLayerable instance. More... | |
bool | visible () const |
QCustomPlot * | parentPlot () const |
QCPLayer * | layer () const |
bool | antialiased () const |
void | setVisible (bool on) |
Sets the visibility of this layerable object. More... | |
bool | setLayer (QCPLayer *layer) |
Sets the layer of this layerable object. More... | |
bool | setLayer (const QString &layerName) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Sets the layer of this layerable object by name. More... | |
void | setAntialiased (bool enabled) |
Sets whether this object will be drawn antialiased or not. More... | |
Public Attributes | |
QCPItemPosition *const | left |
QCPItemPosition *const | right |
QCPItemAnchor *const | center |
Protected Types | |
enum | AnchorIndex { aiCenter } |
Protected Member Functions | |
virtual void | draw (QCPPainter *painter) |
virtual QPointF | anchorPixelPoint (int anchorId) const |
QPen | mainPen () const |
![]() | |
virtual QRect | clipRect () const |
virtual void | applyDefaultAntialiasingHint (QCPPainter *painter) const |
double | distSqrToLine (const QPointF &start, const QPointF &end, const QPointF &point) const |
double | rectSelectTest (const QRectF &rect, const QPointF &pos, bool filledRect) const |
QCPItemPosition * | createPosition (const QString &name) |
QCPItemAnchor * | createAnchor (const QString &name, int anchorId) |
![]() | |
bool | moveToLayer (QCPLayer *layer, bool prepend) |
void | applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const |
Protected Attributes | |
QPen | mPen |
QPen | mSelectedPen |
double | mLength |
BracketStyle | mStyle |
![]() | |
bool | mClipToAxisRect |
QCPAxis * | mClipKeyAxis |
QCPAxis * | mClipValueAxis |
bool | mSelectable |
bool | mSelected |
QList< QCPItemPosition * > | mPositions |
QList< QCPItemAnchor * > | mAnchors |
![]() | |
bool | mVisible |
QCustomPlot * | mParentPlot |
QCPLayer * | mLayer |
bool | mAntialiased |
Additional Inherited Members | |
![]() | |
void | selectionChanged (bool selected) |
This signal is emitted when the selection state of this item has changed, either by user interaction or by a direct call to setSelected. | |
A bracket for referencing/highlighting certain parts in the plot.
It has two positions, left and right, which define the span of the bracket. If left is actually farther to the left than right, the bracket is opened to the bottom, as shown in the example image.
The bracket supports multiple styles via setStyle. The length, i.e. how far the bracket stretches away from the embraced span, can be controlled with setLength.
It provides an anchor center, to allow connection of other items, e.g. an arrow (QCPItemLine or QCPItemCurve) or a text label (QCPItemText), to the bracket.
QCPlot::QCPItemBracket::QCPItemBracket | ( | QCustomPlot * | parentPlot | ) |
Creates a bracket item and sets default values.
The constructed item can be added to the plot with QCustomPlot::addItem.
|
virtual |
This function is used to decide whether a click hits an item or not.
pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the shortest pixel distance of this point to the item. If the item is either invisible or the distance couldn't be determined, -1.0 is returned. setSelectable has no influence on the return value of this function.
If the item is represented not by single lines but by an area like QCPItemRect or QCPItemText, a click inside the area returns a constant value greater zero (typically 99% of the selectionTolerance of the parent QCustomPlot). If the click lies outside the area, this function returns -1.0.
Providing a constant value for area objects allows selecting line objects even when they are obscured by such area objects, by clicking close to the lines (i.e. closer than 0.99*selectionTolerance).
The actual setting of the selection state is not done by this function. This is handled by the parent QCustomPlot when the mouseReleaseEvent occurs.
Implements QCPlot::QCPAbstractItem.
void QCPlot::QCPItemBracket::setLength | ( | double | length | ) |
Sets the length in pixels how far the bracket extends in the direction towards the embraced span of the bracket (i.e.
perpendicular to the left-right-direction)
void QCPlot::QCPItemBracket::setPen | ( | const QPen & | pen | ) |
Sets the pen that will be used to draw the bracket.
Note that when the style is bsCalligraphic, only the color will be taken from the pen, the stroke and width are ignored. To change the apparent stroke width of a calligraphic bracket, use setLength, which has a similar effect.
void QCPlot::QCPItemBracket::setSelectedPen | ( | const QPen & | pen | ) |
Sets the pen that will be used to draw the bracket when selected.
void QCPlot::QCPItemBracket::setStyle | ( | QCPItemBracket::BracketStyle | style | ) |