From af836ad58808a1f6437a8b9a76b670c07c9a1212 Mon Sep 17 00:00:00 2001 From: "Wladimir J. van der Laan" Date: Sun, 13 Nov 2011 13:19:52 +0100 Subject: [PATCH] Improve documentation for UI classes --- src/qt/aboutdialog.h | 1 + src/qt/addressbookpage.h | 6 ++- src/qt/addresstablemodel.h | 27 +++++++------ src/qt/askpassphrasedialog.h | 10 +++-- src/qt/bitcoinaddressvalidator.h | 2 +- src/qt/bitcoinamountfield.h | 18 +++++---- src/qt/bitcoinunits.h | 67 ++++++++++++++++++-------------- src/qt/clientmodel.h | 10 ++--- src/qt/csvmodelwriter.h | 9 +++-- src/qt/editaddressdialog.h | 2 + src/qt/guiutil.h | 2 + src/qt/macdockiconhandler.h | 2 + src/qt/monitoreddatamapper.h | 5 +-- src/qt/notificator.h | 35 +++++++++-------- src/qt/optionsdialog.h | 3 ++ src/qt/optionsmodel.h | 2 +- src/qt/overviewpage.h | 1 + src/qt/qvalidatedlineedit.h | 5 ++- src/qt/qvaluecombobox.h | 7 ++-- src/qt/sendcoinsdialog.h | 5 ++- src/qt/sendcoinsentry.h | 7 ++-- src/qt/transactiondesc.h | 3 +- src/qt/transactiondescdialog.h | 1 + src/qt/transactionfilterproxy.h | 14 ++++--- src/qt/transactionrecord.h | 37 +++++++++++------- src/qt/transactiontablemodel.h | 33 +++++++++------- src/qt/transactionview.h | 3 ++ src/qt/walletmodel.h | 2 +- 28 files changed, 188 insertions(+), 131 deletions(-) diff --git a/src/qt/aboutdialog.h b/src/qt/aboutdialog.h index d2caa3eed..2ed9e9e7c 100644 --- a/src/qt/aboutdialog.h +++ b/src/qt/aboutdialog.h @@ -8,6 +8,7 @@ namespace Ui { } class ClientModel; +/** "About" dialog box */ class AboutDialog : public QDialog { Q_OBJECT diff --git a/src/qt/addressbookpage.h b/src/qt/addressbookpage.h index ef64d1753..1a97f3d60 100644 --- a/src/qt/addressbookpage.h +++ b/src/qt/addressbookpage.h @@ -14,6 +14,8 @@ class QItemSelection; class QSortFilterProxyModel; QT_END_NAMESPACE +/** Widget that shows a list of sending or receiving addresses. + */ class AddressBookPage : public QDialog { Q_OBJECT @@ -25,8 +27,8 @@ public: }; enum Mode { - ForSending, // Pick address for sending - ForEditing // Open address book for editing + ForSending, /**< Open address book to pick address for sending */ + ForEditing /**< Open address book for editing */ }; explicit AddressBookPage(Mode mode, Tabs tab, QWidget *parent = 0); diff --git a/src/qt/addresstablemodel.h b/src/qt/addresstablemodel.h index f4a8dad84..074330013 100644 --- a/src/qt/addresstablemodel.h +++ b/src/qt/addresstablemodel.h @@ -8,6 +8,9 @@ class AddressTablePriv; class CWallet; class WalletModel; +/** + Qt model of the address book in the core. This allows views to access and modify the address book. + */ class AddressTableModel : public QAbstractTableModel { Q_OBJECT @@ -16,27 +19,28 @@ public: ~AddressTableModel(); enum ColumnIndex { - Label = 0, /* User specified label */ - Address = 1 /* Bitcoin address */ + Label = 0, /**< User specified label */ + Address = 1 /**< Bitcoin address */ }; enum RoleIndex { - TypeRole = Qt::UserRole + TypeRole = Qt::UserRole /**< Type of address (#Send or #Receive) */ }; - // Return status of last edit/insert operation + /** Return status of edit/insert operation */ enum EditStatus { OK, - INVALID_ADDRESS, - DUPLICATE_ADDRESS, - WALLET_UNLOCK_FAILURE, - KEY_GENERATION_FAILURE + INVALID_ADDRESS, /**< Unparseable address */ + DUPLICATE_ADDRESS, /**< Address already in address book */ + WALLET_UNLOCK_FAILURE, /**< Wallet could not be unlocked to create new receiving address */ + KEY_GENERATION_FAILURE /**< Generating a new public key for a receiving address failed */ }; - static const QString Send; /* Send addres */ - static const QString Receive; /* Receive address */ + static const QString Send; /**< Specifies send address */ + static const QString Receive; /**< Specifies receive address */ - /* Overridden methods from QAbstractTableModel */ + /** @name Methods overridden from QAbstractTableModel + @{*/ int rowCount(const QModelIndex &parent) const; int columnCount(const QModelIndex &parent) const; QVariant data(const QModelIndex &index, int role) const; @@ -45,6 +49,7 @@ public: QModelIndex index(int row, int column, const QModelIndex & parent) const; bool removeRows(int row, int count, const QModelIndex & parent = QModelIndex()); Qt::ItemFlags flags(const QModelIndex & index) const; + /*@}*/ /* Add an address to the model. Returns the added address on success, and an empty string otherwise. diff --git a/src/qt/askpassphrasedialog.h b/src/qt/askpassphrasedialog.h index 761612cbf..32a3f6a5f 100644 --- a/src/qt/askpassphrasedialog.h +++ b/src/qt/askpassphrasedialog.h @@ -9,16 +9,18 @@ namespace Ui { class WalletModel; +/** Multifunctional dialog to ask for passphrases. Used for encryption, unlocking, and changing the passphrase. + */ class AskPassphraseDialog : public QDialog { Q_OBJECT public: enum Mode { - Encrypt, // Ask passphrase x2 - Unlock, // Ask passphrase - ChangePass, // Ask old passphrase + new passphrase x2 - Decrypt // Ask passphrase + Encrypt, /**< Ask passphrase twice and encrypt */ + Unlock, /**< Ask passphrase and unlock */ + ChangePass, /**< Ask old passphrase + new passphrase twice */ + Decrypt /**< Ask passphrase and decrypt wallet */ }; explicit AskPassphraseDialog(Mode mode, QWidget *parent = 0); diff --git a/src/qt/bitcoinaddressvalidator.h b/src/qt/bitcoinaddressvalidator.h index 73f6ea1f6..6ca3bd6a0 100644 --- a/src/qt/bitcoinaddressvalidator.h +++ b/src/qt/bitcoinaddressvalidator.h @@ -3,7 +3,7 @@ #include -/* Base48 entry widget validator. +/** Base48 entry widget validator. Corrects near-miss characters and refuses characters that are no part of base48. */ class BitcoinAddressValidator : public QValidator diff --git a/src/qt/bitcoinamountfield.h b/src/qt/bitcoinamountfield.h index 8457a418c..ead8bdb84 100644 --- a/src/qt/bitcoinamountfield.h +++ b/src/qt/bitcoinamountfield.h @@ -8,8 +8,8 @@ class QDoubleSpinBox; class QValueComboBox; QT_END_NAMESPACE -// Coin amount entry widget with separate parts for whole -// coins and decimals. +/** Widget for entering bitcoin amounts. + */ class BitcoinAmountField: public QWidget { Q_OBJECT @@ -20,25 +20,27 @@ public: qint64 value(bool *valid=0) const; void setValue(qint64 value); - // Mark current valid as invalid in UI + /** Mark current value as invalid in UI. */ void setValid(bool valid); + /** Perform input validation, mark field as invalid if entered value is not valid. */ bool validate(); - // Change current unit + /** Change unit used to display amount. */ void setDisplayUnit(int unit); - // Make field empty and ready for new input + /** Make field empty and ready for new input. */ void clear(); - // Qt messes up the tab chain by default in some cases (issue http://bugreports.qt.nokia.com/browse/QTBUG-10907) - // Hence we have to set it up manually + /** Qt messes up the tab chain by default in some cases (issue http://bugreports.qt.nokia.com/browse/QTBUG-10907), + in these cases we have to set it up manually. + */ QWidget *setupTabChain(QWidget *prev); signals: void textChanged(); protected: - // Intercept focus-in event and ',' keypresses + /** Intercept focus-in event and ',' keypresses */ bool eventFilter(QObject *object, QEvent *event); private: diff --git a/src/qt/bitcoinunits.h b/src/qt/bitcoinunits.h index a7bebbc3e..18fa36a0b 100644 --- a/src/qt/bitcoinunits.h +++ b/src/qt/bitcoinunits.h @@ -4,51 +4,60 @@ #include #include -// Bitcoin unit definitions, encapsulates parsing and formatting -// and serves as list model for dropdown selection boxes. +/** Bitcoin unit definitions. Encapsulates parsing and formatting + and serves as list model for dropdown selection boxes. +*/ class BitcoinUnits: public QAbstractListModel { public: explicit BitcoinUnits(QObject *parent); + /** Bitcoin units. + @note Source: https://en.bitcoin.it/wiki/Units . Please add only sensible ones + */ enum Unit { - // Source: https://en.bitcoin.it/wiki/Units - // Please add only sensible ones BTC, mBTC, uBTC }; - /// Static API - // Get list of units, for dropdown box - static QList availableUnits(); - // Is unit ID valid? - static bool valid(int unit); - // Short name - static QString name(int unit); - // Longer description - static QString description(int unit); - // Number of satoshis / unit - static qint64 factor(int unit); - // Number of amount digits (to represent max number of coins) - static int amountDigits(int unit); - // Number of decimals left - static int decimals(int unit); - // Format as string - static QString format(int unit, qint64 amount, bool plussign=false); - // Format as string (with unit) - static QString formatWithUnit(int unit, qint64 amount, bool plussign=false); - // Parse string to coin amount - static bool parse(int unit, const QString &value, qint64 *val_out); + //! @name Static API + //! Unit conversion and formatting + ///@{ - /// AbstractListModel implementation - enum { - // Unit identifier + //! Get list of units, for dropdown box + static QList availableUnits(); + //! Is unit ID valid? + static bool valid(int unit); + //! Short name + static QString name(int unit); + //! Longer description + static QString description(int unit); + //! Number of Satoshis (1e-8) per unit + static qint64 factor(int unit); + //! Number of amount digits (to represent max number of coins) + static int amountDigits(int unit); + //! Number of decimals left + static int decimals(int unit); + //! Format as string + static QString format(int unit, qint64 amount, bool plussign=false); + //! Format as string (with unit) + static QString formatWithUnit(int unit, qint64 amount, bool plussign=false); + //! Parse string to coin amount + static bool parse(int unit, const QString &value, qint64 *val_out); + ///@} + + //! @name AbstractListModel implementation + //! List model for unit dropdown selection box. + ///@{ + enum RoleIndex { + /** Unit identifier */ UnitRole = Qt::UserRole - } RoleIndex; + }; int rowCount(const QModelIndex &parent) const; QVariant data(const QModelIndex &index, int role) const; + ///@} private: QList unitlist; }; diff --git a/src/qt/clientmodel.h b/src/qt/clientmodel.h index c68fb0f03..b4054b5d8 100644 --- a/src/qt/clientmodel.h +++ b/src/qt/clientmodel.h @@ -12,7 +12,7 @@ QT_BEGIN_NAMESPACE class QDateTime; QT_END_NAMESPACE -// Model for Bitcoin network client +/** Model for Bitcoin network client. */ class ClientModel : public QObject { Q_OBJECT @@ -27,11 +27,11 @@ public: QDateTime getLastBlockDate() const; - // Return true if client connected to testnet + //! Return true if client connected to testnet bool isTestNet() const; - // Return true if core is doing initial block download + //! Return true if core is doing initial block download bool inInitialBlockDownload() const; - // Return conservative estimate of total number of blocks, or 0 if unknown + //! Return conservative estimate of total number of blocks, or 0 if unknown int getNumBlocksOfPeers() const; QString formatFullVersion() const; @@ -48,7 +48,7 @@ signals: void numConnectionsChanged(int count); void numBlocksChanged(int count); - // Asynchronous error notification + //! Asynchronous error notification void error(const QString &title, const QString &message); public slots: diff --git a/src/qt/csvmodelwriter.h b/src/qt/csvmodelwriter.h index 7367f3a6a..6c9dcbaf3 100644 --- a/src/qt/csvmodelwriter.h +++ b/src/qt/csvmodelwriter.h @@ -8,7 +8,9 @@ QT_BEGIN_NAMESPACE class QAbstractItemModel; QT_END_NAMESPACE -// Export TableModel to CSV file +/** Export a Qt table model to a CSV file. This is useful for analyzing or post-processing the data in + a spreadsheet. + */ class CSVModelWriter : public QObject { Q_OBJECT @@ -18,8 +20,9 @@ public: void setModel(const QAbstractItemModel *model); void addColumn(const QString &title, int column, int role=Qt::EditRole); - // Perform write operation - // Returns true on success, false otherwise + /** Perform export of the model to CSV. + @returns true on success, false otherwise + */ bool write(); private: diff --git a/src/qt/editaddressdialog.h b/src/qt/editaddressdialog.h index 9c9769d40..7ec053f13 100644 --- a/src/qt/editaddressdialog.h +++ b/src/qt/editaddressdialog.h @@ -12,6 +12,8 @@ namespace Ui { } class AddressTableModel; +/** Dialog for editing an address and associated information. + */ class EditAddressDialog : public QDialog { Q_OBJECT diff --git a/src/qt/guiutil.h b/src/qt/guiutil.h index bc4ddb8aa..94e3314d1 100644 --- a/src/qt/guiutil.h +++ b/src/qt/guiutil.h @@ -12,6 +12,8 @@ class QUrl; QT_END_NAMESPACE class SendCoinsRecipient; +/** Static utility functions used by the Bitcoin Qt UI. + */ class GUIUtil { public: diff --git a/src/qt/macdockiconhandler.h b/src/qt/macdockiconhandler.h index cc78c7a78..d02c148f9 100644 --- a/src/qt/macdockiconhandler.h +++ b/src/qt/macdockiconhandler.h @@ -8,6 +8,8 @@ class QIcon; class QWidget; class objc_object; +/** Macintosh-specific dock icon handler. + */ class MacDockIconHandler : public QObject { Q_OBJECT diff --git a/src/qt/monitoreddatamapper.h b/src/qt/monitoreddatamapper.h index 4dd2d1a86..33a874e73 100644 --- a/src/qt/monitoreddatamapper.h +++ b/src/qt/monitoreddatamapper.h @@ -7,9 +7,8 @@ QT_BEGIN_NAMESPACE class QWidget; QT_END_NAMESPACE -/* Data <-> Widget mapper that watches for changes, - to be able to notify when 'dirty' (for example, to - enable a commit/apply button). +/** Data to Widget mapper that watches for edits and notifies listeners when a field is edited. + This can be used, for example, to enable a commit/apply button in a configuration dialog. */ class MonitoredDataMapper : public QDataWidgetMapper { diff --git a/src/qt/notificator.h b/src/qt/notificator.h index ed69ae5c6..2d83013a7 100644 --- a/src/qt/notificator.h +++ b/src/qt/notificator.h @@ -11,33 +11,34 @@ class QDBusInterface; #endif QT_END_NAMESPACE -// Cross-platform desktop notification client +/** Cross-platform desktop notification client. */ class Notificator: public QObject { Q_OBJECT public: - // Create a new notificator - // Ownership of trayIcon is not transferred to this object + /** Create a new notificator. + @note Ownership of trayIcon is not transferred to this object. + */ Notificator(const QString &programName=QString(), QSystemTrayIcon *trayIcon=0, QWidget *parent=0); ~Notificator(); // Message class enum Class { - Information, - Warning, - Critical, + Information, /**< Informational message */ + Warning, /**< Notify user of potential problem */ + Critical /**< An error occured */ }; public slots: - /* Show notification message. - * - * cls: general message class - * title: title shown with message - * text: message content - * icon: optional icon to show with message - * millisTimeout: notification timeout in milliseconds (default 10 seconds) + /** Show notification message. + @param[in] cls general message class + @param[in] title title shown with message + @param[in] text message content + @param[in] icon optional icon to show with message + @param[in] millisTimeout notification timeout in milliseconds (defaults to 10 seconds) + @note Platform implementations are free to ignore any of the provided fields except for \a text. */ void notify(Class cls, const QString &title, const QString &text, const QIcon &icon = QIcon(), int millisTimeout = 10000); @@ -45,10 +46,10 @@ public slots: private: QWidget *parent; enum Mode { - None, - Freedesktop, // Use DBus org.freedesktop.Notifications - QSystemTray, // Use QSystemTray::showMessage - Growl // Use the Growl notification system (Mac only) + None, /**< Ignore informational notifications, and show a modal pop-up dialog for Critical notifications. */ + Freedesktop, /**< Use DBus org.freedesktop.Notifications */ + QSystemTray, /**< Use QSystemTray::showMessage */ + Growl /**< Use the Growl notification system (Mac only) */ }; QString programName; Mode mode; diff --git a/src/qt/optionsdialog.h b/src/qt/optionsdialog.h index d5238a366..9e1f87c64 100644 --- a/src/qt/optionsdialog.h +++ b/src/qt/optionsdialog.h @@ -14,6 +14,7 @@ class MainOptionsPage; class DisplayOptionsPage; class MonitoredDataMapper; +/** Preferences dialog. */ class OptionsDialog : public QDialog { Q_OBJECT @@ -25,6 +26,7 @@ public: signals: public slots: + /** Change the current page to \a index. */ void changePage(int index); private slots: @@ -33,6 +35,7 @@ private slots: void applyClicked(); void enableApply(); void disableApply(); + private: QListWidget *contents_widget; QStackedWidget *pages_widget; diff --git a/src/qt/optionsmodel.h b/src/qt/optionsmodel.h index 7f489c501..775362d63 100644 --- a/src/qt/optionsmodel.h +++ b/src/qt/optionsmodel.h @@ -5,7 +5,7 @@ class CWallet; -/* Interface from QT to configuration data structure for bitcoin client. +/** Interface from QT to configuration data structure for bitcoin client. To QT, the options are presented as a list with the different options laid out vertically. This can be changed to a tree once the settings become sufficiently diff --git a/src/qt/overviewpage.h b/src/qt/overviewpage.h index 4b4cc922c..119922716 100644 --- a/src/qt/overviewpage.h +++ b/src/qt/overviewpage.h @@ -13,6 +13,7 @@ namespace Ui { class WalletModel; class TxViewDelegate; +/** Overview ("home") page widget */ class OverviewPage : public QWidget { Q_OBJECT diff --git a/src/qt/qvalidatedlineedit.h b/src/qt/qvalidatedlineedit.h index f7b9486a6..66e26be9a 100644 --- a/src/qt/qvalidatedlineedit.h +++ b/src/qt/qvalidatedlineedit.h @@ -3,8 +3,9 @@ #include -// Line edit that can be marked as "invalid". When marked as invalid, -// it will get a red background until it is focused. +/** Line edit that can be marked as "invalid" to show input validation feedback. When marked as invalid, + it will get a red background until it is focused. + */ class QValidatedLineEdit : public QLineEdit { Q_OBJECT diff --git a/src/qt/qvaluecombobox.h b/src/qt/qvaluecombobox.h index 2a3533da9..11f342d71 100644 --- a/src/qt/qvaluecombobox.h +++ b/src/qt/qvaluecombobox.h @@ -3,19 +3,18 @@ #include -// QComboBox that can be used with QDataWidgetMapper to select -// ordinal values from a model. +/* QComboBox that can be used with QDataWidgetMapper to select ordinal values from a model. */ class QValueComboBox : public QComboBox { Q_OBJECT - Q_PROPERTY(int value READ value WRITE setValue NOTIFY valueChanged USER true); + Q_PROPERTY(int value READ value WRITE setValue NOTIFY valueChanged USER true) public: explicit QValueComboBox(QWidget *parent = 0); int value() const; void setValue(int value); - // Model role to use as value + /** Specify model role to use as ordinal value */ void setRole(int role); signals: diff --git a/src/qt/sendcoinsdialog.h b/src/qt/sendcoinsdialog.h index a14f99e8b..82910257f 100644 --- a/src/qt/sendcoinsdialog.h +++ b/src/qt/sendcoinsdialog.h @@ -14,6 +14,7 @@ QT_BEGIN_NAMESPACE class QUrl; QT_END_NAMESPACE +/** Dialog for sending bitcoins */ class SendCoinsDialog : public QDialog { Q_OBJECT @@ -24,8 +25,8 @@ public: void setModel(WalletModel *model); - // Qt messes up the tab chain by default in some cases (issue http://bugreports.qt.nokia.com/browse/QTBUG-10907) - // Hence we have to set it up manually + /** Set up the tab chain manually, as Qt messes up the tab chain by default in some cases (issue http://bugreports.qt.nokia.com/browse/QTBUG-10907). + */ QWidget *setupTabChain(QWidget *prev); void pasteEntry(const SendCoinsRecipient &rv); diff --git a/src/qt/sendcoinsentry.h b/src/qt/sendcoinsentry.h index ccc223b5f..b7f4a0af3 100644 --- a/src/qt/sendcoinsentry.h +++ b/src/qt/sendcoinsentry.h @@ -9,6 +9,7 @@ namespace Ui { class WalletModel; class SendCoinsRecipient; +/** A single entry in the dialog for sending bitcoins. */ class SendCoinsEntry : public QFrame { Q_OBJECT @@ -21,13 +22,13 @@ public: bool validate(); SendCoinsRecipient getValue(); - // Return true if the entry is still empty and unedited + /** Return whether the entry is still empty and unedited */ bool isClear(); void setValue(const SendCoinsRecipient &value); - // Qt messes up the tab chain by default in some cases (issue http://bugreports.qt.nokia.com/browse/QTBUG-10907) - // Hence we have to set it up manually + /** Set up the tab chain manually, as Qt messes up the tab chain by default in some cases (issue http://bugreports.qt.nokia.com/browse/QTBUG-10907). + */ QWidget *setupTabChain(QWidget *prev); public slots: diff --git a/src/qt/transactiondesc.h b/src/qt/transactiondesc.h index 484bb1230..55b9eaf48 100644 --- a/src/qt/transactiondesc.h +++ b/src/qt/transactiondesc.h @@ -8,11 +8,12 @@ class CWallet; class CWalletTx; +/** Provide a human-readable extended HTML description of a transaction. + */ class TransactionDesc: public QObject { Q_OBJECT public: - // Provide human-readable extended HTML description of a transaction static QString toHTML(CWallet *wallet, CWalletTx &wtx); private: TransactionDesc() {} diff --git a/src/qt/transactiondescdialog.h b/src/qt/transactiondescdialog.h index 4f8f754b2..e86fb58a6 100644 --- a/src/qt/transactiondescdialog.h +++ b/src/qt/transactiondescdialog.h @@ -10,6 +10,7 @@ QT_BEGIN_NAMESPACE class QModelIndex; QT_END_NAMESPACE +/** Dialog showing transaction details. */ class TransactionDescDialog : public QDialog { Q_OBJECT diff --git a/src/qt/transactionfilterproxy.h b/src/qt/transactionfilterproxy.h index 4dd2a8e5c..76cf46f15 100644 --- a/src/qt/transactionfilterproxy.h +++ b/src/qt/transactionfilterproxy.h @@ -4,29 +4,31 @@ #include #include -// Filter transaction list according to pre-specified rules +/** Filter the transaction list according to pre-specified rules. */ class TransactionFilterProxy : public QSortFilterProxyModel { Q_OBJECT public: explicit TransactionFilterProxy(QObject *parent = 0); - // Earliest date that can be represented (far in the past) + /** Earliest date that can be represented (far in the past) */ static const QDateTime MIN_DATE; - // Last date that can be represented (far in the future) + /** Last date that can be represented (far in the future) */ static const QDateTime MAX_DATE; - // Type filter bit field (all types) + /** Type filter bit field (all types) */ static const quint32 ALL_TYPES = 0xFFFFFFFF; static quint32 TYPE(int type) { return 1< decomposeTransaction(const CWallet *wallet, const CWalletTx &wtx); - /* Fixed */ + /** @name Immutable transaction attributes + @{*/ uint256 hash; int64 time; Type type; std::string address; int64 debit; int64 credit; + /**@}*/ - /* Subtransaction index, for sort key */ + /** Subtransaction index, for sort key */ int idx; - /* Status: can change with block chain update */ + /** Status: can change with block chain update */ TransactionStatus status; - /* Return the unique identifier for this transaction (part) */ + /** Return the unique identifier for this transaction (part) */ std::string getTxID(); - /* Update status from wallet tx. + /** Update status from core wallet tx. */ void updateStatus(const CWalletTx &wtx); - /* Is a status update needed? + /** Return whether a status update is needed. */ bool statusUpdateNeeded(); }; diff --git a/src/qt/transactiontablemodel.h b/src/qt/transactiontablemodel.h index da55495e1..db88a0604 100644 --- a/src/qt/transactiontablemodel.h +++ b/src/qt/transactiontablemodel.h @@ -9,6 +9,8 @@ class TransactionTablePriv; class TransactionRecord; class WalletModel; +/** UI model for the transaction table of a wallet. + */ class TransactionTableModel : public QAbstractTableModel { Q_OBJECT @@ -16,36 +18,37 @@ public: explicit TransactionTableModel(CWallet* wallet, WalletModel *parent = 0); ~TransactionTableModel(); - enum { + enum ColumnIndex { Status = 0, Date = 1, Type = 2, ToAddress = 3, Amount = 4 - } ColumnIndex; + }; - // Roles to get specific information from a transaction row - // These are independent of column - enum { - // Type of transaction + /** Roles to get specific information from a transaction row. + These are independent of column. + */ + enum RoleIndex { + /** Type of transaction */ TypeRole = Qt::UserRole, - // Date and time this transaction was created + /** Date and time this transaction was created */ DateRole, - // Long description (HTML format) + /** Long description (HTML format) */ LongDescriptionRole, - // Address of transaction + /** Address of transaction */ AddressRole, - // Label of address related to transaction + /** Label of address related to transaction */ LabelRole, - // Net amount of transaction + /** Net amount of transaction */ AmountRole, - // Unique identifier + /** Unique identifier */ TxIDRole, - // Is transaction confirmed? + /** Is transaction confirmed? */ ConfirmedRole, - // Formatted amount, without brackets when unconfirmed + /** Formatted amount, without brackets when unconfirmed */ FormattedAmountRole - } RoleIndex; + }; int rowCount(const QModelIndex &parent) const; int columnCount(const QModelIndex &parent) const; diff --git a/src/qt/transactionview.h b/src/qt/transactionview.h index f4f815b16..67d0b46f3 100644 --- a/src/qt/transactionview.h +++ b/src/qt/transactionview.h @@ -16,6 +16,9 @@ class QFrame; class QDateTimeEdit; QT_END_NAMESPACE +/** Widget showing the transaction list for a wallet, including a filter row. + Using the filter row, the user can view or export a subset of the transactions. + */ class TransactionView : public QWidget { Q_OBJECT diff --git a/src/qt/walletmodel.h b/src/qt/walletmodel.h index b7b6973b3..43b96f6d0 100644 --- a/src/qt/walletmodel.h +++ b/src/qt/walletmodel.h @@ -16,7 +16,7 @@ struct SendCoinsRecipient qint64 amount; }; -// Interface to Bitcoin wallet from Qt view code +/** Interface to Bitcoin wallet from Qt view code. */ class WalletModel : public QObject { Q_OBJECT