Added kmymoney

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kmymoney@1239792 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 403 insertions, 0 deletions

diff --git a/kmymoney2/views/kgloballedgerview.h b/kmymoney2/views/kgloballedgerview.h
new file mode 100644
index 0000000..861bd0e
--- /dev/null
+++ b/kmymoney2/views/kgloballedgerview.h
@@ -0,0 +1,403 @@
+/***************************************************************************
+                          kgloballedgerview.h  -  description
+                             -------------------
+    begin                : Sat Jul 13 2002
+    copyright            : (C) 2000-2002 by Michael Edwardes
+    email                : [email protected]
+                           Javier Campos Morales <[email protected]>
+                           Felix Rodriguez <[email protected]>
+                           John C <[email protected]>
+                           Thomas Baumgart <[email protected]>
+                           Kevin Tambascio <[email protected]>
+ ***************************************************************************/
+
+/***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+
+#ifndef KACCOUNTVIEW_H
+#define KACCOUNTVIEW_H
+
+// ----------------------------------------------------------------------------
+// QT Includes
+
+#include <qwidget.h>
+#include <qwidgetlist.h>
+#include <qstring.h>
+
+// ----------------------------------------------------------------------------
+// KDE Includes
+
+// ----------------------------------------------------------------------------
+// Project Includes
+
+// ----------------------------------------------------------------------------
+// Project Includes
+
+#include <kmymoney/mymoneyutils.h>
+#include <kmymoney/mymoneyaccount.h>
+#include <kmymoney/kmymoneyview.h>
+#include <kmymoney/register.h>
+#include <kmymoney/transactionform.h>
+
+class QVBoxLayout;
+class QHBoxLayout;
+class QGridLayout;
+class QPopupMenu;
+class QFrame;
+class QLabel;
+
+class KMyMoneyAccountCombo;
+class KToolBar;
+class KToolBarButton;
+class MyMoneyReport;
+class TransactionEditor;
+
+/**
+  * helper class implementing an event filter to detect mouse button press
+  * events on widgets outside a given set of widgets. This is used internally
+  * to detect when to leave the edit mode.
+  */
+class MousePressFilter : public QObject
+{
+  Q_OBJECT
+public:
+  MousePressFilter(QWidget* parent = 0, const char* name = 0);
+
+  /**
+    * Add widget @p w to the list of possible parent objects. See eventFilter() how
+    * they will be used.
+    */
+  void addWidget(QWidget* w);
+
+public slots:
+  /**
+    * This slot allows to activate/deactive the filter. By default the
+    * filter is active.
+    *
+    * @param state Allows to activate (@a true) or deactivate (@a false) the filter
+    */
+  void setFilterActive(bool state = true);
+
+  /**
+    * This slot allows to activate/deactive the filter. By default the
+    * filter is active.
+    *
+    * @param state Allows to deactivate (@a true) or activate (@a false) the filter
+    */
+  void setFilterDeactive(bool state = false) { setFilterActive(!state); }
+
+protected:
+  /**
+    * This method checks if the widget @p child is a child of
+    * the widget @p parent and returns either @a true or @a false.
+    *
+    * @param child pointer to child widget
+    * @param parent pointer to parent widget
+    * @retval true @p child points to widget which has @p parent as parent or grand-parent
+    * @retval false @p child points to a widget which is not related to @p parent
+    */
+  bool isChildOf(QWidget* child, QWidget* parent);
+
+  /**
+    * Reimplemented from base class. Sends out the mousePressedOnExternalWidget() signal
+    * if object @p o points to an object which is not a child widget of any added previously
+    * using the addWidget() method. The signal is sent out only once for each event @p e.
+    *
+    * @param o pointer to QObject
+    * @param e pointer to QEvent
+    * @return always returns @a false
+    */
+  bool eventFilter(QObject* o, QEvent* e);
+
+signals:
+  void mousePressedOnExternalWidget(bool&);
+
+private:
+  QValueList<QWidget*> m_parents;
+  QEvent*              m_lastMousePressEvent;
+  bool                 m_filterActive;
+};
+
+/**
+  * @author Thomas Baumgart
+  */
+class KGlobalLedgerView : public KMyMoneyViewBase
+{
+  Q_OBJECT
+public:
+  KGlobalLedgerView(QWidget *parent=0, const char *name=0);
+  ~KGlobalLedgerView();
+
+  /**
+    * This method returns the id of the currently selected account
+    * or QString() if none is selected.
+    */
+  const QString accountId(void) const { return m_account.id(); }
+
+  /**
+    * Checks if new transactions can be created in the current context
+    *
+    * @param tooltip reference to string receiving the tooltip text
+    *        which explains why the modify function is not available (in case
+    *        of returning @c false)
+    *
+    * @retval true Yes, view allows to create transactions (tooltip is not changed)
+    * @retval false No, view does not support creation of transactions (tooltip is updated with message)
+    */
+  bool canCreateTransactions(QString& tooltip) const;
+
+  /**
+    * Checks if a list of transactions can be modified (edit/delete) in the current context
+    *
+    * @param list list of selected transactions
+    * @param tooltip reference to string receiving the tooltip text
+    *        which explains why the modify function is not available (in case
+    *        of returning @c false)
+    *
+    * @retval true Yes, view allows to edit/delete transactions (tooltip is not changed)
+    * @retval false No, view cannot edit/delete transactions (tooltip is updated with message)
+    */
+  bool canModifyTransactions(const KMyMoneyRegister::SelectedTransactions& list, QString& tooltip) const;
+
+  bool canDuplicateTransactions(const KMyMoneyRegister::SelectedTransactions& list, QString& tooltip) const;
+
+  /**
+    * Checks if the list of transactions can be edited in the current context
+    *
+    * @param list list of selected transactions
+    * @param tooltip reference to string receiving the tooltip text
+    *        which explains why the edit function is not available (in case
+    *        of returning @c false)
+    *
+    * @return @c true if edit operation is possible, @c false if not
+    */
+  bool canEditTransactions(const KMyMoneyRegister::SelectedTransactions& list, QString& tooltip) const;
+
+  TransactionEditor* startEdit(const KMyMoneyRegister::SelectedTransactions& list);
+
+  /**
+    * Method to prepare the ledger view to create a new transaction.
+    * Returns if successful or not.
+    *
+    * retval true Emtpy transaction selected.
+    * retval false Not successful (e.g. already editing a transaction)
+    */
+  bool selectEmptyTransaction(void);
+
+public slots:
+  void show(void);
+
+  /**
+    * This method loads the view with data from the MyMoney engine.
+    */
+  void slotLoadView(void);
+
+  /**
+    * This slot is used to select the correct ledger view type for
+    * the account specified by @p id in a specific mode.
+    *
+    * @param accountId Internal id used for the account to show
+    * @param transactionId Internal id used for the transaction to select.
+    *                      Default is QString() which will select the last
+    *                      transaction in the ledger if not the same account
+    *
+    * @retval true selection of account referenced by @p id succeeded
+    * @retval false selection of account failed
+    */
+  bool slotSelectAccount(const QString& accountId, const QString& transactionId = QString());
+
+  /**
+    * This method is provided for convenience and acts as the method above.
+    */
+  bool slotSelectAccount(const MyMoneyObject& acc);
+
+  /**
+   * Switch to reconciliation mode for account @a account.
+   * If @a account is MyMoneyAccount() (the default), reconciliation mode
+   * is turned off.
+   *
+   * @param account account for which reconciliation mode is activated.
+   *                Default  is MyMoneyAccount().
+   * @param reconciliationDate date of statment
+   * @param endingBalance The calculated ending balance for the statement
+   *                Default ist 0.
+   */
+  void slotSetReconcileAccount(const MyMoneyAccount& account = MyMoneyAccount(), const QDate& reconciliationDate = QDate(), const MyMoneyMoney& endingBalance = MyMoneyMoney());
+
+  /**
+    * Select all transactions in the ledger that are not hidden.
+    */
+  void slotSelectAllTransactions(void);
+
+protected:
+  /**
+    * This method reloads the account selection combo box of the
+    * view with all asset and liability accounts from the engine.
+    * If the account id of the current account held in @p m_accountId is
+    * empty or if the referenced account does not exist in the engine,
+    * the first account found in the list will be made the current account.
+    */
+  void loadAccounts(void);
+
+  /**
+    * This method clears the register, form, transaction list. See @sa m_register,
+    * @sa m_transactionList
+    */
+  void clear(void);
+
+  void loadView(void);
+
+  void resizeEvent(QResizeEvent*);
+
+  void selectTransaction(const QString& id);
+
+  /**
+    * This method handles the focus of the keyboard. When in edit mode
+    * (m_inEditMode is true) the keyboard focus is handled
+    * according to the widgets that are referenced in m_tabOrderWidgets.
+    * If not in edit mode, the base class functionality is provided.
+    *
+    * @param next true if forward-tab, false if backward-tab was
+    *             pressed by the user
+    */
+  bool focusNextPrevChild(bool next);
+
+  bool eventFilter(QObject* o, QEvent* e);
+
+  /**
+    * Returns @a true if setReconciliationAccount() has been called for
+    * the current loaded account.
+    *
+    * @retval true current account is in reconciliation mode
+    * @retval false current account is not in reconciliation mode
+    */
+  bool isReconciliationAccount(void) const;
+
+  /**
+    * Updates the values on the summary line beneath the register with
+    * the given values. The contents shown differs between reconciliation
+    * mode and normal mode.
+    *
+    * @param actBalance map of account indexed values to be used as actual balance
+    * @param clearedBalance map of account indexed values to be used as cleared balance
+    */
+  void updateSummaryLine(const QMap<QString, MyMoneyMoney>& actBalance, const QMap<QString, MyMoneyMoney>& clearedBalance);
+
+  /**
+    * setup the default action according to the current account type
+    */
+  void setupDefaultAction(void);
+
+protected slots:
+  void slotLeaveEditMode(const KMyMoneyRegister::SelectedTransactions& list);
+  void slotNewTransaction(void);
+  void slotNewTransaction(KMyMoneyRegister::Action);
+
+  /**
+    * Sets the contentsPos of the register to d->m_startPoint or makes
+    * the focus item visible if d->m_startPoint equals QPoint(-1, -1).
+    */
+  void slotUpdateViewPos(void);
+  void slotSortOptions(void);
+  void slotToggleTransactionMark(KMyMoneyRegister::Transaction* t);
+
+  void slotKeepPostDate(const QDate&);
+
+  void slotAboutToSelectItem(KMyMoneyRegister::RegisterItem*, bool&);
+
+protected:
+  /**
+    * This member keeps the date that was used as the last posting date.
+    * It will be updated whenever the user modifies the post date
+    * and is used to preset the posting date when new transactions are created.
+    * This member is initialised to the current date when the program is started.
+    */
+  static QDate         m_lastPostDate;
+
+private:
+  /// \internal d-pointer class.
+  class Private;
+  /// \internal d-pointer instance.
+  Private* const d;
+
+  // frames
+  QFrame*                       m_toolbarFrame;
+  QFrame*                       m_registerFrame;
+  QFrame*                       m_buttonFrame;
+  QFrame*                       m_formFrame;
+  QFrame*                       m_summaryFrame;
+
+  // widgets
+  KMyMoneyAccountCombo*         m_accountComboBox;
+  KMyMoneyRegister::Register*   m_register;
+  KToolBar*                     m_toolbar;
+  KToolBar*                     m_buttonbar;
+
+  /**
+    * This member holds the currently selected account
+    */
+  MyMoneyAccount m_account;
+
+  /**
+    * This member holds the transaction list
+    */
+  QValueList<QPair<MyMoneyTransaction, MyMoneySplit> >  m_transactionList;
+
+  QLabel*                         m_leftSummaryLabel;
+  QLabel*                         m_centerSummaryLabel;
+  QLabel*                         m_rightSummaryLabel;
+
+  KMyMoneyTransactionForm::TransactionForm* m_form;
+
+  bool                            m_needReload;
+  bool                            m_newAccountLoaded;
+  bool                            m_inEditMode;
+
+  QWidgetList                     m_tabOrderWidgets;
+
+signals:
+  void accountSelected(const MyMoneyObject&);
+  void transactionsSelected(const KMyMoneyRegister::SelectedTransactions&);
+  void newTransaction(void);
+  void startEdit(void);
+  void endEdit(void);
+  void cancelOrEndEdit(bool&);
+
+  /**
+    * This signal is emitted, when a new report has been generated.  A
+    * 'generated' report is halfway between a default report and a custom
+    * report.  It's created by the system in response to the user's
+    * request, and it's usually filtered to be a little more specific
+    * than the usual default reports.
+    *
+    * The proper behaviour when getting this signal is to switch to the
+    * reports view and display the report.  But it should NOT be added
+    * to the data file, unless the user customizes it further.  That's
+    * because the user can always come back to the ledger UI to generate
+    * the report again.
+    *
+    * @param report reference to MyMoneyReport object that contains the report
+    *     details
+    */
+  void reportGenerated(const MyMoneyReport& report);
+
+  void openContextMenu(void);
+
+  /**
+    * This signal is sent out, when the current selected transaction should
+    * be marked different
+    */
+  void toggleReconciliationFlag(void);
+
+private:
+  bool canProcessTransactions(const KMyMoneyRegister::SelectedTransactions& list, QString& tooltip) const;
+};
+
+#endif
+// vim:cin:si:ai:et:ts=2:sw=2: