Utility functions used by the Bitcoin Qt UI. More...

Classes
class	ClickableLabel

class	ClickableProgressBar

class	ItemDelegate

class	TableViewLastColumnResizingFixer
	Makes a QTableView last column feel as if it was being resized from its left border. More...

class	ToolTipToRichTextFilter
	Qt event filter that intercepts ToolTipChange events, and replaces the tooltip with a rich text representation if needed. More...

Typedefs
typedef ClickableProgressBar	ProgressBar

Functions
QString	dateTimeStr (const QDateTime &date)

QString	dateTimeStr (qint64 nTime)

QFont	fixedPitchFont ()

static std::string	MakeAddrInvalid (std::string addr, const CChainParams &params)

std::string	DummyAddress (const CChainParams &params)

QString	convertToCashAddr (const CChainParams &params, const QString &addr)

void	setupAddressWidget (QValidatedLineEdit widget, QWidget parent)

bool	parseBitcoinURI (const QString &scheme, const QUrl &uri, SendCoinsRecipient *out)

bool	parseBitcoinURI (const QString &scheme, QString uri, SendCoinsRecipient *out)

QString	formatBitcoinURI (const SendCoinsRecipient &info)

QString	formatBitcoinURI (const CChainParams &params, const SendCoinsRecipient &info)

bool	isDust (interfaces::Node &node, const QString &address, const Amount amount, const CChainParams &chainParams)

QString	HtmlEscape (const QString &str, bool fMultiLine)

QString	HtmlEscape (const std::string &str, bool fMultiLine)

void	copyEntryData (QAbstractItemView *view, int column, int role=Qt::EditRole)
	Copy a field of the currently selected entry of a view to the clipboard. More...

QList< QModelIndex >	getEntryData (QAbstractItemView *view, int column)
	Return a field of the currently selected entry as a QString. More...

QString	getDefaultDataDirectory ()
	Determine default data directory for operating system. More...

QString	getSaveFileName (QWidget parent, const QString &caption, const QString &dir, const QString &filter, QString selectedSuffixOut)
	Get save filename, mimics QFileDialog::getSaveFileName, except that it appends a default suffix when no suffix is provided by the user. More...

QString	getOpenFileName (QWidget parent, const QString &caption, const QString &dir, const QString &filter, QString selectedSuffixOut)
	Get open filename, convenience wrapper for QFileDialog::getOpenFileName. More...

Qt::ConnectionType	blockingGUIThreadConnection ()
	Get connection type to call object slot in GUI thread with invokeMethod. More...

bool	checkPoint (const QPoint &p, const QWidget *w)

bool	isObscured (QWidget *w)

void	bringToFront (QWidget *w)

void	openDebugLogfile ()

bool	openBitcoinConf ()

QStringList	splitSkipEmptyParts (const QString &s, const QString &separator)

bool	GetStartOnSystemStartup ()

bool	SetStartOnSystemStartup (bool fAutoStart)

void	setClipboard (const QString &str)

fs::path	qstringToBoostPath (const QString &path)

QString	boostPathToQString (const fs::path &path)

QString	formatDurationStr (int secs)

QString	formatServicesStr (quint64 mask)

QString	formatPingTime (int64_t ping_usec)

QString	formatTimeOffset (int64_t nTimeOffset)

QString	formatNiceTimeOffset (qint64 secs)

QString	formatBytes (uint64_t bytes)

qreal	calculateIdealFontSize (int width, const QString &text, QFont font, qreal minPointSize, qreal font_size)

int	TextWidth (const QFontMetrics &fm, const QString &text)
	Returns the distance in pixels appropriate for drawing a subsequent character after text. More...

void	PolishProgressDialog (QProgressDialog *dialog)

void	LogQtInfo ()
	Writes to debug.log short info about the used Qt and the host system. More...

Detailed Description

Utility functions used by the Bitcoin Qt UI.

Typedef Documentation

◆ ProgressBar

typedef ClickableProgressBar GUIUtil::ProgressBar

Definition at line 284 of file guiutil.h.

Function Documentation

◆ blockingGUIThreadConnection()

Qt::ConnectionType GUIUtil::blockingGUIThreadConnection ( )

Get connection type to call object slot in GUI thread with invokeMethod.

The call will be blocking.

Returns: If called from the GUI thread, return a Qt::DirectConnection. If called from another thread, return a Qt::BlockingQueuedConnection.

Definition at line 345 of file guiutil.cpp.

Here is the caller graph for this function:

◆ boostPathToQString()

QString GUIUtil::boostPathToQString ( const fs::path & path )

Definition at line 741 of file guiutil.cpp.

Here is the caller graph for this function:

◆ bringToFront()

void GUIUtil::bringToFront ( QWidget * w )

Definition at line 369 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ calculateIdealFontSize()

qreal GUIUtil::calculateIdealFontSize	(	int	width,
		const QString &	text,
		QFont	font,
		qreal	minPointSize,
		qreal	font_size
	)

Definition at line 847 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkPoint()

bool GUIUtil::checkPoint	(	const QPoint &	p,
		const QWidget *	w
	)

Definition at line 353 of file guiutil.cpp.

Here is the caller graph for this function:

◆ convertToCashAddr()

QString GUIUtil::convertToCashAddr	(	const CChainParams &	params,
		const QString &	addr
	)

Definition at line 108 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copyEntryData()

void GUIUtil::copyEntryData	(	QAbstractItemView *	view,
		int	column,
		int	role = `Qt::EditRole`
	)

Copy a field of the currently selected entry of a view to the clipboard.

Does nothing if nothing is selected.

Parameters

[in]	column	Data column to extract from the model
[in]	role	Data role to extract from the model

See also: TransactionView::copyLabel, TransactionView::copyAmount, TransactionView::copyAddress

Definition at line 250 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ dateTimeStr() [1/2]

QString GUIUtil::dateTimeStr ( const QDateTime & date )

Definition at line 65 of file guiutil.cpp.

Here is the caller graph for this function:

◆ dateTimeStr() [2/2]

QString GUIUtil::dateTimeStr ( qint64 nTime )

Definition at line 70 of file guiutil.cpp.

Here is the call graph for this function:

◆ DummyAddress()

std::string GUIUtil::DummyAddress ( const CChainParams & params )

Definition at line 93 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fixedPitchFont()

QFont GUIUtil::fixedPitchFont ( )

Definition at line 74 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatBitcoinURI() [1/2]

QString GUIUtil::formatBitcoinURI ( const SendCoinsRecipient & info )

Definition at line 197 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ formatBitcoinURI() [2/2]

QString GUIUtil::formatBitcoinURI	(	const CChainParams &	params,
		const SendCoinsRecipient &	info
	)

Definition at line 201 of file guiutil.cpp.

Here is the call graph for this function:

◆ formatBytes()

QString GUIUtil::formatBytes ( uint64_t bytes )

Definition at line 825 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatDurationStr()

QString GUIUtil::formatDurationStr ( int secs )

Definition at line 745 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatNiceTimeOffset()

QString GUIUtil::formatNiceTimeOffset ( qint64 secs )

Definition at line 796 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatPingTime()

QString GUIUtil::formatPingTime ( int64_t ping_usec )

Definition at line 784 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatServicesStr()

QString GUIUtil::formatServicesStr ( quint64 mask )

Definition at line 768 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ formatTimeOffset()

QString GUIUtil::formatTimeOffset ( int64_t nTimeOffset )

Definition at line 791 of file guiutil.cpp.

Here is the caller graph for this function:

◆ getDefaultDataDirectory()

QString GUIUtil::getDefaultDataDirectory ( )

Determine default data directory for operating system.

Definition at line 269 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getEntryData()

QList< QModelIndex > GUIUtil::getEntryData	(	QAbstractItemView *	view,
		int	column
	)

Return a field of the currently selected entry as a QString.

Does nothing if nothing is selected.

Parameters

[in] column Data column to extract from the model

See also: TransactionView::copyLabel, TransactionView::copyAmount, TransactionView::copyAddress

Definition at line 262 of file guiutil.cpp.

Here is the caller graph for this function:

◆ getOpenFileName()

QString GUIUtil::getOpenFileName	(	QWidget *	parent,
		const QString &	caption,
		const QString &	dir,
		const QString &	filter,
		QString *	selectedSuffixOut
	)

Get open filename, convenience wrapper for QFileDialog::getOpenFileName.

Parameters

[in]	parent	Parent window (or 0)
[in]	caption	Window caption (or empty, for default)
[in]	dir	Starting directory (or empty, to default to documents directory)
[in]	filter	Filter specification such as "Comma Separated Files (*.csv)"
[out]	selectedSuffixOut	Pointer to return the suffix (file type) that was selected (or 0). Can be useful when choosing the save file format based on suffix.

Definition at line 316 of file guiutil.cpp.

Here is the caller graph for this function:

◆ getSaveFileName()

QString GUIUtil::getSaveFileName	(	QWidget *	parent,
		const QString &	caption,
		const QString &	dir,
		const QString &	filter,
		QString *	selectedSuffixOut
	)

Get save filename, mimics QFileDialog::getSaveFileName, except that it appends a default suffix when no suffix is provided by the user.

Parameters

[in]	parent	Parent window (or 0)
[in]	caption	Window caption (or empty, for default)
[in]	dir	Starting directory (or empty, to default to documents directory)
[in]	filter	Filter specification such as "Comma Separated Files (*.csv)"
[out]	selectedSuffixOut	Pointer to return the suffix (file type) that was selected (or 0). Can be useful when choosing the save file format based on suffix.

Definition at line 273 of file guiutil.cpp.

Here is the caller graph for this function:

◆ GetStartOnSystemStartup()

bool GUIUtil::GetStartOnSystemStartup ( )

Definition at line 723 of file guiutil.cpp.

Here is the caller graph for this function:

◆ HtmlEscape() [1/2]

QString GUIUtil::HtmlEscape	(	const QString &	str,
		bool	fMultiLine
	)

Definition at line 238 of file guiutil.cpp.

Here is the caller graph for this function:

◆ HtmlEscape() [2/2]

QString GUIUtil::HtmlEscape	(	const std::string &	str,
		bool	fMultiLine
	)

Definition at line 246 of file guiutil.cpp.

Here is the call graph for this function:

◆ isDust()

bool GUIUtil::isDust	(	interfaces::Node &	node,
		const QString &	address,
		const Amount	amount,
		const CChainParams &	chainParams
	)

Definition at line 230 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isObscured()

bool GUIUtil::isObscured ( QWidget * w )

Definition at line 361 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LogQtInfo()

void GUIUtil::LogQtInfo ( )

Writes to debug.log short info about the used Qt and the host system.

Definition at line 896 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MakeAddrInvalid()

static std::string GUIUtil::MakeAddrInvalid	(	std::string	addr,
		const CChainParams &	params
	)

static

Definition at line 78 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ openBitcoinConf()

bool GUIUtil::openBitcoinConf ( )

Definition at line 396 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ openDebugLogfile()

void GUIUtil::openDebugLogfile ( )

Definition at line 386 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parseBitcoinURI() [1/2]

bool GUIUtil::parseBitcoinURI	(	const QString &	scheme,
		const QUrl &	uri,
		SendCoinsRecipient *	out
	)

Definition at line 131 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ parseBitcoinURI() [2/2]

bool GUIUtil::parseBitcoinURI	(	const QString &	scheme,
		QString	uri,
		SendCoinsRecipient *	out
	)

Definition at line 184 of file guiutil.cpp.

Here is the call graph for this function:

◆ PolishProgressDialog()

void GUIUtil::PolishProgressDialog ( QProgressDialog * dialog )

Definition at line 885 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ qstringToBoostPath()

fs::path GUIUtil::qstringToBoostPath ( const QString & path )

Definition at line 737 of file guiutil.cpp.

Here is the caller graph for this function:

◆ setClipboard()

void GUIUtil::setClipboard ( const QString & str )

Definition at line 732 of file guiutil.cpp.

Here is the caller graph for this function:

◆ SetStartOnSystemStartup()

bool GUIUtil::SetStartOnSystemStartup ( bool fAutoStart )

Definition at line 726 of file guiutil.cpp.

Here is the caller graph for this function:

◆ setupAddressWidget()

void GUIUtil::setupAddressWidget	(	QValidatedLineEdit *	widget,
		QWidget *	parent
	)

Definition at line 117 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ splitSkipEmptyParts()

QStringList GUIUtil::splitSkipEmptyParts	(	const QString &	s,
		const QString &	separator
	)

Definition at line 423 of file guiutil.cpp.

Here is the caller graph for this function:

◆ TextWidth()

int GUIUtil::TextWidth	(	const QFontMetrics &	fm,
		const QString &	text
	)

Returns the distance in pixels appropriate for drawing a subsequent character after text.

In Qt 5.12 and before the QFontMetrics::width() is used and it is deprecated since Qt 13.0. In Qt 5.11 the QFontMetrics::horizontalAdvance() was introduced.

Definition at line 877 of file guiutil.cpp.

Here is the caller graph for this function:

Classes

Typedefs

Functions

Detailed Description

Typedef Documentation

◆ ProgressBar

Function Documentation

◆ blockingGUIThreadConnection()

◆ boostPathToQString()

◆ bringToFront()

◆ calculateIdealFontSize()

◆ checkPoint()

◆ convertToCashAddr()

◆ copyEntryData()

◆ dateTimeStr() [1/2]

◆ dateTimeStr() [2/2]

◆ DummyAddress()

◆ fixedPitchFont()

◆ formatBitcoinURI() [1/2]

◆ formatBitcoinURI() [2/2]

◆ formatBytes()

◆ formatDurationStr()

◆ formatNiceTimeOffset()

◆ formatPingTime()

◆ formatServicesStr()

◆ formatTimeOffset()

◆ getDefaultDataDirectory()

◆ getEntryData()

◆ getOpenFileName()

◆ getSaveFileName()

◆ GetStartOnSystemStartup()

◆ HtmlEscape() [1/2]

◆ HtmlEscape() [2/2]

◆ isDust()

◆ isObscured()

◆ LogQtInfo()

◆ MakeAddrInvalid()

◆ openBitcoinConf()

◆ openDebugLogfile()

◆ parseBitcoinURI() [1/2]

◆ parseBitcoinURI() [2/2]

◆ PolishProgressDialog()

◆ qstringToBoostPath()

◆ setClipboard()

◆ SetStartOnSystemStartup()

◆ setupAddressWidget()

◆ splitSkipEmptyParts()

◆ TextWidth()