#include <treemap.h>

Inheritance diagram for TreeMapWidget:

Public Types
enum	SelectionMode { Single, Multi, Extended, NoSelection }

Signals
void	clicked (TreeMapItem *)

void	contextMenuRequested (TreeMapItem *, const QPoint &)

void	currentChanged (TreeMapItem *, bool keyboard)

void	doubleClicked (TreeMapItem *)

void	returnPressed (TreeMapItem *)

void	rightButtonPressed (TreeMapItem *, const QPoint &)

void	selectionChanged ()

void	selectionChanged (TreeMapItem *)

Public Member Functions
	TreeMapWidget (TreeMapItem base, QWidget parent=0)

	~TreeMapWidget ()

void	addSplitDirectionItems (QMenu *)

bool	allowRotation () const

TreeMapItem *	base () const

int	borderWidth () const

bool	clearSelection (TreeMapItem *parent=0)

TreeMapItem *	current () const

const QFont &	currentFont () const

bool	defaultFieldForced (int) const

DrawParams::Position	defaultFieldPosition (int) const

QString	defaultFieldStop (int) const

QString	defaultFieldType (int) const

bool	defaultFieldVisible (int) const

void	deletingItem (TreeMapItem *)

void	drawFrame (int d, bool b)

bool	drawFrame (int d) const

void	drawTreeMap ()

bool	fieldForced (int) const

DrawParams::Position	fieldPosition (int) const

QString	fieldPositionString (int) const

QString	fieldStop (int) const

QString	fieldType (int) const

bool	fieldVisible (int) const

bool	isSelected (TreeMapItem *i) const

bool	isShadingEnabled () const

bool	isTransparent (int d) const

TreeMapItem *	item (int x, int y) const

int	maxDrawingDepth () const

int	maxSelectDepth () const

int	minimalArea () const

TreeMapItem *	possibleSelection (TreeMapItem *) const

void	redraw (TreeMapItem *)

void	redraw ()

void	resort ()

TreeMapItemList	selection () const

SelectionMode	selectionMode () const

void	setAllowRotation (bool)

void	setBorderWidth (int w)

void	setCurrent (TreeMapItem *, bool kbd=false)

void	setFieldForced (int, bool)

void	setFieldPosition (int, DrawParams::Position)

void	setFieldPosition (int, const QString &)

void	setFieldStop (int, const QString &)

void	setFieldType (int, const QString &)

void	setFieldVisible (int, bool)

void	setMarked (int markNo=1, bool redraw=true)

void	setMaxDrawingDepth (int d)

void	setMaxSelectDepth (int d)

void	setMinimalArea (int area)

void	setRangeSelection (TreeMapItem i1, TreeMapItem i2, bool selected)

void	setSelected (TreeMapItem *, bool selected=true)

void	setSelectionMode (SelectionMode m)

void	setShadingEnabled (bool s)

void	setSkipIncorrectBorder (bool enable=true)

void	setSplitMode (TreeMapItem::SplitMode m)

bool	setSplitMode (const QString &)

void	setTransparent (int d, bool b)

void	setVisibleWidth (int width, bool reuseSpace=false)

bool	skipIncorrectBorder () const

TreeMapItem::SplitMode	splitMode () const

QString	splitModeString () const

virtual QString	tipString (TreeMapItem *i) const

TreeMapItem *	visibleItem (TreeMapItem *) const

TreeMapWidget *	widget ()

Protected Slots
void	splitActivated (QAction *)

Protected Member Functions
void	contextMenuEvent (QContextMenuEvent *)

bool	event (QEvent *event)

void	fontChange (const QFont &)

void	keyPressEvent (QKeyEvent *)

void	mouseDoubleClickEvent (QMouseEvent *)

void	mouseMoveEvent (QMouseEvent *)

void	mousePressEvent (QMouseEvent *)

void	mouseReleaseEvent (QMouseEvent *)

void	paintEvent (QPaintEvent *)

Detailed Description

Class for visualization of a metric of hierarchically nested items as 2D areas.

Definition at line 393 of file treemap.h.

Member Enumeration Documentation

enum TreeMapWidget::SelectionMode

Same as in QListBox/QListView.

Enumerator
Single
Multi
Extended
NoSelection

Definition at line 402 of file treemap.h.

Constructor & Destructor Documentation

TreeMapWidget::TreeMapWidget	(	TreeMapItem *	base,
		QWidget *	parent = `0`
	)

explicit

Definition at line 1153 of file treemap.cpp.

TreeMapWidget::~TreeMapWidget ( )

Definition at line 1199 of file treemap.cpp.

Member Function Documentation

void TreeMapWidget::addSplitDirectionItems ( QMenu * m )

Populate given menu with option items.

The added items are automatically connected to handlers.

Definition at line 2848 of file treemap.cpp.

bool TreeMapWidget::allowRotation ( ) const

inline

Definition at line 602 of file treemap.h.

TreeMapItem* TreeMapWidget::base ( ) const

inline

Returns the TreeMapItem filling out the widget space.

Definition at line 411 of file treemap.h.

int TreeMapWidget::borderWidth ( ) const

inline

Definition at line 605 of file treemap.h.

bool TreeMapWidget::clearSelection ( TreeMapItem * parent = 0 )

Clear selection of all selected items which are children of parent.

When parent == 0, clears whole selection Returns true if selection changed.

Definition at line 1705 of file treemap.cpp.

void TreeMapWidget::clicked ( TreeMapItem * )

signal

void TreeMapWidget::contextMenuEvent ( QContextMenuEvent * e )

protected

Definition at line 1820 of file treemap.cpp.

void TreeMapWidget::contextMenuRequested	(	TreeMapItem *	,
		const QPoint &
	)

signal

TreeMapItem* TreeMapWidget::current ( ) const

inline

Definition at line 614 of file treemap.h.

void TreeMapWidget::currentChanged	(	TreeMapItem *	,
		bool	keyboard
	)

signal

This signal is emitted if the current item changes.

If the change is done because of keyboard navigation, the is set to true

const QFont & TreeMapWidget::currentFont ( ) const

Returns a reference to the current widget font.

Definition at line 1204 of file treemap.cpp.

bool TreeMapWidget::defaultFieldForced ( int ) const

Definition at line 1337 of file treemap.cpp.

DrawParams::Position TreeMapWidget::defaultFieldPosition ( int f ) const

Definition at line 1342 of file treemap.cpp.

QString TreeMapWidget::defaultFieldStop ( int ) const

Definition at line 1327 of file treemap.cpp.

QString TreeMapWidget::defaultFieldType ( int f ) const

Definition at line 1322 of file treemap.cpp.

bool TreeMapWidget::defaultFieldVisible ( int f ) const

Definition at line 1332 of file treemap.cpp.

void TreeMapWidget::deletingItem ( TreeMapItem * i )

Definition at line 1501 of file treemap.cpp.

void TreeMapWidget::doubleClicked ( TreeMapItem * )

signal

void TreeMapWidget::drawFrame	(	int	d,
		bool	b
	)

Definition at line 1265 of file treemap.cpp.

bool TreeMapWidget::drawFrame ( int d ) const

inline

Definition at line 510 of file treemap.h.

void TreeMapWidget::drawTreeMap ( )

Definition at line 2178 of file treemap.cpp.

bool TreeMapWidget::event ( QEvent * event )

protected

Definition at line 2148 of file treemap.cpp.

bool TreeMapWidget::fieldForced ( int f ) const

Definition at line 1434 of file treemap.cpp.

DrawParams::Position TreeMapWidget::fieldPosition ( int f ) const

Definition at line 1453 of file treemap.cpp.

QString TreeMapWidget::fieldPositionString ( int f ) const

Definition at line 1479 of file treemap.cpp.

QString TreeMapWidget::fieldStop ( int f ) const

Definition at line 1398 of file treemap.cpp.

QString TreeMapWidget::fieldType ( int f ) const

Definition at line 1382 of file treemap.cpp.

bool TreeMapWidget::fieldVisible ( int f ) const

Definition at line 1415 of file treemap.cpp.

void TreeMapWidget::fontChange ( const QFont & )

protected

Definition at line 2142 of file treemap.cpp.

bool TreeMapWidget::isSelected ( TreeMapItem * i ) const

Definition at line 1722 of file treemap.cpp.

bool TreeMapWidget::isShadingEnabled ( ) const

inline

Definition at line 506 of file treemap.h.

bool TreeMapWidget::isTransparent ( int d ) const

inline

Definition at line 514 of file treemap.h.

TreeMapItem * TreeMapWidget::item	(	int	x,
		int	y
	)		const

Returns the area item at position x/y, independent from any maxSelectDepth setting.

Definition at line 1541 of file treemap.cpp.

void TreeMapWidget::keyPressEvent ( QKeyEvent * e )

protected

Definition at line 2027 of file treemap.cpp.

int TreeMapWidget::maxDrawingDepth ( ) const

inline

Definition at line 545 of file treemap.h.

int TreeMapWidget::maxSelectDepth ( ) const

inline

Definition at line 617 of file treemap.h.

int TreeMapWidget::minimalArea ( ) const

inline

Definition at line 551 of file treemap.h.

void TreeMapWidget::mouseDoubleClickEvent ( QMouseEvent * e )

protected

Definition at line 1980 of file treemap.cpp.

void TreeMapWidget::mouseMoveEvent ( QMouseEvent * e )

protected

Definition at line 1907 of file treemap.cpp.

void TreeMapWidget::mousePressEvent ( QMouseEvent * e )

protected

Definition at line 1839 of file treemap.cpp.

void TreeMapWidget::mouseReleaseEvent ( QMouseEvent * )

protected

Definition at line 1950 of file treemap.cpp.

void TreeMapWidget::paintEvent ( QPaintEvent * )

protected

Definition at line 2171 of file treemap.cpp.

TreeMapItem * TreeMapWidget::possibleSelection ( TreeMapItem * i ) const

Returns the item possible for selection.

this returns the given item itself or a parent thereof, depending on setting of maxSelectDepth().

Definition at line 1593 of file treemap.cpp.

void TreeMapWidget::redraw ( TreeMapItem * i )

Redraws an item with all children.

This takes changed values(), sums(), colors() and text() into account.

Definition at line 2231 of file treemap.cpp.

void TreeMapWidget::redraw ( )

inline

Definition at line 631 of file treemap.h.

void TreeMapWidget::resort ( )

inline

Resort all TreeMapItems.

See TreeMapItem::resort().

Definition at line 636 of file treemap.h.

void TreeMapWidget::returnPressed ( TreeMapItem * )

signal

void TreeMapWidget::rightButtonPressed	(	TreeMapItem *	,
		const QPoint &
	)

signal

TreeMapItemList TreeMapWidget::selection ( ) const

inline

Definition at line 615 of file treemap.h.

void TreeMapWidget::selectionChanged ( )

signal

void TreeMapWidget::selectionChanged ( TreeMapItem * )

signal

SelectionMode TreeMapWidget::selectionMode ( ) const

inline

Definition at line 618 of file treemap.h.

void TreeMapWidget::setAllowRotation ( bool enable )

Do we allow the texts to be rotated by 90 degrees for better fitting?

Definition at line 1281 of file treemap.cpp.

void TreeMapWidget::setBorderWidth ( int w )

Definition at line 1306 of file treemap.cpp.

void TreeMapWidget::setCurrent	(	TreeMapItem *	i,
		bool	kbd = `false`
	)

Sets the current item.

The current item is mainly used for keyboard navigation.

Definition at line 1735 of file treemap.cpp.

void TreeMapWidget::setFieldForced	(	int	f,
		bool	enable
	)

Should the drawing of the name into the rectangle be forced? This enables drawing of the name before drawing subitems, and thus destroys proportional constrains.

Definition at line 1423 of file treemap.cpp.

void TreeMapWidget::setFieldPosition	(	int	f,
		DrawParams::Position	pos
	)

Set the field position in the area.

See TreeMapItem::Position

Definition at line 1442 of file treemap.cpp.

void TreeMapWidget::setFieldPosition	(	int	f,
		const QString &	pos
	)

Definition at line 1461 of file treemap.cpp.

void TreeMapWidget::setFieldStop	(	int	f,
		const QString &	stop
	)

Stop drawing at item with name.

Definition at line 1388 of file treemap.cpp.

void TreeMapWidget::setFieldType	(	int	f,
		const QString &	type
	)

Set the type name of a field.

This is important for the visualization menu generated with visualizationMenu()

Definition at line 1373 of file treemap.cpp.

void TreeMapWidget::setFieldVisible	(	int	f,
		bool	enable
	)

Should the text with number textNo be visible? This is only done if remaining space is enough to allow for proportional size constrains.

Definition at line 1404 of file treemap.cpp.

void TreeMapWidget::setMarked	(	int	markNo = `1`,
		bool	redraw = `true`
	)

Switches on the marking <markNo>.

Marking 0 switches off marking. This is mutually exclusive to selection, and is automatically switched off when selection is changed (also by the user). Marking is visually the same as selection, and is based on TreeMapItem::isMarked(<markNo>). This enables to programmatically show multiple selected items at once even in single selection mode.

Definition at line 1647 of file treemap.cpp.

void TreeMapWidget::setMaxDrawingDepth ( int d )

Maximal nesting depth.

Definition at line 1314 of file treemap.cpp.

void TreeMapWidget::setMaxSelectDepth ( int d )

inline

Set the maximal depth a selected item can have.

If you try to select a item with higher depth, the ancestor holding this condition is used.

See also possibleSelection().

Definition at line 487 of file treemap.h.

void TreeMapWidget::setMinimalArea ( int area )

Minimal area for rectangles to draw.

Definition at line 1492 of file treemap.cpp.

void TreeMapWidget::setRangeSelection	(	TreeMapItem *	i1,
		TreeMapItem *	i2,
		bool	selected
	)

Selects or unselects items in a range.

This is needed internally for Shift-Click in Extended mode. Range means for a hierarchical widget:

select/unselect i1 and i2 according selected
search common parent of i1 and i2, and select/unselect the range of direct children between but excluding the child leading to i1 and the child leading to i2.

Definition at line 1764 of file treemap.cpp.

void TreeMapWidget::setSelected	(	TreeMapItem *	item,
		bool	selected = `true`
	)

Selects or unselects an item.

In multiselection mode, the constrain that a selected item has no selected children or parents stays true.

Definition at line 1626 of file treemap.cpp.

void TreeMapWidget::setSelectionMode ( SelectionMode m )

inline

Definition at line 490 of file treemap.h.

void TreeMapWidget::setShadingEnabled ( bool s )

Definition at line 1257 of file treemap.cpp.

void TreeMapWidget::setSkipIncorrectBorder ( bool enable = true )

If a children value() is almost the parents sum(), it can happen that the border to be drawn for visibilty of nesting relations takes to much space, and the parent/child size relation can not be mapped to a correct area size relation.

Either (1) Ignore the incorrect drawing, or (2) Skip drawing of the parent level alltogether.

Definition at line 1298 of file treemap.cpp.

void TreeMapWidget::setSplitMode ( TreeMapItem::SplitMode m )

for setting/getting global split direction

Definition at line 1209 of file treemap.cpp.

bool TreeMapWidget::setSplitMode ( const QString & mode )

Definition at line 1222 of file treemap.cpp.

void TreeMapWidget::setTransparent	(	int	d,
		bool	b
	)

Definition at line 1273 of file treemap.cpp.

void TreeMapWidget::setVisibleWidth	(	int	width,
		bool	reuseSpace = `false`
	)

Items usually have a size proportional to their value().

With <width>, you can give the minimum width of the resulting rectangle to still be drawn. For space not used because of to small items, you can specify with <reuseSpace> if the background should shine through or the space will be used to enlarge the next item to be drawn at this level.

Definition at line 1289 of file treemap.cpp.

bool TreeMapWidget::skipIncorrectBorder ( ) const

inline

Definition at line 539 of file treemap.h.

void TreeMapWidget::splitActivated ( QAction * a )

protectedslot

Definition at line 2835 of file treemap.cpp.

TreeMapItem::SplitMode TreeMapWidget::splitMode ( ) const

Definition at line 1217 of file treemap.cpp.

QString TreeMapWidget::splitModeString ( ) const

Definition at line 1238 of file treemap.cpp.

QString TreeMapWidget::tipString ( TreeMapItem * i ) const

virtual

Return tooltip string to show for a item (can be rich text) Default implementation gives lines with "text0 (text1)" going to root.

Reimplemented in PartAreaWidget, and CallMapView.

Definition at line 1521 of file treemap.cpp.

TreeMapItem * TreeMapWidget::visibleItem ( TreeMapItem * i ) const

Returns the nearest item with a visible area; this can be the given item itself.

Definition at line 1607 of file treemap.cpp.

TreeMapWidget* TreeMapWidget::widget ( )

inline

Definition at line 613 of file treemap.h.

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

kcachegrind

Public Types

Signals

Public Member Functions

Protected Slots

Protected Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

kcachegrind

kdesdk API Reference

Search