KCapacityBar Class Reference

from PyKDE4.kdeui import *

Inherits: QWidget → QObject

Detailed Description

This widget shows a bar which is filled to show the level of usage of a certain device.

This widget represents a bar which goal is to show the level of usage of a device. Its look is similar to a progress bar, but different, because this widget does not want to give a notion of progress.

Since:: 4.2

"KDE Capacity Bar"

Author:: Rafael Fernández López <ereslibre@kde.org>

Enumerations
DrawTextMode	{ DrawTextInline, DrawTextOutline }
Methods
	__init__ (self, KCapacityBar.DrawTextMode drawTextMode=KCapacityBar.DrawTextOutline, QWidget parent=0)
int	barHeight (self)
	changeEvent (self, QEvent event)
bool	continuous (self)
	drawCapacityBar (self, QPainter p, QRect rect)
KCapacityBar.DrawTextMode	drawTextMode (self)
bool	fillFullBlocks (self)
Qt::Alignment	horizontalTextAlignment (self)
QSize	minimumSizeHint (self)
	paintEvent (self, QPaintEvent event)
	setBarHeight (self, int barHeight)
	setContinuous (self, bool continuous)
	setDrawTextMode (self, KCapacityBar.DrawTextMode mode)
	setFillFullBlocks (self, bool fillFullBlocks)
	setHorizontalTextAlignment (self, Qt::Alignment textAlignment)
	setText (self, QString text)
	setValue (self, int value)
QString	text (self)
int	value (self)

Method Documentation

__init__	(	self,
		KCapacityBar.DrawTextMode	drawTextMode=KCapacityBar.DrawTextOutline,
		QWidget	parent=0
	)

Capacity bar constructor.

Parameters:

	drawTextMode	If any text set, whether to draw it into the capacity bar or not.
	parent	The parent of the widget.

int barHeight ( self )

Returns:: The preferred height of the capacity bar.

changeEvent	(	self,
		QEvent	event
	)

bool continuous ( self )

Returns:: Whether the fill of the capacity bar should be continuous or block-based.

drawCapacityBar	(	self,
		QPainter	p,
		QRect	rect
	)

This method allows you to draw the widget, directly, for example on item delegates. You only need the painter object and the rect where this widget should be drawn.

KCapacityBar.DrawTextMode drawTextMode ( self )

The way text is drawn, inside the capacity bar or outside of it

bool fillFullBlocks ( self )

Returns:: Whether the last block shown can be cut off when necessary.

Qt::Alignment horizontalTextAlignment ( self )

Returns:: The horizontal alignment for the text that will be drawn.

QSize minimumSizeHint ( self )

paintEvent	(	self,
		QPaintEvent	event
	)

setBarHeight	(	self,
		int	barHeight
	)

Sets the height (in pixels) of the bar.

Parameters:

barHeight

The preferred height (in pixels) of the capacity bar.

Note:: If you set a certain text and the capacity bar is in inline mode, the height of the bar will be the maximum of the font height and this value.

Note:: If you set a certain text and the capacity bar is in outline mode, the height of the whole capacity bar will be bigger than this value. Take in count the height of this widget is got from adding the bar height, the font metrics height and a small separator between the bar and the outline text.

Note:: Its value is 12 pixels by default.

setContinuous	(	self,
		bool	continuous
	)

Sets whether the fill of the capacity bar should be continuous or in block mode.

Parameters:

continuous

If true, the fill of the capacity bar is done in a continuous way. In other case, the fill is done with separated blocks.

Note:: Its value is true by default.

setDrawTextMode	(	self,
		KCapacityBar.DrawTextMode	mode
	)

Set the way text is drawn if any is set

Parameters:

drawTextMode

If any text set, whether to draw it into the capacity bar or not.

setFillFullBlocks	(	self,
		bool	fillFullBlocks
	)

When the capacity bar is non-continuous, sets whether the last block shown should be drawn full or can be cut off (depending on the capacity bar width, and the value set on it).

Parameters:

fillFullBlocks

If true, the last block drawn will be fully filled, on other case, the last block drawn could be cut off.

Note:: This method is only relevant if the capacity bar is in non-continuous mode.

Note:: Its value is true by default.

See also:: setContinuous, continuous

setHorizontalTextAlignment	(	self,
		Qt::Alignment	textAlignment
	)

If the capacity bar is in outline text mode, draw the text with textAlignment alignment.

Parameters:

textAlignment

Sets the horizontal alignment for the text if the capacity bar is in outline text mode.

Note:: If textAlignemt contains vertical alignment flags, they will be ignored.

Note:: If the capacity bar is in inline text mode, the text is always centered, and both vertical and horizontal flags set through this method are ignored.

Note:: Its value is centered by default.

setText	(	self,
		QString	text
	)

Sets the text for the capacity bar.

Parameters:

text

The text that the capacity bar will show.

Note:: This is an empty string by default.

setValue	(	self,
		int	value
	)

Capacity bar fill value.

Parameters:

value

This parameter can take values from 0 to 100.

Note:: Its value is 0 by default.

QString text ( self )

Returns:: The text that the capacity bar will show.

int value ( self )

Returns:: The fill value of the capacity bar.

Enumeration Documentation

DrawTextMode

Enumerator:

DrawTextInline = 0
DrawTextOutline

KCapacityBar Class Reference

Detailed Description

Enumerations

Methods

Method Documentation

Enumeration Documentation

Modules