You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kmymoney/kmymoney2/plugins/viewinterface.h

121 lines
4.4 KiB

/***************************************************************************
viewinterface.h
-------------------
begin : Wed Jan 5 2005
copyright : (C) 2005 Thomas Baumgart
email : ipwizard@users.sourceforge.net
***************************************************************************/
/***************************************************************************
* *
* 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 VIEWINTERFACE_H
#define VIEWINTERFACE_H
// ----------------------------------------------------------------------------
// QT Includes
#include <tqobject.h>
#include <tqstring.h>
#include <tqpixmap.h>
class TQFrame;
// ----------------------------------------------------------------------------
// KDE Includes
class TDEPopupMenu;
// ----------------------------------------------------------------------------
// Project Includes
#include <kmymoney/mymoneyaccount.h>
#include <kmymoney/mymoneyinstitution.h>
#include <kmymoney/export.h>
class KMyMoneyViewBase;
namespace KMyMoneyRegister {
class SelectedTransactions;
};
namespace KMyMoneyPlugin {
/**
* This abstract class represents the ViewInterface to
* add new view pages to the JanusWidget of KMyMoney. It
* also gives access to the account context menu.
*/
class KMYMONEY_EXPORT ViewInterface : public TQObject {
Q_OBJECT
public:
ViewInterface(TQObject* parent, const char* name = 0);
~ViewInterface() {}
/**
* This method creates a new page in the application.
* See KJanusWidget::addPage() for details.
*/
virtual KMyMoneyViewBase* addPage(const TQString& item, const TQString& icon) = 0;
/**
* This method adds a widget to the layout of the view
* created with addPage()
*
* @param view pointer to view widget
* @param w widget to be added to @p page
*/
virtual void addWidget(KMyMoneyViewBase* view, TQWidget* w) = 0;
signals:
/**
* This signal is emitted when a new account has been selected by
* the GUI. If no account is selected or the selection is removed,
* @a account is identical to MyMoneyAccount(). This signal is used
* by plugins to get information about changes.
*/
void accountSelected(const MyMoneyAccount& acc);
/**
* This signal is emitted when a transaction/list of transactions has been selected by
* the GUI. If no transaction is selected or the selection is removed,
* @p transactions is identical to an empty TQValueList. This signal is used
* by plugins to get information about changes.
*/
void transactionsSelected(const KMyMoneyRegister::SelectedTransactions& transactions);
/**
* This signal is emitted when a new institution has been selected by
* the GUI. If no institution is selected or the selection is removed,
* @a institution is identical to MyMoneyInstitution(). This signal is used
* by plugins to get information about changes.
*/
void institutionSelected(const MyMoneyInstitution& institution);
/**
* This signal is emitted when an account has been successfully reconciled
* and all transactions are updated in the engine. It can be used by plugins
* to create reconciliation reports.
*
* @param account the account data
* @param date the reconciliation date as provided through the dialog
* @param startingBalance the starting balance as provided through the dialog
* @param endingBalance the ending balance as provided through the dialog
* @param transactionList reference to TQValueList of TQPair containing all
* transaction/split pairs processed by the reconciliation.
*/
void accountReconciled(const MyMoneyAccount& account, const TQDate& date, const MyMoneyMoney& startingBalance, const MyMoneyMoney& endingBalance, const TQValueList<TQPair<MyMoneyTransaction, MyMoneySplit> >& transactionList);
void viewStateChanged(bool);
void kmmFilePlugin(unsigned int);
};
}; // namespace
#endif