Bitcoin Core 28.99.0
P2P Digital Currency
utilitydialog.cpp
Go to the documentation of this file.
1// Copyright (c) 2011-2022 The Bitcoin Core developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
5#include <bitcoin-build-config.h> // IWYU pragma: keep
6
7#include <qt/utilitydialog.h>
8
9#include <qt/forms/ui_helpmessagedialog.h>
10
11#include <qt/guiutil.h>
12
13#include <clientversion.h>
14#include <common/args.h>
15#include <init.h>
16#include <util/strencodings.h>
17
18#include <cstdio>
19
20#include <QCloseEvent>
21#include <QLabel>
22#include <QMainWindow>
23#include <QRegularExpression>
24#include <QString>
25#include <QTextCursor>
26#include <QTextTable>
27#include <QVBoxLayout>
28
30HelpMessageDialog::HelpMessageDialog(QWidget *parent, bool about) :
31 QDialog(parent, GUIUtil::dialog_flags),
32 ui(new Ui::HelpMessageDialog)
33{
34 ui->setupUi(this);
35
36 QString version = QString{CLIENT_NAME} + " " + tr("version") + " " + QString::fromStdString(FormatFullVersion());
37
38 if (about)
39 {
40 setWindowTitle(tr("About %1").arg(CLIENT_NAME));
41
42 std::string licenseInfo = LicenseInfo();
44 QString licenseInfoHTML = QString::fromStdString(LicenseInfo());
45 // Make URLs clickable
46 QRegularExpression uri(QStringLiteral("<(.*)>"), QRegularExpression::InvertedGreedinessOption);
47 licenseInfoHTML.replace(uri, QStringLiteral("<a href=\"\\1\">\\1</a>"));
48 // Replace newlines with HTML breaks
49 licenseInfoHTML.replace("\n", "<br>");
50
51 ui->aboutMessage->setTextFormat(Qt::RichText);
52 ui->scrollArea->setVerticalScrollBarPolicy(Qt::ScrollBarAsNeeded);
53 text = version + "\n" + QString::fromStdString(FormatParagraph(licenseInfo));
54 ui->aboutMessage->setText(version + "<br><br>" + licenseInfoHTML);
55 ui->aboutMessage->setWordWrap(true);
56 ui->helpMessage->setVisible(false);
57 } else {
58 setWindowTitle(tr("Command-line options"));
59 QString header = "The bitcoin-qt application provides a graphical interface for interacting with " CLIENT_NAME ".\n\n"
60 "It combines the core functionalities of bitcoind with a user-friendly interface for wallet management, transaction history, and network statistics.\n\n"
61 "It is suitable for users who prefer a graphical over a command-line interface.\n\n"
62 "You can optionally specify a payment [URI], in e.g. the BIP21 URI format.\n\n"
63 "Usage: bitcoin-qt [options] [URI]\n\n";
64 QTextCursor cursor(ui->helpMessage->document());
65 cursor.insertText(version);
66 cursor.insertBlock();
67 cursor.insertText(header);
68 cursor.insertBlock();
69
70 std::string strUsage = gArgs.GetHelpMessage();
71 QString coreOptions = QString::fromStdString(strUsage);
72 text = version + "\n\n" + header + "\n" + coreOptions;
73
74 QTextTableFormat tf;
75 tf.setBorderStyle(QTextFrameFormat::BorderStyle_None);
76 tf.setCellPadding(2);
77 QVector<QTextLength> widths;
78 widths << QTextLength(QTextLength::PercentageLength, 35);
79 widths << QTextLength(QTextLength::PercentageLength, 65);
80 tf.setColumnWidthConstraints(widths);
81
82 QTextCharFormat bold;
83 bold.setFontWeight(QFont::Bold);
84
85 for (const QString &line : coreOptions.split("\n")) {
86 if (line.startsWith(" -"))
87 {
88 cursor.currentTable()->appendRows(1);
89 cursor.movePosition(QTextCursor::PreviousCell);
90 cursor.movePosition(QTextCursor::NextRow);
91 cursor.insertText(line.trimmed());
92 cursor.movePosition(QTextCursor::NextCell);
93 } else if (line.startsWith(" ")) {
94 cursor.insertText(line.trimmed()+' ');
95 } else if (line.size() > 0) {
96 //Title of a group
97 if (cursor.currentTable())
98 cursor.currentTable()->appendRows(1);
99 cursor.movePosition(QTextCursor::Down);
100 cursor.insertText(line.trimmed(), bold);
101 cursor.insertTable(1, 2, tf);
102 }
103 }
104
105 ui->helpMessage->moveCursor(QTextCursor::Start);
106 ui->scrollArea->setVisible(false);
107 ui->aboutLogo->setVisible(false);
108 }
109
111}
112
114{
115 delete ui;
116}
117
119{
120 // On other operating systems, the expected action is to print the message to the console.
121 tfm::format(std::cout, "%s", qPrintable(text));
122}
123
125{
126#if defined(WIN32)
127 // On Windows, show a message box, as there is no stderr/stdout in windowed applications
128 exec();
129#else
130 // On other operating systems, print help text to console
132#endif
133}
134
136{
137 close();
138}
139
140
142ShutdownWindow::ShutdownWindow(QWidget *parent, Qt::WindowFlags f):
143 QWidget(parent, f)
144{
145 QVBoxLayout *layout = new QVBoxLayout();
146 layout->addWidget(new QLabel(
147 tr("%1 is shutting down…").arg(CLIENT_NAME) + "<br /><br />" +
148 tr("Do not shut down the computer until this window disappears.")));
149 setLayout(layout);
150
152}
153
154QWidget* ShutdownWindow::showShutdownWindow(QMainWindow* window)
155{
156 assert(window != nullptr);
157
158 // Show a simple window indicating shutdown status
159 QWidget *shutdownWindow = new ShutdownWindow();
160 shutdownWindow->setWindowTitle(window->windowTitle());
161
162 // Center shutdown window at where main window was
163 const QPoint global = window->mapToGlobal(window->rect().center());
164 shutdownWindow->move(global.x() - shutdownWindow->width() / 2, global.y() - shutdownWindow->height() / 2);
165 shutdownWindow->show();
166 return shutdownWindow;
167}
168
169void ShutdownWindow::closeEvent(QCloseEvent *event)
170{
171 event->ignore();
172}
ArgsManager gArgs
Definition: args.cpp:42
std::string GetHelpMessage() const
Get the help string.
Definition: args.cpp:609
"Help message" dialog box
Definition: utilitydialog.h:21
HelpMessageDialog(QWidget *parent, bool about)
"Help message" or "About" dialog box
Ui::HelpMessageDialog * ui
Definition: utilitydialog.h:32
ShutdownWindow(QWidget *parent=nullptr, Qt::WindowFlags f=Qt::Widget)
"Shutdown" window
void closeEvent(QCloseEvent *event) override
static QWidget * showShutdownWindow(QMainWindow *window)
std::string FormatFullVersion()
std::string LicenseInfo()
Returns licensing information (for -version)
Utility functions used by the Bitcoin Qt UI.
Definition: bitcoingui.h:58
void handleCloseWindowShortcut(QWidget *w)
Definition: guiutil.cpp:431
constexpr auto dialog_flags
Definition: guiutil.h:60
void format(std::ostream &out, FormatStringCheck< sizeof...(Args)> fmt, const Args &... args)
Format list of arguments to the stream according to given format string.
Definition: tinyformat.h:1072
std::string FormatParagraph(std::string_view in, size_t width, size_t indent)
Format a paragraph of text to a fixed width, adding spaces for indentation to any added line.
assert(!tx.IsCoinBase())