registeritem.h

Go to the documentation of this file.

/***************************************************************************
                          registeritem.h  -  description
                             -------------------
    begin                : Tue Jun 13 2006
    copyright            : (C) 2000-2006 by Thomas Baumgart
    email                : Thomas Baumgart <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 REGISTERITEM_H
#define REGISTERITEM_H

// ----------------------------------------------------------------------------
// QT Includes

#include <qstring.h>
#include <qdatetime.h>
#include <qpainter.h>

// ----------------------------------------------------------------------------
// KDE Includes

// ----------------------------------------------------------------------------
// Project Includes

#include <kmymoney/mymoneymoney.h>
#include <kmymoney/mymoneysplit.h>
#include <kmymoney/mymoneyobject.h>

namespace KMyMoneyRegister {

typedef enum {
  Deposit = 0,          //< transaction is deposit
  Payment,              //< transaction is payment
  Unknown               //< transaction cashflow is unknown
} CashFlowDirection;

typedef enum {
  ActionNone = -1,
  ActionCheck = 0,
  /* these should be values which qt 3.3 never uses for QTab:
   * qt starts upwards from 0
   */
  ActionDeposit = 12201,
  ActionTransfer = 12202,
  ActionWithdrawal = 12203,
  ActionAtm,
  // insert new values above this line
  MaxAction
} Action;


class Register;

class RegisterItem
{
public:
  RegisterItem();
  RegisterItem(Register* parent);
  virtual ~RegisterItem();

  virtual const char* className(void) = 0;

  virtual bool isSelectable(void) const = 0;
  virtual bool isSelected(void) const { return false; }
  virtual void setSelected(bool /* selected*/) {}

  virtual bool canHaveFocus(void) const = 0;
  virtual bool hasFocus(void) const { return false; }
  virtual bool hasEditorOpen(void) const { return false; }

  virtual void setFocus(bool /*focus*/, bool updateLens = true) { updateLens = false; }

  virtual bool isErronous(void) const = 0;

  // helper functions used for sorting
  virtual const QDate& sortPostDate(void) const { return nullDate; }
  virtual int sortSamePostDate(void) const = 0;
  virtual const QDate& sortEntryDate(void) const { return nullDate; }
  virtual const QString& sortPayee(void) const { return QString::null; }
  virtual const MyMoneyMoney& sortValue(void) const { return nullValue; }
  virtual const QString& sortNumber(void) const { return QString::null; }
  virtual const QString& sortEntryOrder(void) const { return QString::null; }
  virtual CashFlowDirection sortType(void) const { return Deposit; }
  virtual const QString& sortCategory(void) const { return QString::null; }
  virtual MyMoneySplit::reconcileFlagE sortReconcileState(void) const { return MyMoneySplit::MaxReconcileState; }
  virtual const QString& sortSecurity(void) const { return QString::null; }

  virtual void setStartRow(int row) { m_startRow = row; }
  int startRow(void) const { return m_startRow; }
  virtual int rowHeightHint(void) const;

  virtual void setNumRowsRegister(int rows);

  virtual void setNumRowsForm(int rows) { m_rowsForm = rows; }

  virtual int numRowsRegister(void) const { return m_rowsRegister; }

  virtual int numRowsForm(void) const { return m_rowsForm; }
  virtual int numColsForm(void) const { return 1; }

  virtual void setAlternate(bool alternate) { m_alternate = alternate; }

  virtual void paintRegisterCell(QPainter* painter, int row, int col, const QRect& r, bool selected, const QColorGroup& cg) = 0;
  virtual void paintFormCell(QPainter* painter, int row, int col, const QRect& r, bool selected, const QColorGroup& cg) = 0;

  virtual const QString& id(void) const { return MyMoneyObject::emptyId(); }

  void setParent(Register* parent);

  Register* parent(void) const { return m_parent; }

  void setNeedResize(void) { m_needResize = true; }

  bool isVisible(void) const { return m_visible; }

  virtual void setVisible(bool visible);

  virtual bool markVisible(bool visible);

  void setNextItem(RegisterItem* p) { m_next = p; }
  void setPrevItem(RegisterItem* p) { m_prev = p; }
  RegisterItem* nextItem(void) const { return m_next; }
  RegisterItem* prevItem(void) const { return m_prev; }

  virtual bool matches(const QString&) const = 0;

  virtual bool maybeTip(const QPoint& /* relpos */, int /* row */, int /* col */, QRect& /* r */, QString& /* msg */) { return false; }

protected:
  void init(void);

protected:
  Register*                m_parent;
  RegisterItem*            m_prev;
  RegisterItem*            m_next;
  int                      m_startRow;
  int                      m_rowsRegister;
  int                      m_rowsForm;
  bool                     m_alternate;
  bool                     m_needResize;
  bool                     m_visible;

private:
  static QDate             nullDate;
  static MyMoneyMoney      nullValue;
};

} // namespace

#endif
// vim:cin:si:ai:et:ts=2:sw=2: