bitcoin/src/qt
MarcoFalke f9fd3a27fd
Merge #17750: util: change GetWarnings parameter to bool
7aab8d1024 [style] Code style fixups in GetWarnings() (John Newbery)
492c6dc1e7 util: change GetWarnings parameter to bool (John Newbery)
869b6314fd [qt] remove unused parameter from getWarnings() (John Newbery)

Pull request description:

  `GetWarnings()` changes the format of the output warning string based on a passed-in string argument that can be set to "gui" or "statusbar".

  Change the argument to a bool:

  - there are only two types of behaviour, so a bool is a more natural argument type
  - changing the name to `verbose` does not set any expectations for the how the calling code will use the returned string (currently, `statusbar` is used for RPC warnings, not a status bar)
  - removes some error-handling code for when the passed-in string is not one of the two strings expected.

ACKs for top commit:
  laanwj:
    code review ACK 7aab8d1024
  practicalswift:
    ACK 7aab8d1024 -- diff looks correct :)
  MarcoFalke:
    ACK 7aab8d1024 otherwise.
  promag:
    Code review ACK 7aab8d1024.

Tree-SHA512: 75882c6e3e44aa9586411b803149b36ba487f4eb9cac3f5c8f07cd9f586870bba4488a51e674cf8147f05718534f482836e6a4e3f66e0d4ef6821900c7dfd04e
2019-12-16 16:07:20 -05:00
..
forms qt: Normalize placeholder to avoid using "address book" in sendcoinsentry 2019-12-09 12:28:55 +01:00
locale qt: Periodic translations update 2019-09-30 09:41:11 +02:00
res qt: Remove menu icons 2019-08-15 13:05:10 +02:00
test Merge #17564: rpc: Use mempool from node context instead of global 2019-12-16 16:05:06 -05:00
addressbookpage.cpp Make reasoning about dependencies easier by not including unused dependencies 2019-06-02 17:15:23 +02:00
addressbookpage.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
addresstablemodel.cpp refactor: replace qLowerBound & qUpperBound with std:: upper_bound & lower_bound 2019-08-22 13:43:47 +08:00
addresstablemodel.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
askpassphrasedialog.cpp gui: fix passphrase labels/tooltip in createwalletdialog/askpassphrasedialog 2019-09-09 10:57:38 +02:00
askpassphrasedialog.h Optionally allow AskPassphraseDialog to output the passphrase 2019-09-05 20:36:57 -04:00
bantablemodel.cpp Use correct C++11 header for std::swap() 2019-11-29 21:23:25 +02:00
bantablemodel.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
bitcoin.cpp [qt] remove unused parameter from getWarnings() 2019-12-15 13:23:30 -03:00
bitcoin.h [gui] add explicit prune setter 2019-08-24 22:36:11 +02:00
bitcoin.qrc qt: Remove menu icons 2019-08-15 13:05:10 +02:00
bitcoin_locale.qrc qt: Periodic translations update 2019-09-30 09:41:11 +02:00
bitcoinaddressvalidator.cpp Update copyright headers to 2018 2018-07-27 07:15:02 -04:00
bitcoinaddressvalidator.h Added "Core" to copyright headers 2014-12-19 19:55:32 +01:00
bitcoinamountfield.cpp Send amount shows minimum amount placeholder 2019-10-19 13:46:59 +01:00
bitcoinamountfield.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
bitcoingui.cpp gui: disable File->CreateWallet during startup 2019-12-07 15:32:05 -05:00
bitcoingui.h Add Create Wallet menu action 2019-09-05 20:36:57 -04:00
bitcoinstrings.cpp qt: Run "make translate" in ./src 2019-09-16 09:45:11 -04:00
bitcoinunits.cpp Make reasoning about dependencies easier by not including unused dependencies 2019-06-02 17:15:23 +02:00
bitcoinunits.h Update copyright headers to 2018 2018-07-27 07:15:02 -04:00
clientmodel.cpp [qt] remove unused parameter from getWarnings() 2019-12-15 13:23:30 -03:00
clientmodel.h gui: Make polling in ClientModel asynchronous 2019-10-25 14:53:37 +01:00
coincontroldialog.cpp Refactor: Require scriptPubKey to get wallet SigningProvider 2019-11-18 15:42:01 -05:00
coincontroldialog.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
coincontroltreewidget.cpp Update copyright headers to 2018 2018-07-27 07:15:02 -04:00
coincontroltreewidget.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
createwalletdialog.cpp gui: rename encrypt(), blank(), and askPasshprase() 2019-09-09 10:56:38 +02:00
createwalletdialog.h gui: rename encrypt(), blank(), and askPasshprase() 2019-09-09 10:56:38 +02:00
csvmodelwriter.cpp Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
csvmodelwriter.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
editaddressdialog.cpp Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
editaddressdialog.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
guiconstants.h Expose wallet creation to the GUI via WalletController 2019-09-05 20:36:57 -04:00
guiutil.cpp Merge #17474: Bugfix: GUI: Recognise NETWORK_LIMITED in formatServicesStr 2019-12-11 17:00:27 -05:00
guiutil.h qt: Add TextWidth() wrapper 2019-08-23 21:27:50 +03:00
intro.cpp qt: Change default size of intro frame 2019-09-26 21:50:12 +02:00
intro.h [gui] intro: add prune preference 2019-08-24 22:41:32 +02:00
macdockiconhandler.h Remove obj_c for macOS Dock icon menu 2018-11-04 02:42:18 +02:00
macdockiconhandler.mm qt: Replace objc_msgSend with native syntax 2019-08-31 12:25:34 +03:00
macnotificationhandler.h convert C-style (void) parameter lists to C++ style () 2018-09-13 10:36:41 -07:00
macnotificationhandler.mm Refactoring with QString::toNSString 2018-12-16 20:29:56 +02:00
macos_appnap.h macOS: disable AppNap during sync 2018-11-01 18:22:06 +03:00
macos_appnap.mm macOS: disable AppNap during sync 2018-11-01 18:22:06 +03:00
main.cpp Refactor out translation.h 2019-07-24 16:32:53 +03:00
Makefile build: add stub makefiles for easier subdir builds 2014-06-05 16:05:43 -04:00
modaloverlay.cpp Merge #15084: gui: don't disable the sync overlay when wallet is disabled 2019-10-18 09:15:20 +02:00
modaloverlay.h Merge #15084: gui: don't disable the sync overlay when wallet is disabled 2019-10-18 09:15:20 +02:00
networkstyle.cpp Testchains: Qt: Simplify network/chain styles 2019-09-06 22:13:49 +02:00
networkstyle.h doc: Remove explicit network name references 2019-11-01 12:06:35 +01:00
notificator.cpp Remove misplaced Q_UNUSED and others enhancements 2018-12-20 01:06:37 +02:00
notificator.h Remove misplaced Q_UNUSED and others enhancements 2018-12-20 01:06:37 +02:00
openuridialog.cpp gui: Move static placeholder texts to forms 2019-12-09 11:12:20 +01:00
openuridialog.h gui: remove payment request file handling from OpenURI dialog 2019-10-24 16:01:43 -04:00
optionsdialog.cpp Merge #17702: gui: Move static placeholder texts to forms 2019-12-09 13:50:38 -05:00
optionsdialog.h Merge #13248: [gui] Make proxy icon from statusbar clickable 2018-08-20 13:40:11 +02:00
optionsmodel.cpp Remove BIP70 Support 2019-10-24 16:01:43 -04:00
optionsmodel.h Remove BIP70 Support 2019-10-24 16:01:43 -04:00
overviewpage.cpp Merge #14879: qt: Add warning messages to the debug window 2019-08-28 16:03:09 -04:00
overviewpage.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
paymentserver.cpp gui: Update BIP70 support message 2019-10-24 16:01:43 -04:00
paymentserver.h refactor: Nuke walletmodel circular dependency 2019-11-19 17:05:35 +02:00
peertablemodel.cpp Use correct C++11 header for std::swap() 2019-11-29 21:23:25 +02:00
peertablemodel.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
platformstyle.cpp gui: remove unused PlatformStyle::TextColorIcon 2019-08-22 14:50:29 +08:00
platformstyle.h gui: remove unused PlatformStyle::TextColorIcon 2019-08-22 14:50:29 +08:00
qrimagewidget.cpp gui: disable font antialiasing for QR image address 2019-10-25 13:20:32 -04:00
qrimagewidget.h GUI: Move QRImageWidget to its own file-pair 2019-05-02 12:18:18 +00:00
qvalidatedlineedit.cpp Replace remaining 0 with nullptr in Qt code 2019-01-13 03:25:14 -08:00
qvalidatedlineedit.h Update copyright headers to 2018 2018-07-27 07:15:02 -04:00
qvaluecombobox.cpp qt: Use new Qt5 connect syntax 2018-08-21 09:43:54 +01:00
qvaluecombobox.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
README.md Remove BIP70 Support 2019-10-24 16:01:43 -04:00
receivecoinsdialog.cpp Revert "gui: Generate bech32 addresses by default (take 2, fixup)" 2019-09-26 16:23:32 -04:00
receivecoinsdialog.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
receiverequestdialog.cpp refactor: Cleanup headers from walletmodel.h 2019-11-19 17:05:35 +02:00
receiverequestdialog.h refactor: Cleanup headers from walletmodel.h 2019-11-19 17:05:35 +02:00
recentrequeststablemodel.cpp Fix comparison function signature 2019-11-29 21:11:00 +02:00
recentrequeststablemodel.h Fix comparison function signature 2019-11-29 21:11:00 +02:00
rpcconsole.cpp gui: Make RPCConsole::TabTypes an enum class 2019-10-15 13:46:34 +01:00
rpcconsole.h gui: Make RPCConsole::TabTypes an enum class 2019-10-15 13:46:34 +01:00
sendcoinsdialog.cpp [gui] send: show watch-only balance in send screen 2019-11-26 11:43:53 +01:00
sendcoinsdialog.h [gui] watch-only wallet: copy PSBT to clipboard 2019-11-13 20:03:42 +01:00
sendcoinsentry.cpp gui: Move static placeholder texts to forms 2019-12-09 11:12:20 +01:00
sendcoinsentry.h refactor: Cleanup headers from walletmodel.h 2019-11-19 17:05:35 +02:00
sendcoinsrecipient.h refactor: Move SendCoinsRecipient in own header 2019-11-19 17:05:35 +02:00
signverifymessagedialog.cpp gui: Move static placeholder texts to forms 2019-12-09 11:12:20 +01:00
signverifymessagedialog.h Bump copyright headers to 2015 2015-12-13 18:08:39 +01:00
splashscreen.cpp Remove unused includes 2019-10-15 22:56:43 +00:00
splashscreen.h Cleanup SplashScreen class 2018-12-02 01:26:28 +02:00
trafficgraphwidget.cpp Add antialiasing to traffic graph widget 2019-07-02 07:26:40 +02:00
trafficgraphwidget.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
transactiondesc.cpp refactor: Nuke walletmodel circular dependency 2019-11-19 17:05:35 +02:00
transactiondesc.h Remove unused adjustedTime parameter 2018-10-28 09:04:10 +02:00
transactiondescdialog.cpp Update copyright headers to 2018 2018-07-27 07:15:02 -04:00
transactiondescdialog.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
transactionfilterproxy.cpp Update copyright headers to 2018 2018-07-27 07:15:02 -04:00
transactionfilterproxy.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
transactionrecord.cpp Merge #15098: qt: Show addresses for "SendToSelf" transactions 2019-10-09 14:35:29 -04:00
transactionrecord.h Don't label transactions "Open" while catching up 2019-01-03 00:10:24 +02:00
transactiontablemodel.cpp Merge #15098: qt: Show addresses for "SendToSelf" transactions 2019-10-09 14:35:29 -04:00
transactiontablemodel.h Don't use zero as null pointer constant (-Wzero-as-null-pointer-constant) 2019-01-13 03:25:14 -08:00
transactionview.cpp qt: Remove QSignalMapper from TransactionView 2019-08-25 09:12:38 +03:00
transactionview.h qt: Remove QSignalMapper from TransactionView 2019-08-25 09:12:38 +03:00
utilitydialog.cpp doc: Remove bitness from bitcoin-qt help message and manpage 2019-11-18 11:44:51 +01:00
utilitydialog.h Replace remaining 0 with nullptr in Qt code 2019-01-13 03:25:14 -08:00
walletcontroller.cpp refactor: Cleanup headers from walletmodel.h 2019-11-19 17:05:35 +02:00
walletcontroller.h refactor: Cleanup headers from walletmodel.h 2019-11-19 17:05:35 +02:00
walletframe.cpp refactor: Remove unused signal 2019-11-17 05:45:07 +02:00
walletframe.h gui: Drop unused return values in WalletFrame 2019-02-22 16:26:09 +00:00
walletmodel.cpp [gui] watch-only wallet: copy PSBT to clipboard 2019-11-13 20:03:42 +01:00
walletmodel.h refactor: Move SendCoinsRecipient in own header 2019-11-19 17:05:35 +02:00
walletmodeltransaction.cpp Remove BIP70 Support 2019-10-24 16:01:43 -04:00
walletmodeltransaction.h refactor: Nuke walletmodeltransaction circular dep 2019-11-19 17:05:35 +02:00
walletview.cpp HTML escape address labels in more dialogs and notifications 2019-09-08 16:40:37 -04:00
walletview.h refactor: Remove unused signal 2019-11-17 05:45:07 +02:00
winshutdownmonitor.cpp gui: remove OpenSSL PRNG seeding (Windows, Qt only) 2019-10-15 09:48:50 -04:00
winshutdownmonitor.h Update copyright headers to 2018 2018-07-27 07:15:02 -04:00

This directory contains the BitcoinQT graphical user interface (GUI). It uses the cross-platform framework Qt.

The current precise version for Qt 5 is specified in qt.mk.

Compile and run

See build instructions (macOS, Windows, Unix, etc).

To run:

./src/qt/bitcoin-qt

Files and directories

forms

Contains Designer UI files. They are created with Qt Creator, but can be edited using any text editor.

locale

Contains translations. They are periodically updated. The process is described here.

res

Resources such as the icon.

test

Tests.

bitcoingui.(h/cpp)

Represents the main window of the Bitcoin UI.

*model.(h/cpp)

The model. When it has a corresponding controller, it generally inherits from QAbstractTableModel. Models that are used by controllers as helpers inherit from other Qt classes like QValidator.

ClientModel is used by the main application bitcoingui and several models like peertablemodel.

*page.(h/cpp)

A controller. :NAMEpage.cpp generally includes :NAMEmodel.h and forms/:NAME.page.ui with a similar :NAME.

*dialog.(h/cpp)

Various dialogs, e.g. to open a URL. Inherit from QDialog.

paymentserver.(h/cpp)

Used to process BIP21 payment URI requests. Also handles URI based application switching (e.g. when following a bitcoin:... link from a browser).

walletview.(h/cpp)

Represents the view to a single wallet.

