summaryrefslogtreecommitdiffstats
path: root/akregator/src/articlelistview.h
blob: d38f902670cac45d407018391dd646d2e847ccfc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
/*
    This file is part of Akregator.

    Copyright (C) 2004 Stanislav Karchebny <Stanislav.Karchebny@kdemail.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.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

    As a special exception, permission is given to link this program
    with any edition of Qt, and distribute the resulting executable,
    without including the source code for Qt in the source distribution.
*/
#ifndef AKREGATORARTICLELISTVIEW_H
#define AKREGATORARTICLELISTVIEW_H

#include <klistview.h>

class TQKeyEvent;
class TQDragObject;
template <class T> class TQValueList;

namespace Akregator
{
    class Article;
    class TreeNode;

    namespace Filters
    {
        class ArticleMatcher;
    }

    class ArticleListView : public KListView
    {
        Q_OBJECT
        public:
            ArticleListView(TQWidget *parent = 0, const char *name = 0);
            virtual ~ArticleListView();
            
            /** returns the current article, or a null article if there is none */
            Article currentArticle() const;
            
            /** returns a list of currently selected articles */
            TQValueList<Article> selectedArticles() const;
            
            enum Columns { itemTitle, feedTitle, pubDate };

        public slots:

            /** show article list of tree node @c node (also connects to the notification signals of the node) */
            void slotShowNode(TreeNode* node);
            
            /** clears the list and disconnects from the observed node (if any) */
            void slotClear();
            
            /** sets text filter and status filter
            @param textFilter filters text
            @param statusFilter filters status (read, unread, new) */
            void slotSetFilter(const Akregator::Filters::ArticleMatcher& textFilter, const Akregator::Filters::ArticleMatcher& statusFilter);

            /** selects previous article in list view, first article if no article was selected */
            void slotPreviousArticle();

            /** selects next article in list view, first article if no article was selected */
            void slotNextArticle();

            /** selects previous unread article in list view, first unread article if no article was selected */
            void slotPreviousUnreadArticle();

            /** selects next unread article in list view, first unread article if no article was selected */
            void slotNextUnreadArticle();

        signals:
            void signalArticleChosen(const Article& article);
            void signalDoubleClicked(const Article&, const TQPoint&, int);
            //void signalContextMenu(KListView*, ArticleItem*, const TQPoint&);
            void signalMouseButtonPressed(int, const Article&, const TQPoint &, int);
             
        protected:
            /** reimplemented for kmail-like behaviour */            
            virtual void keyPressEvent(TQKeyEvent* e);
            
            /** applies text filter and status filter by setting visibility
            of items accordingly */
            virtual void applyFilters();
            
            /**
             * @return count of visible articles, used for info boxes
             */
            int visibleArticles();
            
            /** Paints infobox for filtering and stuff
             */
            void paintInfoBox(const TQString &message);
            
            virtual void viewportPaintEvent(TQPaintEvent *e);
            
            void connectToNode(TreeNode* node);
            void disconnectFromNode(TreeNode* node);
            
            virtual TQDragObject *dragObject();

        protected slots:

            void slotArticlesAdded(TreeNode* node, const TQValueList<Article>& list);
            void slotArticlesUpdated(TreeNode* node, const TQValueList<Article>& list);
            void slotArticlesRemoved(TreeNode* node, const TQValueList<Article>& list);

            virtual void slotCurrentChanged(TQListViewItem* item);
            virtual void slotSelectionChanged();
            virtual void slotDoubleClicked(TQListViewItem* item, const TQPoint& p, int i);
            virtual void slotContextMenu(KListView* list, TQListViewItem* item, const TQPoint& p);
            virtual void slotMouseButtonPressed(int, TQListViewItem *, const TQPoint &, int);
            
        public:         // compat with KDE-3.x assertions, remove for KDE 4
	// private:
            class ArticleListViewPrivate;
            ArticleListViewPrivate* d;
            
            friend class ColumnLayoutVisitor;
            class ColumnLayoutVisitor;
            
            class ArticleItem;
    };
}

#endif