Wizualizacja konfiguracji dłoni  1.0
Dokumentacja klasy QCPItemText

A text label. Więcej...

#include <qcustomplot.hh>

Diagram dziedziczenia dla QCPItemText
Diagram współpracy dla QCPItemText:

Metody publiczne

 QCPItemText (QCustomPlot *parentPlot)
 
virtual ~QCPItemText ()
 
QColor color () const
 
QColor selectedColor () const
 
QPen pen () const
 
QPen selectedPen () const
 
QBrush brush () const
 
QBrush selectedBrush () const
 
QFont font () const
 
QFont selectedFont () const
 
QString text () const
 
Qt::Alignment positionAlignment () const
 
Qt::Alignment textAlignment () const
 
double rotation () const
 
QMargins padding () const
 
void setColor (const QColor &color)
 
void setSelectedColor (const QColor &color)
 
void setPen (const QPen &pen)
 
void setSelectedPen (const QPen &pen)
 
void setBrush (const QBrush &brush)
 
void setSelectedBrush (const QBrush &brush)
 
void setFont (const QFont &font)
 
void setSelectedFont (const QFont &font)
 
void setText (const QString &text)
 
void setPositionAlignment (Qt::Alignment alignment)
 
void setTextAlignment (Qt::Alignment alignment)
 
void setRotation (double degrees)
 
void setPadding (const QMargins &padding)
 
virtual double selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE
 
- Metody publiczne dziedziczone z QCPAbstractItem
 QCPAbstractItem (QCustomPlot *parentPlot)
 
virtual ~QCPAbstractItem ()
 
bool clipToAxisRect () const
 
QCPAxisRectclipAxisRect () const
 
bool selectable () const
 
bool selected () const
 
void setClipToAxisRect (bool clip)
 
void setClipAxisRect (QCPAxisRect *rect)
 
Q_SLOT void setSelectable (bool selectable)
 
Q_SLOT void setSelected (bool selected)
 
QList< QCPItemPosition * > positions () const
 
QList< QCPItemAnchor * > anchors () const
 
QCPItemPositionposition (const QString &name) const
 
QCPItemAnchoranchor (const QString &name) const
 
bool hasAnchor (const QString &name) const
 
- Metody publiczne dziedziczone z QCPLayerable
 QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=0)
 
virtual ~QCPLayerable ()
 
bool visible () const
 
QCustomPlotparentPlot () const
 
QCPLayerableparentLayerable () const
 
QCPLayerlayer () const
 
bool antialiased () const
 
void setVisible (bool on)
 
Q_SLOT bool setLayer (QCPLayer *layer)
 
bool setLayer (const QString &layerName)
 
void setAntialiased (bool enabled)
 
bool realVisibility () const
 

Atrybuty publiczne

QCPItemPosition *const position
 
QCPItemAnchor *const topLeft
 
QCPItemAnchor *const top
 
QCPItemAnchor *const topRight
 
QCPItemAnchor *const right
 
QCPItemAnchor *const bottomRight
 
QCPItemAnchor *const bottom
 
QCPItemAnchor *const bottomLeft
 
QCPItemAnchor *const left
 

Typy chronione

enum  AnchorIndex {
  aiTopLeft, aiTop, aiTopRight, aiRight,
  aiBottomRight, aiBottom, aiBottomLeft, aiLeft
}
 

Metody chronione

virtual void draw (QCPPainter *painter) Q_DECL_OVERRIDE
 
virtual QPointF anchorPixelPosition (int anchorId) const Q_DECL_OVERRIDE
 
QPointF getTextDrawPoint (const QPointF &pos, const QRectF &rect, Qt::Alignment positionAlignment) const
 
QFont mainFont () const
 
QColor mainColor () const
 
QPen mainPen () const
 
QBrush mainBrush () const
 
- Metody chronione dziedziczone z QCPAbstractItem
virtual QCP::Interaction selectionCategory () const Q_DECL_OVERRIDE
 
virtual QRect clipRect () const Q_DECL_OVERRIDE
 
virtual void applyDefaultAntialiasingHint (QCPPainter *painter) const Q_DECL_OVERRIDE
 
virtual void selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE
 
virtual void deselectEvent (bool *selectionStateChanged) Q_DECL_OVERRIDE
 
double rectDistance (const QRectF &rect, const QPointF &pos, bool filledRect) const
 
QCPItemPositioncreatePosition (const QString &name)
 
QCPItemAnchorcreateAnchor (const QString &name, int anchorId)
 
- Metody chronione dziedziczone z QCPLayerable
virtual void parentPlotInitialized (QCustomPlot *parentPlot)
 
