Plasma::Label Class Reference

#include <Plasma/Widgets/Label>

Inheritance diagram for Plasma::Label:

Public Slots
void	dataUpdated (const QString &sourceName, const Plasma::DataEngine::Data &data)

Signals
void	linkActivated (const QString &link)
void	linkHovered (const QString &link)

Public Member Functions
	Label (QGraphicsWidget *parent=0)
	~Label ()
Qt::Alignment	alignment () const
bool	hasScaledContents () const
QString	image () const
QLabel *	nativeWidget () const
void	setAlignment (Qt::Alignment alignment)
void	setImage (const QString &path)
void	setScaledContents (bool scaled)
void	setStyleSheet (const QString &stylesheet)
void	setText (const QString &text)
void	setTextSelectable (bool enable)
void	setWordWrap (bool wrap)
QString	styleSheet ()
QString	text () const
bool	textSelectable () const
bool	wordWrap () const

Protected Member Functions
void	changeEvent (QEvent *event)
void	contextMenuEvent (QGraphicsSceneContextMenuEvent *event)
bool	event (QEvent *event)
QVariant	itemChange (GraphicsItemChange change, const QVariant &value)
void	mouseMoveEvent (QGraphicsSceneMouseEvent *event)
void	mousePressEvent (QGraphicsSceneMouseEvent *event)
void	paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
void	resizeEvent (QGraphicsSceneResizeEvent *event)
QSizeF	sizeHint (Qt::SizeHint which, const QSizeF &constraint) const

Properties
Qt::Alignment	alignment
bool	hasScaledContents
QString	image
QLabel	nativeWidget
QGraphicsWidget	parentWidget
QString	styleSheet
QString	text
bool	textSelectable
bool	wordWrap

Detailed Description

Provides a plasma-themed QLabel.

Definition at line 40 of file label.h.

Constructor & Destructor Documentation

Plasma::Label::Label ( QGraphicsWidget *  parent = 0 )

explicit

Constructs a label with word wrap on by default.

Parameters

parent

the parent of this widget

Definition at line 94 of file label.cpp.

Plasma::Label::~Label

(

)

Definition at line 112 of file label.cpp.

Member Function Documentation

Qt::Alignment Plasma::Label::alignment

(

)

const

Returns

the alignment for the text used in the labels

void Plasma::Label::changeEvent ( QEvent *  event )

protected

Definition at line 318 of file label.cpp.

void Plasma::Label::contextMenuEvent ( QGraphicsSceneContextMenuEvent *  event )

protected

Definition at line 237 of file label.cpp.

void Plasma::Label::dataUpdated ( const QString &  sourceName, const Plasma::DataEngine::Data &  data  )

slot

Definition at line 223 of file label.cpp.

bool Plasma::Label::event ( QEvent *  event )

protected

Definition at line 324 of file label.cpp.

bool Plasma::Label::hasScaledContents

(

)

const

Returns

true if the contents are scaled to the label size

QString Plasma::Label::image

(

)

const

Returns

the image path being displayed currently, or an empty string if none.

QVariant Plasma::Label::itemChange ( GraphicsItemChange  change, const QVariant &  value  )

protected

Definition at line 330 of file label.cpp.

void Plasma::Label::linkActivated ( const QString &  link )

signal

void Plasma::Label::linkHovered ( const QString &  link )

signal

void Plasma::Label::mouseMoveEvent ( QGraphicsSceneMouseEvent *  event )

protected

Definition at line 264 of file label.cpp.

void Plasma::Label::mousePressEvent ( QGraphicsSceneMouseEvent *  event )

protected

Definition at line 254 of file label.cpp.

QLabel* Plasma::Label::nativeWidget

(

)

const

Returns

the native widget wrapped by this Label

void Plasma::Label::paint ( QPainter *  painter, const QStyleOptionGraphicsItem *  option, QWidget *  widget  )

protected

Definition at line 271 of file label.cpp.

void Plasma::Label::resizeEvent ( QGraphicsSceneResizeEvent *  event )

protected

Definition at line 248 of file label.cpp.

void Plasma::Label::setAlignment

(

Qt::Alignment

alignment

)

Sets the alignment for the text.

Parameters

the	desired alignment

Definition at line 188 of file label.cpp.

void Plasma::Label::setImage

(

const QString &

path

)

Sets the path to an image to display.

Parameters

path	the path to the image; if a relative path, then a themed image will be loaded.

Definition at line 129 of file label.cpp.

void Plasma::Label::setScaledContents

(

bool

scaled

)

Scale or not the contents of the label to the label size.

Parameters

scale

Definition at line 162 of file label.cpp.

void Plasma::Label::setStyleSheet

(

const QString &

stylesheet

)

Sets the stylesheet used to control the visual display of this Label.

Parameters

stylesheet

a CSS string

Definition at line 208 of file label.cpp.

void Plasma::Label::setText

(

const QString &

text

)

Sets the display text for this Label.

Parameters

text	the text to display; should be translated.

Definition at line 117 of file label.cpp.

void Plasma::Label::setTextSelectable

(

bool

enable

)

Set if the text on the label can be selected with the mouse.

Parameters

enable

true if we want to manage text selection with the mouse

Since

4.4

Definition at line 172 of file label.cpp.

void Plasma::Label::setWordWrap

(

bool

wrap

)

Sets if the text of the label can wrap in multiple lines.

Parameters

wrap	multiple lines or not

Since

4.5

Definition at line 198 of file label.cpp.

QSizeF Plasma::Label::sizeHint ( Qt::SizeHint  which, const QSizeF &  constraint  ) const

protected

Definition at line 339 of file label.cpp.

QString Plasma::Label::styleSheet

(

)

Returns

the stylesheet currently used with this widget

QString Plasma::Label::text

(

)

const

Returns

the display text

bool Plasma::Label::textSelectable

(

)

const

Returns

true if the text is selectable with the mouse

Since

4.4

bool Plasma::Label::wordWrap

(

)

const

Returns

true if the label text can wrap in multiple lines if too long

Since

4.5

Property Documentation

Qt::Alignment Plasma::Label::alignment

readwrite

Definition at line 47 of file label.h.

bool Plasma::Label::hasScaledContents

readwrite

Definition at line 48 of file label.h.

QString Plasma::Label::image

readwrite

Definition at line 46 of file label.h.

QLabel * Plasma::Label::nativeWidget

read

Definition at line 52 of file label.h.

QGraphicsWidget Plasma::Label::parentWidget

read

Definition at line 44 of file label.h.

QString Plasma::Label::styleSheet

readwrite

Definition at line 51 of file label.h.

QString Plasma::Label::text

readwrite

Definition at line 45 of file label.h.

bool Plasma::Label::textSelectable

readwrite

Definition at line 49 of file label.h.

bool Plasma::Label::wordWrap

readwrite

Definition at line 50 of file label.h.

---

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

• label.h
• label.cpp