Other .h/cpp files

  • UI elements like BitcoinAmountField, which inherit from QWidget.
  • bitcoinstrings.cpp: automatically generated
  • bitcoinunits.(h/cpp): BTC / mBTC / etc handling
  • callback.h
  • guiconstants.h: UI colors, app name, etc
  • guiutil.h: several helper functions
  • macdockiconhandler.(h/mm): macOS dock icon handler
  • macnotificationhandler.(h/mm): display notifications in macOS

Contribute

See CONTRIBUTING.md for general guidelines. Specifically for Qt:

Using Qt Creator as IDE

You can use Qt Creator as an IDE. This is especially useful if you want to change the UI layout.

Download and install the community edition of Qt Creator. Uncheck everything except Qt Creator during the installation process.

Instructions for macOS:

  1. Make sure you installed everything through Homebrew mentioned in the macOS build instructions
  2. Use ./configure with the --enable-debug flag
  3. In Qt Creator do "New Project" -> Import Project -> Import Existing Project
  4. Enter "bitcoin-qt" as project name, enter src/qt as location
  5. Leave the file selection as it is
  6. Confirm the "summary page"
  7. In the "Projects" tab select "Manage Kits..."
  8. Select the default "Desktop" kit and select "Clang (x86 64bit in /usr/bin)" as compiler
  9. Select LLDB as debugger (you might need to set the path to your installation)
  10. Start debugging with Qt Creator (you might need to the executable to "bitcoin-qt" under "Run", which is where you can also add command line arguments)