Text item class. More...

#include <textitem.h>

Inheritance diagram for TextItem:

[legend]

Public Types
enum	Alignment { AlignLeft = 1 , AlignCentered , AlignRight }
	Text alignment. More...

enum	{ Type = UserType + Text }
	Specific QGraphicsItem type number for function type() More...

Public Types inherited from KplItem
enum	FillStyle { NoBrush , SolidPattern , HorPattern , VerPattern , CrossPattern , BDiagPattern , FDiagPattern , DiagCrossPattern }
	Fill styles. More...

enum	ItemType { Frame = 1 , Array , Function , ParFunction , Spline , Array3D , Function3D , Legend , Text , Line , Arrow , Arc , Rectangle , Ellipse , Image , ScaleBar }
	Item types. More...

enum	PenType { FramePen , GridPen , DataPen }
	Pen types. More...

enum	Symbol { Invisible = -17 , FilledOctagon , FilledHourglass , FilledTriangle , FilledSquare , FilledDiamond , FilledCircle , Umbrella , Ypsilon , Plus , Cross , OpenOctagon , OpenHourglass , OpenTriangle , OpenSquare , OpenDiamond , Dot , OpenCircle , SolidLine , DashLine1 , DashLine2 , DotLine1 , DashLine3 , DashDotLine , DashLine4 , DashLine5 , DotLine2 }
	Symbol types. More...

Public Member Functions
	TextItem (double x0=0, double y0=0, unsigned color=0, QGraphicsItem *parent=nullptr, const QString &text=QString(), bool visible=true, Alignment alignment=AlignLeft, double relSize=1, double dir=0)
	Constructor.

	TextItem (const KConfigGroup plo, unsigned color=0, QGraphicsItem parent=nullptr)
	Constructor.

	TextItem (const TextItem &a)
	Copy constructor.

virtual	~TextItem ()
	Destructor.

Alignment	alignment () const
	Returns horizontal alignment.

virtual QRectF	boundingRect () const override
	Calculates bounding rectangle.

double	dir () const
	Returns rotation angle in deg.

virtual void	paint (QPainter painter, const QStyleOptionGraphicsItem option, QWidget *widget=nullptr) override
	Paints item.

void	setAlignment (Alignment alignment)
	Sets alignment.

void	setDir (double dir)
	Sets rotation angle.

void	setProperties (const QTransform &m)
	Sets properties according to transformation matrix.

void	setSize ()
	Sets size according to transformation matrix.

void	setText (const QString &text)
	Sets text.

QString	text () const
	Returns text.

virtual int	type () const override
	Returns specific QGraphicsItem type number.

void	update ()
	Applies changes and forces redrawing.

void	writePlo (KConfigGroup *plo) const
	Writes into plot file.

Public Member Functions inherited from DecoItem
	DecoItem (unsigned color=0, double x0=0, double y0=0, double relSize=1)
	Constructor.

	DecoItem (const KConfigGroup *plo, unsigned color=0)
	Constructor.

virtual	~DecoItem ()
	Destructor.

unsigned	color () const
	Returns color.

void	setColor (unsigned color)
	Sets color.

void	setX0 (double x0)
	Sets x position.

void	setY0 (double y0)
	Sets y position.

void	updatePos (const QPointF &p, bool absolute=true)
	Updates position.

void	writePlo (KConfigGroup *plo, bool visible) const
	Writes into plot file.

double	x0 () const
	Returns x position in cm.

double	y0 () const
	Returns y position in cm.

Public Member Functions inherited from KplItem
	KplItem (double relSize=1)
	Constructor.

	KplItem (const KplItem &a)
	Copy constructor.

	KplItem (const KConfigGroup *plo)
	Constructor.

virtual	~KplItem ()
	Destructor.

void	readPlo (const KConfigGroup *plo)
	Initializes corresponding to plot file.

double	relSize () const
	Returns relative size of item.

void	setRelSize (double relSize)
	Sets relative size of item.

void	writePlo (KConfigGroup *plo, bool visible=true) const
	Writes into plot file.

Static Public Member Functions
static void	setText (QTextDocument &doc, const QString &text, unsigned color=0)
	Sets text.

Static Public Member Functions inherited from KplItem
static QUrl	absoluteUrl (const QString &path, const QUrl &urlPlo)
	Constructs absolute file URL.

static QBrush	createBrush (unsigned color, FillStyle fillStyle=NoBrush)
	Creates brush.

static QPen	createPen (double width, unsigned color, PenType penType, Symbol symbol)
	Creates pen.

static void	paintSymbol (QPainter *painter, const QRectF &rect, Symbol symbol=OpenCircle)
	Paints symbol.

static QPixmap	pixmap (Symbol symbol)
	Returns black decoration pixmap of plot symbol for use in dialog GUI.