virtual void mousePressEvent (QMouseEvent *event, const QVariant &details)
 
virtual void mouseMoveEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos)
 
virtual void mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details)
 
virtual void wheelEvent (QWheelEvent *event)
 
void initializeParentPlot (QCustomPlot *parentPlot)
 
void setParentLayerable (QCPLayerable *parentLayerable)
 
bool moveToLayer (QCPLayer *layer, bool prepend)
 
void applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const
 

Atrybuty chronione

QColor mColor
 
QColor mSelectedColor
 
QPen mPen
 
QPen mSelectedPen
 
QBrush mBrush
 
QBrush mSelectedBrush
 
QFont mFont
 
QFont mSelectedFont
 
QString mText
 
Qt::Alignment mPositionAlignment
 
Qt::Alignment mTextAlignment
 
double mRotation
 
QMargins mPadding
 
- Atrybuty chronione dziedziczone z QCPAbstractItem
bool mClipToAxisRect
 
QPointer< QCPAxisRectmClipAxisRect
 
QList< QCPItemPosition * > mPositions
 
QList< QCPItemAnchor * > mAnchors
 
bool mSelectable
 
bool mSelected
 
- Atrybuty chronione dziedziczone z QCPLayerable
bool mVisible
 
QCustomPlotmParentPlot
 
QPointer< QCPLayerablemParentLayerable
 
QCPLayermLayer
 
bool mAntialiased
 

Dodatkowe Dziedziczone Składowe

- Sygnały dziedziczone z QCPAbstractItem
void selectionChanged (bool selected)
 
void selectableChanged (bool selectable)
 
- Sygnały dziedziczone z QCPLayerable
void layerChanged (QCPLayer *newLayer)
 

Opis szczegółowy

QCPItemText.png
Text example. Blue dotted circles are anchors, solid blue discs are positions.

Its position is defined by the member position and the setting of setPositionAlignment. The latter controls which part of the text rect shall be aligned with position.

The text alignment itself (i.e. left, center, right) can be controlled with setTextAlignment.

The text may be rotated around the position point with setRotation.

Dokumentacja składowych wyliczanych

enum QCPItemText::AnchorIndex
protected
Wartości wyliczeń
aiTopLeft 
aiTop 
aiTopRight 
aiRight 
aiBottomRight 
aiBottom 
aiBottomLeft 
aiLeft 

Dokumentacja konstruktora i destruktora

QCPItemText::QCPItemText ( QCustomPlot parentPlot)
explicit

Creates a text item and sets default values.

The created item is automatically registered with parentPlot. This QCustomPlot instance takes ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead.

QCPItemText::~QCPItemText ( )
virtual

Dokumentacja funkcji składowych

QPointF QCPItemText::anchorPixelPosition ( int  anchorId) const
protectedvirtual

Reimplementowana z QCPAbstractItem.

QBrush QCPItemText::brush ( ) const
inline
QColor QCPItemText::color ( ) const
inline
void QCPItemText::draw ( QCPPainter painter)
protectedvirtual

Implementuje QCPAbstractItem.

QFont QCPItemText::font ( ) const
inline
QPointF QCPItemText::getTextDrawPoint ( const QPointF &  pos,
const QRectF &  rect,
Qt::Alignment  positionAlignment 
) const
protected
QBrush QCPItemText::mainBrush ( ) const
protected
QColor QCPItemText::mainColor ( ) const
protected
QFont QCPItemText::mainFont ( ) const
protected
QPen QCPItemText::mainPen ( ) const
protected
QMargins QCPItemText::padding ( ) const
inline
QPen QCPItemText::pen ( ) const
inline
Qt::Alignment QCPItemText::positionAlignment ( ) const
inline
double QCPItemText::rotation ( ) const
inline
QBrush QCPItemText::selectedBrush ( ) const
inline
QColor QCPItemText::selectedColor ( ) const
inline
QFont QCPItemText::selectedFont ( ) const
inline
QPen QCPItemText::selectedPen ( ) const
inline
double QCPItemText::selectTest ( const QPointF &  pos,
bool  onlySelectable,
QVariant *  details = 0 
) const
virtual

This function is used to decide whether a click hits a layerable object 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 object. If the object is either invisible or the distance couldn't be determined, -1.0 is returned. Further, if onlySelectable is true and the object is not selectable, -1.0 is returned, too.

If the object is represented not by single lines but by an area like a QCPItemText or the bars of a QCPBars plottable, a click inside the area should also be considered a hit. In these cases this function thus returns a constant value greater zero but still below the parent plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99).

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, and the finally selected object is notified via the selectEvent/deselectEvent methods.

