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.
tellico/src/gui/listview.h

182 lines
5.9 KiB

/***************************************************************************
copyright : (C) 2001-2006 by Robby Stephenson
email : robby@periapsis.org
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of version 2 of the GNU General Public License as *
* published by the Free Software Foundation; *
* *
***************************************************************************/
#ifndef TELLICO_LISTVIEW_H
#define TELLICO_LISTVIEW_H
#include "../datavectors.h"
#include "../listviewcomparison.h"
#include <tdelistview.h>
#include <tdeversion.h>
#include <tqdict.h>
namespace Tellico {
class ListViewComparison;
namespace GUI {
class ListViewItem;
typedef TQPtrList<ListViewItem> ListViewItemList;
typedef TQPtrListIterator<ListViewItem> ListViewItemListIt;
/**
* A ListView keeps track of the selected items and allows subclasses to determine
* whether child items may be selected or not. In addition, it provides alternating
* background colors and shaded sort columns.
*
* @see GroupView
* @see DetailedListView
*
* @author Robby Stephenson
*/
class ListView : public TDEListView {
TQ_OBJECT
friend class ListViewItem; // needed so the ListViewItem d'tor can update selection list
public:
enum SortStyle {
SortByText = 0, // don't change these values, they're saved as ints in the config
SortByCount = 1
};
ListView(TQWidget* parent, const char* name = 0);
virtual ~ListView();
void clearSelection();
/**
* Returns a list of the currently selected items;
*
* @return The list of selected items
*/
const ListViewItemList& selectedItems() const { return m_selectedItems; }
/**
* Used to determine whether an item may be selected without having to setSelectable on
* every child item.
*
* @return Whether the item may be selected
*/
virtual bool isSelectable(ListViewItem*) const;
SortStyle sortStyle() const { return m_sortStyle; }
void setSortStyle(SortStyle style) { m_sortStyle = style; }
int firstVisibleColumn() const;
int lastVisibleColumn() const;
virtual void setColumnText(int column, const TQString& label);
void setComparison(int column, ListViewComparison* comp);
void removeComparison(int column);
void clearComparisons();
virtual int compare(int col, const GUI::ListViewItem* item1, GUI::ListViewItem* item2, bool asc);
#if !KDE_IS_VERSION(3,3,90)
// taken from KDE bug 59791
void setShadeSortColumn(bool shade_);
bool shadeSortColumn() const { return m_shadeSortColumn; }
const TQColor& background2() const { return m_backColor2; }
const TQColor& alternateBackground2() const { return m_altColor2; }
#endif
protected slots:
/**
* Handles everything when an item is selected. The proper signal is emitted, depending
* on whether the item refers to a collection, a group, or a entry.
*/
virtual void slotSelectionChanged();
protected:
virtual void drawContentsOffset(TQPainter* p, int ox, int oy, int cx, int cy, int cw, int ch);
private slots:
void slotUpdateColors();
void slotDoubleClicked(TQListViewItem* item);
private:
/**
* Updates the pointer list.
*
* @param item The item being selected or deselected
* @param s Selected or not
*/
void updateSelected(ListViewItem* item, bool s);
SortStyle m_sortStyle;
bool m_isClear;
ListViewItemList m_selectedItems;
TQDict<ListViewComparison> m_comparisons;
#if !KDE_IS_VERSION(3,3,90)
bool m_shadeSortColumn;
TQColor m_backColor2;
TQColor m_altColor2;
#endif
};
/**
* The ListViewItem keeps track of what kind of specialized listview item it is, as
* well as taking care of the selection tracking.
*
* @author Robby Stephenson
*/
class ListViewItem : public TDEListViewItem {
public:
ListViewItem(ListView* parent) : TDEListViewItem(parent), m_sortWeight(-1) {}
ListViewItem(ListView* parent, TQListViewItem* after) : TDEListViewItem(parent, after), m_sortWeight(-1) {}
ListViewItem(ListViewItem* parent) : TDEListViewItem(parent), m_sortWeight(-1) {}
ListViewItem(ListView* parent, const TQString& text) : TDEListViewItem(parent, text), m_sortWeight(-1) {}
ListViewItem(ListViewItem* parent, const TQString& text) : TDEListViewItem(parent, text), m_sortWeight(-1) {}
virtual ~ListViewItem();
virtual size_t realChildCount() const { return childCount(); }
virtual void clear();
virtual bool isEntryGroupItem() const { return false; }
virtual bool isEntryItem() const { return false; }
virtual bool isFilterItem() const { return false; }
virtual bool isBorrowerItem() const { return false; }
virtual bool isLoanItem() const { return false; }
int sortWeight() const { return m_sortWeight; }
void setSortWeight(int w) { m_sortWeight = w; }
virtual int compare(TQListViewItem* item, int col, bool ascending) const;
virtual void setSelected(bool selected);
/**
* Returns the background color for the column, which depends on whether the item
* is an alternate row and whether the column is selected.
*
* @param column The column number
* @param alternate The alternate row color can be forced
*/
virtual TQColor backgroundColor(int column); // not virtual in TDEListViewItem!!!
virtual void paintCell(TQPainter* painter, const TQColorGroup& colorGroup,
int column, int width, int alignment);
ListView* listView () const { return static_cast<ListView*>(TDEListViewItem::listView()); }
virtual void doubleClicked() {}
virtual Data::EntryVec entries() const;
private:
int compareWeight(TQListViewItem* item, int col, bool ascending) const;
int m_sortWeight;
};
} // end namespace
} // end namespace
#endif