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

Classes
class	ClickableLabel

class	ClickableProgressBar

class	ItemDelegate

class	LabelOutOfFocusEventFilter
	Qt event filter that intercepts QEvent::FocusOut events for QLabel objects, and resets their ‘textInteractionFlags’ property to get rid of the visible cursor. 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 (bool use_embedded_font)

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

void	setupAddressWidget (QValidatedLineEdit widget, QWidget parent)

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

bool	parseBitcoinURI (QString uri, SendCoinsRecipient *out)

QString	formatBitcoinURI (const SendCoinsRecipient &info)

bool	isDust (interfaces::Node &node, const QString &address, const CAmount &amount)

QString	HtmlEscape (const QString &str, bool fMultiLine)

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

void	copyEntryData (const 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 (const QAbstractItemView *view, int column)
	Return a field of the currently selected entry as a QString. More...

bool	hasEntryData (const QAbstractItemView *view, int column, int role)
	Returns true if the specified field of the currently selected view entry is not empty. 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	handleCloseWindowShortcut (QWidget *w)

void	openDebugLogfile ()

bool	openBitcoinConf ()

bool	GetStartOnSystemStartup ()

bool	SetStartOnSystemStartup (bool fAutoStart)

void	setClipboard (const QString &str)

fs::path	qstringToBoostPath (const QString &path)
	Convert QString to OS specific boost path through UTF-8. More...

QString	boostPathToQString (const fs::path &path)
	Convert OS specific boost path to QString through UTF-8. More...

QString	NetworkToQString (Network net)
	Convert enum Network to QString. More...

QString	ConnectionTypeToQString (ConnectionType conn_type, bool prepend_direction)
	Convert enum ConnectionType to QString. More...

QString	formatDurationStr (int secs)
	Convert seconds into a QString with days, hours, mins, secs. More...

QString	formatServicesStr (quint64 mask)
	Format CNodeStats.nServices bitmask into a user-readable string. More...

QString	formatPingTime (std::chrono::microseconds ping_time)
	Format a CNodeStats.m_last_ping_time into a user-readable string or display N/A, if 0. More...

QString	formatTimeOffset (int64_t nTimeOffset)
	Format a CNodeCombinedStats.nTimeOffset into a user-readable string. More...

QString	formatNiceTimeOffset (qint64 secs)

QString	formatBytes (uint64_t bytes)

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

void	PolishProgressDialog (QProgressDialog *dialog)

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

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

void	PopupMenu (QMenu menu, const QPoint &point, QAction at_action=nullptr)
	Call QMenu::popup() only on supported QT_QPA_PLATFORM. More...

QDateTime	StartOfDay (const QDate &date)
	Returns the start-moment of the day in local time. More...

bool	HasPixmap (const QLabel *label)
	Returns true if pixmap has been set. More...

QImage	GetImage (const QLabel *label)

template<typename SeparatorType >
QStringList	SplitSkipEmptyParts (const QString &string, const SeparatorType &separator)
	Splits the string into substrings wherever separator occurs, and returns the list of those strings. More...

template<typename Fn >
void	ObjectInvoke (QObject *object, Fn &&function, Qt::ConnectionType connection=Qt::QueuedConnection)
	Queue a function to run in an object's event loop. More...

Variables
static const uint8_t	dummydata [] = {0xeb,0x15,0x23,0x1d,0xfc,0xeb,0x60,0x92,0x58,0x86,0xb6,0x7d,0x06,0x52,0x99,0x92,0x59,0x15,0xae,0xb1,0x72,0xc0,0x66,0x47}

constexpr auto	dialog_flags = Qt::WindowTitleHint \| Qt::WindowSystemMenuHint \| Qt::WindowCloseButtonHint

Detailed Description

Utility functions used by the Bitcoin Qt UI.

Typedef Documentation

◆ ProgressBar

typedef ClickableProgressBar GUIUtil::ProgressBar

Definition at line 245 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 347 of file guiutil.cpp.

Here is the caller graph for this function:

◆ boostPathToQString()

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

Convert OS specific boost path to QString through UTF-8.

Definition at line 640 of file guiutil.cpp.

Here is the caller graph for this function:

◆ bringToFront()

void GUIUtil::bringToFront ( QWidget * w )

Definition at line 375 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 772 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 359 of file guiutil.cpp.

Here is the caller graph for this function:

◆ ConnectionTypeToQString()

QString GUIUtil::ConnectionTypeToQString	(	ConnectionType	conn_type,
		bool	prepend_direction
	)

Convert enum ConnectionType to QString.

Definition at line 660 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copyEntryData()

void GUIUtil::copyEntryData	(	const 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 238 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 73 of file guiutil.cpp.

Here is the caller graph for this function:

◆ dateTimeStr() [2/2]

QString GUIUtil::dateTimeStr ( qint64 nTime )

Definition at line 78 of file guiutil.cpp.

Here is the call graph for this function:

◆ DummyAddress()

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

static

Definition at line 95 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fixedPitchFont()

QFont GUIUtil::fixedPitchFont ( bool use_embedded_font )

Definition at line 83 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatBitcoinURI()

QString GUIUtil::formatBitcoinURI ( const SendCoinsRecipient & info )

Definition at line 185 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ formatBytes()

QString GUIUtil::formatBytes ( uint64_t bytes )

Definition at line 760 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatDurationStr()

QString GUIUtil::formatDurationStr ( int secs )

Convert seconds into a QString with days, hours, mins, secs.

Definition at line 677 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatNiceTimeOffset()

QString GUIUtil::formatNiceTimeOffset ( qint64 secs )

Definition at line 723 of file guiutil.cpp.

Here is the caller graph for this function:

◆ formatPingTime()

QString GUIUtil::formatPingTime ( std::chrono::microseconds ping_time )

Format a CNodeStats.m_last_ping_time into a user-readable string or display N/A, if 0.

Definition at line 711 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ formatServicesStr()

QString GUIUtil::formatServicesStr ( quint64 mask )

Format CNodeStats.nServices bitmask into a user-readable string.

Definition at line 697 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 )

Format a CNodeCombinedStats.nTimeOffset into a user-readable string.

Definition at line 718 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 265 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	(	const 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 251 of file guiutil.cpp.

Here is the caller graph for this function:

◆ GetImage()

QImage GUIUtil::GetImage ( const QLabel * label )

Definition at line 883 of file guiutil.cpp.

Here is the call graph for this function:

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 270 of file guiutil.cpp.

Here is the caller graph for this function:

◆ GetStartOnSystemStartup()

bool GUIUtil::GetStartOnSystemStartup ( )

Definition at line 624 of file guiutil.cpp.

Here is the caller graph for this function:

◆ handleCloseWindowShortcut()

void GUIUtil::handleCloseWindowShortcut ( QWidget * w )

Definition at line 393 of file guiutil.cpp.

Here is the caller graph for this function:

◆ hasEntryData()

bool GUIUtil::hasEntryData	(	const QAbstractItemView *	view,
		int	column,
		int	role
	)

Returns true if the specified field of the currently selected view entry is not empty.

Parameters

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

See also: TransactionView::contextualMenu

Definition at line 258 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HasPixmap()

bool GUIUtil::HasPixmap ( const QLabel * label )

Returns true if pixmap has been set.

QPixmap* QLabel::pixmap() is deprecated since Qt 5.15.

Definition at line 874 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 223 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 233 of file guiutil.cpp.

Here is the call graph for this function:

◆ isDust()

bool GUIUtil::isDust	(	interfaces::Node &	node,
		const QString &	address,
		const CAmount &	amount
	)

Definition at line 215 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 366 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 825 of file guiutil.cpp.

Here is the caller graph for this function:

◆ NetworkToQString()

QString GUIUtil::NetworkToQString ( Network net )

Convert enum Network to QString.

Definition at line 645 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ObjectInvoke()

template<typename Fn >

void GUIUtil::ObjectInvoke	(	QObject *	object,
		Fn &&	function,
		Qt::ConnectionType	connection = `Qt::QueuedConnection`
	)

Queue a function to run in an object's event loop.

This can be replaced by a call to the QMetaObject::invokeMethod functor overload after Qt 5.10, but for now use a QObject::connect for compatibility with older Qt versions, based on https://stackoverflow.com/questions/21646467/how-to-execute-a-functor-or-a-lambda-in-a-given-thread-in-qt-gcd-style

Definition at line 324 of file guiutil.h.

Here is the caller graph for this function:

◆ openBitcoinConf()

bool GUIUtil::openBitcoinConf ( )

Definition at line 407 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 398 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 QUrl &	uri,
		SendCoinsRecipient *	out
	)

Definition at line 122 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	(	QString	uri,
		SendCoinsRecipient *	out
	)

Definition at line 179 of file guiutil.cpp.

Here is the call graph for this function:

◆ PolishProgressDialog()

void GUIUtil::PolishProgressDialog ( QProgressDialog * dialog )

Definition at line 804 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ PopupMenu()

void GUIUtil::PopupMenu	(	QMenu *	menu,
		const QPoint &	point,
		QAction *	at_action
	)

Call QMenu::popup() only on supported QT_QPA_PLATFORM.

Definition at line 858 of file guiutil.cpp.

Here is the caller graph for this function:

◆ qstringToBoostPath()

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

Convert QString to OS specific boost path through UTF-8.

Definition at line 635 of file guiutil.cpp.

Here is the caller graph for this function:

◆ setClipboard()

void GUIUtil::setClipboard ( const QString & str )

Definition at line 629 of file guiutil.cpp.

Here is the caller graph for this function:

◆ SetStartOnSystemStartup()

bool GUIUtil::SetStartOnSystemStartup ( bool fAutoStart )

Definition at line 625 of file guiutil.cpp.

Here is the caller graph for this function:

◆ setupAddressWidget()

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

Definition at line 109 of file guiutil.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SplitSkipEmptyParts()

template<typename SeparatorType >

QStringList GUIUtil::SplitSkipEmptyParts	(	const QString &	string,
		const SeparatorType &	separator
	)

Splits the string into substrings wherever separator occurs, and returns the list of those strings.

Empty strings do not appear in the result.

QString::split() signature differs in different Qt versions:

QString::SplitBehavior is deprecated since Qt 5.15
Qt::SplitBehavior was introduced in Qt 5.14 If {QString|Qt}::SkipEmptyParts behavior is required, use this function instead of QString::split().

Definition at line 308 of file guiutil.h.

Here is the caller graph for this function:

◆ StartOfDay()

QDateTime GUIUtil::StartOfDay ( const QDate & date )

Returns the start-moment of the day in local time.

QDateTime::QDateTime(const QDate& date) is deprecated since Qt 5.15. QDate::startOfDay() was introduced in Qt 5.14.

Definition at line 865 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 5.13. In Qt 5.11 the QFontMetrics::horizontalAdvance() was introduced.

Definition at line 816 of file guiutil.cpp.

Here is the caller graph for this function:

Variable Documentation

◆ dialog_flags

constexpr auto GUIUtil::dialog_flags = Qt::WindowTitleHint | Qt::WindowSystemMenuHint | Qt::WindowCloseButtonHint

constexpr

Definition at line 51 of file guiutil.h.

◆ dummydata

const uint8_t GUIUtil::dummydata[] = {0xeb,0x15,0x23,0x1d,0xfc,0xeb,0x60,0x92,0x58,0x86,0xb6,0x7d,0x06,0x52,0x99,0x92,0x59,0x15,0xae,0xb1,0x72,0xc0,0x66,0x47}

static

Definition at line 92 of file guiutil.cpp.

Classes

Typedefs

Functions

Variables

Detailed Description

Typedef Documentation

◆ ProgressBar

Function Documentation

◆ blockingGUIThreadConnection()

◆ boostPathToQString()

◆ bringToFront()

◆ calculateIdealFontSize()

◆ checkPoint()

◆ ConnectionTypeToQString()

◆ copyEntryData()

◆ dateTimeStr() [1/2]

◆ dateTimeStr() [2/2]

◆ DummyAddress()

◆ fixedPitchFont()

◆ formatBitcoinURI()

◆ formatBytes()

◆ formatDurationStr()

◆ formatNiceTimeOffset()

◆ formatPingTime()

◆ formatServicesStr()

◆ formatTimeOffset()

◆ getDefaultDataDirectory()

◆ getEntryData()

◆ GetImage()

◆ getOpenFileName()

◆ getSaveFileName()

◆ GetStartOnSystemStartup()

◆ handleCloseWindowShortcut()

◆ hasEntryData()

◆ HasPixmap()

◆ HtmlEscape() [1/2]

◆ HtmlEscape() [2/2]

◆ isDust()

◆ isObscured()

◆ LogQtInfo()

◆ NetworkToQString()

◆ ObjectInvoke()

◆ openBitcoinConf()

◆ openDebugLogfile()

◆ parseBitcoinURI() [1/2]

◆ parseBitcoinURI() [2/2]

◆ PolishProgressDialog()

◆ PopupMenu()

◆ qstringToBoostPath()

◆ setClipboard()

◆ SetStartOnSystemStartup()

◆ setupAddressWidget()

◆ SplitSkipEmptyParts()

◆ StartOfDay()

◆ TextWidth()

Variable Documentation

◆ dialog_flags

◆ dummydata