details is an optional output parameter. Every layerable subclass may place any information in details. This information will be passed to selectEvent when the parent QCustomPlot decides on the basis of this selectTest call, that the object was successfully selected. The subsequent call to selectEvent will carry the details. This is useful for multi-part objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked is only done once in selectTest. The result (i.e. the actually clicked part) can then be placed in details. So in the subsequent selectEvent, the decision which part was selected doesn't have to be done a second time for a single selection operation.

You may pass 0 as details to indicate that you are not interested in those selection details.

Zobacz również
selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions

Implementuje QCPAbstractItem.

void QCPItemText::setBrush ( const QBrush &  brush)

Sets the brush that will be used do fill the background of the text. To disable the background, set brush to Qt::NoBrush.

Zobacz również
setSelectedBrush, setPen, setPadding
void QCPItemText::setColor ( const QColor &  color)

Sets the color of the text.

void QCPItemText::setFont ( const QFont &  font)

Sets the font of the text.

Zobacz również
setSelectedFont, setColor
void QCPItemText::setPadding ( const QMargins &  padding)

Sets the distance between the border of the text rectangle and the text. The appearance (and visibility) of the text rectangle can be controlled with setPen and setBrush.

void QCPItemText::setPen ( const QPen &  pen)

Sets the pen that will be used do draw a rectangular border around the text. To disable the border, set pen to Qt::NoPen.

Zobacz również
setSelectedPen, setBrush, setPadding
void QCPItemText::setPositionAlignment ( Qt::Alignment  alignment)

Sets which point of the text rect shall be aligned with position.

Examples:

  • If alignment is Qt::AlignHCenter | Qt::AlignTop, the text will be positioned such that the top of the text rect will be horizontally centered on position.
  • If alignment is Qt::AlignLeft | Qt::AlignBottom, position will indicate the bottom left corner of the text rect.

If you want to control the alignment of (multi-lined) text within the text rect, use setTextAlignment.

void QCPItemText::setRotation ( double  degrees)

Sets the angle in degrees by which the text (and the text rectangle, if visible) will be rotated around position.

void QCPItemText::setSelectedBrush ( const QBrush &  brush)

Sets the brush that will be used do fill the background of the text, when the item is selected. To disable the background, set brush to Qt::NoBrush.

Zobacz również
setBrush
void QCPItemText::setSelectedColor ( const QColor &  color)

Sets the color of the text that will be used when the item is selected.

void QCPItemText::setSelectedFont ( const QFont &  font)

Sets the font of the text that will be used when the item is selected.

Zobacz również
setFont
void QCPItemText::setSelectedPen ( const QPen &  pen)

Sets the pen that will be used do draw a rectangular border around the text, when the item is selected. To disable the border, set pen to Qt::NoPen.

Zobacz również
setPen
void QCPItemText::setText ( const QString &  text)

Sets the text that will be displayed. Multi-line texts are supported by inserting a line break character, e.g. '
'.

Zobacz również
setFont, setColor, setTextAlignment
void QCPItemText::setTextAlignment ( Qt::Alignment  alignment)

Controls how (multi-lined) text is aligned inside the text rect (typically Qt::AlignLeft, Qt::AlignCenter or Qt::AlignRight).

QString QCPItemText::text ( ) const
inline
Qt::Alignment QCPItemText::textAlignment ( ) const
inline

Dokumentacja atrybutów składowych

QCPItemAnchor* const QCPItemText::bottom
QCPItemAnchor* const QCPItemText::bottomLeft
QCPItemAnchor* const QCPItemText::bottomRight
QCPItemAnchor* const QCPItemText::left
QBrush QCPItemText::mBrush
protected
QColor QCPItemText::mColor
protected
QFont QCPItemText::mFont
protected
QMargins QCPItemText::mPadding
protected
QPen QCPItemText::mPen
protected
Qt::Alignment QCPItemText::mPositionAlignment
protected
double QCPItemText::mRotation
protected
QBrush QCPItemText::mSelectedBrush
protected
QColor QCPItemText::mSelectedColor
protected
QFont QCPItemText::mSelectedFont
protected
QPen QCPItemText::mSelectedPen
protected
QString QCPItemText::mText
protected
Qt::Alignment QCPItemText::mTextAlignment
protected
QCPItemPosition* const QCPItemText::position
QCPItemAnchor* const QCPItemText::right
QCPItemAnchor* const QCPItemText::top
QCPItemAnchor* const QCPItemText::topLeft
QCPItemAnchor* const QCPItemText::topRight

Dokumentacja dla tej klasy została wygenerowana z plików: