Inheritance diagram for ito::HelpTreeDockWidget:

Classes
struct	DisplayBool

struct	SqlItem

Public Types
enum	itemType { typeSqlItem = 1, typeFilter = 2, typeWidget = 3, typeFPlugin = 4, typeWPlugin = 5, typeCategory = 6, typeDataIO = 7, typeActuator = 8 }

enum	iconType { iconFilter = 100, iconPluginAlgo = 101, iconPluginFilter = 102, iconWidget = 103, iconPluginDataIO = 104, iconPluginGrabber = 105, iconPluginAdda = 106, iconPluginRawIO = 107, iconPluginActuator = 108 }

Public Slots
void	navigateBackwards ()

void	navigateForwards ()

void	expandTree ()

void	collapseTree ()

void	reloadDB ()
	Reload Database and clear search-edit and start the new Thread. More...

void	liveFilter (const QString &filterText)
	slot invoked by toolbar More...

void	showTreeview ()

void	unshowTreeview ()

void	propertiesChanged ()
	Load SQL-DatabasesList in m_ Variable when properties changed.

void	showPluginInfo (const QString &name, int type, const QModelIndex &modelIndex, bool fromLink)
	slot invoked by different widgets to display a help page from extern More...

ito::RetVal	showFilterWidgetPluginHelp (const QString &filtername, itemType type)
	Get the DocString from a Filter and parse is to html. More...

Public Member Functions
	HelpTreeDockWidget (QWidget parent, ito::AbstractDockWidget dock=0, Qt::WindowFlags flags=0)

Protected Member Functions
bool	eventFilter (QObject obj, QEvent event)
	Filter the events for showing and hiding the treeview. More...

void	showEvent (QShowEvent *event)

Private Slots
void	on_splitter_splitterMoved (int pos, int index)

void	on_helpTreeContent_anchorClicked (const QUrl &link)

void	dbLoaderFinished (int index)
	This slot is called when the loading thread is finished. More...

void	on_treeView_expanded (const QModelIndex &index)

void	on_treeView_collapsed (const QModelIndex &index)

void	selectedItemChanged (const QModelIndex &current, const QModelIndex &previous)

Private Member Functions
void	CreateItem (QStandardItemModel &model, QStringList &items)

void	saveIni ()
	Save Gui positions to Main-ini-File.

void	loadIni ()
	Load Gui positions to Main-ini-File.

ito::RetVal	displayHelp (const QString &path)
	Displayes the help text in the textbrowser after an element from the tree was clicked. More...

QStringList	separateLink (const QUrl &link)
	Returns a list containing the protocol[0] and the real link[1]. More...

ito::RetVal	highlightContent (const QString &prefix, const QString &name, const QString &param, const QString &shortDesc, const QString &helpText, const QString &error, QTextDocument *document)

QModelIndex	findIndexByPath (const int type, QStringList path, const QStandardItem *current)
	finds a Modelindex related to MainModel (not FilterModel)belonging to an Itemname More...

QString	parseFilterWidgetContent (const QString &input)
	Reformats all help strings that come from the widgets and plugins. More...

ito::RetVal	parseParamVector (const QString &sectionname, const QVector< ito::Param > &paramVector, QString &content)
	Creates the Parameter- and Return- sections in html-Code. More...

QString	parseParam (const QString &tmpl, const ito::Param &param)
	Parses a single Parameter to html code (called by parseParamVector) More...

QString	minText (int minimum) const
	This function detects if a range minimum of a variable is equal to the minimum of the type. More...

QString	minText (double minimum) const
	This function detects if a range minimum of a variable is equal to the minimum of the type. More...

QString	minText (char minimum) const
	This function detects if a range minimum of a variable is equal to the minimum of the type. More...

QString	maxText (int minimum) const
	This function detects if a range maximum of a variable is equal to the maximum of the type. More...

QString	maxText (double minimum) const
	This function detects if a range maximum of a variable is equal to the maximum of the type. More...

QString	maxText (char minimum) const
	This function detects if a range maximum of a variable is equal to the maximum of the type. More...

QString	minmaxText (int value) const
	This function detects if a range minimum or maximum of a variable is equal to the minimum or maximum of the type. More...

QString	minmaxText (double value) const
	This function detects if a range minimum or maximum of a variable is equal to the minimum or maximum of the type. More...

QString	minmaxText (char value) const
	This function detects if a range minimum or maximum of a variable is equal to the minimum or maximum of the type. More...

Static Private Member Functions
static void	createFilterWidgetNode (int fOrW, QStandardItemModel model, const QMap< int, QIcon > iconGallery)
	Get The Filters and put them into a node of the Tree. More...

static void	createItemRek (QStandardItem &parent, const QString &parentPath, QList< SqlItem > &items, const QMap< int, QIcon > *iconGallery)
	Creates the model (tree) from the given data. More...

static ito::RetVal	loadDBinThread (const QString &path, const QStringList &includedDBs, QStandardItemModel mainModel, const QMap< int, QIcon > iconGallery, const DisplayBool &show)
	Load the Databases in different Thread. More...

static ito::RetVal	readSQL (const QString &file, QList< SqlItem > &items)
	Get Data from SQL File and store it in a table. More...

Private Attributes
QFutureWatcher< ito::RetVal >	dbLoaderWatcher

Ui::HelpTreeDockWidget	ui

QStandardItemModel *	m_pMainModel

LeafFilterProxyModel *	m_pMainFilterModel

ito::AbstractDockWidget *	m_pParent

QList< QModelIndex >	m_history

QStringList	m_includedDBs

QString	m_dbPath

QMovie *	m_previewMovie

QMap< int, QIcon >	m_iconGallery

DisplayBool	m_showSelection

int	m_historyIndex

int	m_autoCollTime

double	m_treeWidthVisible

double	m_treeWidthInvisible

bool	m_treeVisible

bool	m_plaintext

bool	m_openLinks

bool	m_autoCollTree

bool	m_forced

bool	m_internalCall

bool	m_doingExpandAll

Static Private Attributes
static const int	m_urPath = Qt::UserRole + 1

static const int	m_urType = Qt::UserRole + 2

Member Function Documentation

void ito::HelpTreeDockWidget::createFilterWidgetNode	(	int	fOrW,
		QStandardItemModel *	model,
		const QMap< int, QIcon > *	iconGallery
	)

staticprivate

Get The Filters and put them into a node of the Tree.

Parameters

fOrW
model
iconGallery

void ito::HelpTreeDockWidget::createItemRek	(	QStandardItem &	parent,
		const QString &	parentPath,
		QList< SqlItem > &	items,
		const QMap< int, QIcon > *	iconGallery
	)

staticprivate

Creates the model (tree) from the given data.

The function is recursiv. It always calles itself with the rest of the list that is not in the tree yet.

Parameters

parent	parent that might have children. This function is going to find them and add them from the list.
parentPath	absolute path of the parent
items	list of all sql items that are not processed yet
iconGallery	Gallery with icons for classes, modules etc.

void ito::HelpTreeDockWidget::dbLoaderFinished ( int index )

privateslot

This slot is called when the loading thread is finished.

When this slot is called, the database is loaded and the main model created

See also: reloadDB, loadDBinThread

ito::RetVal ito::HelpTreeDockWidget::displayHelp ( const QString & path )

private

Displayes the help text in the textbrowser after an element from the tree was clicked.

This function looks for a entry in the database that is specified by the path parameter. This text is afterwards passed to all the different parser functions in this class.

Parameters

path	Path to the entry, read from the model.

bool ito::HelpTreeDockWidget::eventFilter	(	QObject *	obj,
		QEvent *	event
	)

protected

Filter the events for showing and hiding the treeview.

Parameters

event

Returns: bool

QModelIndex ito::HelpTreeDockWidget::findIndexByPath	(	const int	type,
		QStringList	path,
		const QStandardItem *	current
	)

private

finds a Modelindex related to MainModel (not FilterModel)belonging to an Itemname

Parameters

type	of the item (for more information see type enumeration in header file)
path	path to the item splitted into a list
current	item whose children are searched

Returns: QModelIndex

void ito::HelpTreeDockWidget::liveFilter ( const QString & filterText )

slot

slot invoked by toolbar

This is the Slot is called by the toolbar when the user enters a filter into the search edit.

Parameters

filterText the text that the model is filtered with.

ito::RetVal ito::HelpTreeDockWidget::loadDBinThread	(	const QString &	path,
		const QStringList &	includedDBs,
		QStandardItemModel *	mainModel,
		const QMap< int, QIcon > *	iconGallery,
		const DisplayBool &	show
	)

staticprivate

Load the Databases in different Thread.

This function calls createItemRek for each Database. The show parameter is an enumeration from the headerfile. It stores which kind of help is included into the model. The options can be set in the properties dialog.

Parameters

path
includedDBs	list of database files (paths)
mainModel	pointer to the mainmodel
iconGallery	the gallery is passed to createItemRek
show	this parameter is an enumeration that is filled by the settings dialog.

See also: reloadDB, loadDBinThread, createItemRek

QString ito::HelpTreeDockWidget::maxText ( int maximum ) const

private

This function detects if a range maximum of a variable is equal to the maximum of the type.

For example if a range is max 255 and it�s a byte, this function returns inf

Parameters

maximum

Returns: maximum as String or inf

QString ito::HelpTreeDockWidget::maxText ( double maximum ) const

private

This function detects if a range maximum of a variable is equal to the maximum of the type.

For example if a range is max 255 and it�s a byte, this function returns inf

Parameters

maximum

Returns: maximum as String or inf

QString ito::HelpTreeDockWidget::maxText ( char maximum ) const

private

This function detects if a range maximum of a variable is equal to the maximum of the type.

For example if a range is max 255 and it�s a byte, this function returns inf

Parameters

maximum

Returns: maximum as String or inf

QString ito::HelpTreeDockWidget::minmaxText ( int value ) const

private

This function detects if a range minimum or maximum of a variable is equal to the minimum or maximum of the type.

For example if a range is max 255 and it�s a byte, this function returns inf

Parameters

value

Returns: maximum as String, -inf or inf

QString ito::HelpTreeDockWidget::minmaxText ( double value ) const

private

This function detects if a range minimum or maximum of a variable is equal to the minimum or maximum of the type.

For example if a range is max 255 and it�s a byte, this function returns inf

Parameters

value

Returns: maximum as String, -inf or inf

QString ito::HelpTreeDockWidget::minmaxText ( char value ) const

private

This function detects if a range minimum or maximum of a variable is equal to the minimum or maximum of the type.

For example if a range is max 255 and it�s a byte, this function returns inf

Parameters

value

Returns: maximum as String, -inf or inf

QString ito::HelpTreeDockWidget::minText ( int minimum ) const

private

This function detects if a range minimum of a variable is equal to the minimum of the type.

For example if a range is min 0 and it�s a byte, this function returns -inf

Parameters

minimum

Returns: QString int as String or -inf

QString ito::HelpTreeDockWidget::minText ( double minimum ) const

private

This function detects if a range minimum of a variable is equal to the minimum of the type.

For example if a range is min 0 and it�s a byte, this function returns -inf

Parameters

minimum

Returns: double as String or -inf

QString ito::HelpTreeDockWidget::minText ( char minimum ) const

private

This function detects if a range minimum of a variable is equal to the minimum of the type.

For example if a range is min 0 and it�s a byte, this function returns -inf

Parameters

minimum

Returns: char as String or -inf

QString ito::HelpTreeDockWidget::parseFilterWidgetContent ( const QString & input )

private

Reformats all help strings that come from the widgets and plugins.

All newLine characters are replaced by the html tag

Parameters

input The text that is supposed to be reformated

Returns: QString contains the reformated text

QString ito::HelpTreeDockWidget::parseParam	(	const QString &	tmpl,
		const ito::Param &	param
	)

private

Parses a single Parameter to html code (called by parseParamVector)

Parameters

tmpl
param

Returns: QString

ito::RetVal ito::HelpTreeDockWidget::parseParamVector	(	const QString &	sectionname,
		const QVector< ito::Param > &	paramVector,
		QString &	content
	)

private

Creates the Parameter- and Return- sections in html-Code.

Parameters

sectionname
paramVector
content

Returns: RetVal

ito::RetVal ito::HelpTreeDockWidget::readSQL	(	const QString &	file,
		QList< SqlItem > &	items
	)

staticprivate

Get Data from SQL File and store it in a table.

This function openes a sql database that contains all the static help informations. All these informations are written into a list. createItemRek creates the model from this list.

Parameters

file	the path of the sql database
items	this parameter is filled with a list of SqlItems (struct from the header file)

Returns: ito::RetVal

See also: createItemRek

void ito::HelpTreeDockWidget::reloadDB ( )

slot

Reload Database and clear search-edit and start the new Thread.

This function starts a new thread that loads the database.

See also: dbLoaderFinished

QStringList ito::HelpTreeDockWidget::separateLink ( const QUrl & link )

private

Returns a list containing the protocol[0] and the real link[1].

This functions looks for different protocols in the links that can be clicked inside the textBrowser

Parameters

link	link link that is analysed

Returns: returns a list of all parts of the link

ito::RetVal ito::HelpTreeDockWidget::showFilterWidgetPluginHelp	(	const QString &	filterpath,
		itemType	type
	)

slot

Get the DocString from a Filter and parse is to html.

This function puts all information of a Widget or Plugin together and builds the html help text.

Parameters

filterpath	path with all parents
type	the enumeration itemType is defined in the header file helpTreeDockWidget.h

Returns: ito::RetVal

void ito::HelpTreeDockWidget::showPluginInfo	(	const QString &	name,
		int	type,
		const QModelIndex &	modelIndex,
		bool	fromLink
	)

slot

slot invoked by different widgets to display a help page from extern

This is the Slot that can be externally called by other widgets to display filter or widget help ... i.a. AIManagerWidget

Parameters

name	name of the function that is supposed to be displayed
type	it decides wheather the help is stored in a database (1) or calls showFilterWidgetPluginHelp(...) (2-8)
modelIndex	that was clicked. If it�s empty, it�s a call from a link or from extern
fromLink	if true, a link called that slot

Member Data Documentation

int ito::HelpTreeDockWidget::m_autoCollTime

private

after this time the tree automatically becomes smaller

QString ito::HelpTreeDockWidget::m_dbPath

private

path from where the databases are loaded

bool ito::HelpTreeDockWidget::m_doingExpandAll

private

if expand all is executed from somewhere, the slots on_treeView_expanded or on_treeView_collapsed should not be called to avoid crazy never-ending loops in Qt5, debug.

QList<QModelIndex> ito::HelpTreeDockWidget::m_history

private

List to store the adresses of the last visited pages

bool ito::HelpTreeDockWidget::m_internalCall

private

If a page is called by the history buttons, this bool prevents from that this page is stored in the historylist again

bool ito::HelpTreeDockWidget::m_openLinks

private

decides if external links open when clicked

bool ito::HelpTreeDockWidget::m_plaintext

private

true: html code is displayed, false: normal help with style is displayed

LeafFilterProxyModel* ito::HelpTreeDockWidget::m_pMainFilterModel

private

Filtered Tree Model (between the model and the tree

QStandardItemModel* ito::HelpTreeDockWidget::m_pMainModel

private

Model to store the tree with all database entries

ito::AbstractDockWidget* ito::HelpTreeDockWidget::m_pParent

private

pointer to helpDockWidget with Toolbar

QMovie* ito::HelpTreeDockWidget::m_previewMovie

private

turning circle to show "wait" status

double ito::HelpTreeDockWidget::m_treeWidthInvisible

private

width of tree while small (in percent of the total width)

double ito::HelpTreeDockWidget::m_treeWidthVisible

private

width of tree while visible (in percent of the total width)

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

D:/itom/sources/itom/Qitom/ui/helpTreeDockWidget.h
D:/itom/sources/itom/Qitom/ui/helpTreeDockWidget.cpp

Classes

Public Types

Public Slots

Public Member Functions

Protected Member Functions

Private Slots

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Member Function Documentation

Member Data Documentation