static QPixmap	pixmap (QPen pen, Symbol symbol=SolidLine)
	Returns decoration pixmap of plot symbol for use in item lists.

static QString	path (const QUrl &urlPlo, const QUrl &url, bool absolute=false)
	Constructs absolute or (if possible) relative file path.

static void	resetDashOffset ()
	Resets offset for dashed lines.

static unsigned	rgb (const QString &color)
	Converts rgb string to QRgb.

static unsigned	rgbQt1 (unsigned rgb)
	Converts QRgb to Qt1 QRgb.

Protected Member Functions
void	init ()
	Performs initialization.

virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event) override
	Updates position.

void	setProperties ()
	Sets properties according to transformation matrix.

Protected Member Functions inherited from KplItem
QPen &	changePenWidth (QPen &pen, double width) const
	Changes pen width.

QPen	createPen (QGraphicsItem *item, unsigned color=0, PenType penType=DataPen, Symbol symbol=SolidLine) const
	Creates pen for plot item.

double	penWidth (const QGraphicsItem *item, PenType penType=DataPen) const
	Calculates pen width for plot item.

Protected Attributes
Alignment	m_alignment

double	m_dir

QString	m_text

QTextDocument	m_doc

Protected Attributes inherited from DecoItem
unsigned	m_color

double	m_x0

double	m_y0

QTransform	m_matrix

Protected Attributes inherited from KplItem
double	m_relSize

Additional Inherited Members
Static Protected Member Functions inherited from KplItem
static double	parentWidth (const QGraphicsItem *item)
	Returns width of item's parent frame or width of scene if the item has no parent item.

static double	penWidthFactor (PenType penType)
	Returns factor to calculate pen width from frame width.

Static Protected Attributes inherited from KplItem
static double	m_dashOffset

Detailed Description

Text item class.

Class for text decoration items.

Author: Werner Stille

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Specific QGraphicsItem type number for function type()

Enumerator
Type	Specific QGraphicsItem type number of TextItem for function type().

◆ Alignment

enum TextItem::Alignment

Text alignment.

Determines how text will be aligned horizontally.

Enumerator
AlignLeft	Aligns at left side.
AlignCentered	Aligns at center.
AlignRight	Aligns at right side.

Constructor & Destructor Documentation

◆ TextItem() [1/3]

TextItem::TextItem	(	double	x0 = 0,
		double	y0 = 0,
		unsigned	color = 0,
		QGraphicsItem *	parent = nullptr,
		const QString &	text = QString(),
		bool	visible = true,
		Alignment	alignment = AlignLeft,
		double	relSize = 1,
		double	dir = 0 )

Constructor.

Initializes corresponding to arguments.

Parameters

x0	x position in cm.
y0	y position in cm.
color	color for text.
parent	pointer to parent item.
text	text.
visible	true for visible item.
alignment	horizontal alignment.
relSize	relative size of text.
dir	direction in degree.

◆ TextItem() [2/3]

TextItem::TextItem	(	const KConfigGroup *	plo,
		unsigned	color = 0,
		QGraphicsItem *	parent = nullptr )

Constructor.

Initializes corresponding to plot file.

Parameters

plo	pointer to KSimpleConfig object containing item data.
color	default color for text.
parent	pointer to parent item.

◆ TextItem() [3/3]

TextItem::TextItem ( const TextItem & a )

Copy constructor.

Parameters

a	source item.

Member Function Documentation

◆ setAlignment()

void TextItem::setAlignment ( Alignment alignment )

inline

Sets alignment.

Parameters

alignment horizontal alignment.

◆ setDir()

void TextItem::setDir ( double dir )

inline

Sets rotation angle.

Parameters

dir	rotation angle in deg.

◆ setProperties()

void TextItem::setProperties ( const QTransform & m )

Sets properties according to transformation matrix.

Parameters

m	transformation matrix.

◆ setText() [1/2]

void TextItem::setText ( const QString & text )

inline

Sets text.

Parameters

text text.

◆ setText() [2/2]

static void TextItem::setText	(	QTextDocument &	doc,
		const QString &	text,
		unsigned	color = 0 )

static

Sets text.

Parameters

doc	document.
text	text.
color	color.

◆ writePlo()

void TextItem::writePlo ( KConfigGroup * plo ) const

Writes into plot file.

Parameters

plo	KConfigGroup object.

The documentation for this class was generated from the following file:

textitem.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

◆ Alignment

Constructor & Destructor Documentation

◆ TextItem() [1/3]

◆ TextItem() [2/3]

◆ TextItem() [3/3]

Member Function Documentation

◆ setAlignment()

◆ setDir()

◆ setProperties()

◆ setText() [1/2]

◆ setText() [2/2]

◆ writePlo()