summaryrefslogtreecommitdiffstats
path: root/knode/knodeiface.h
blob: f92967bbbc762f15ea5aa718ddb3643a846ff551 (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
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
/*
    knodeiface.h

    KNode, the KDE newsreader
    Copyright (c) 1999-2003 the KNode authors.
    See file AUTHORS for details

    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.
    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, US
*/
#ifndef KNODEIFACE_H
#define KNODEIFACE_H


// no forward declarations - dcopidl2cpp won't work
#include <dcopobject.h>
#include <dcopref.h>
#include <kurl.h>
#include <qstringlist.h>


class KNodeIface : virtual public DCOPObject
{
  K_DCOP

k_dcop:
  /**
   * Move to the next article
   */
  virtual void nextArticle() = 0;

  /**
   * Move to the previous article
   */
  virtual void previousArticle() = 0;

  /**
   * Move to the next unread article
   */
  virtual void nextUnreadArticle() = 0;

  /**
   * Move to the next unread thread
   */
  virtual void nextUnreadThread() = 0;

  /**
   * Move to the next group
   */
  virtual void nextGroup() = 0;

  /**
   * Move to the previous group
   */
  virtual void previousGroup() = 0;

  /* Group options */

  /**
   * Open the editor to post a new article in the selected group
   */
  virtual void postArticle() = 0;

  /**
   * Fetch the new headers in the selected groups
   */
  virtual void fetchHeadersInCurrentGroup() = 0;

  /**
   * Expire the articles in the current group
   */
  virtual void expireArticlesInCurrentGroup() = 0;

  /**
   * Mark all the articles in the current group as read
   */
  virtual void markAllAsRead() = 0;

  /**
   * Mark all the articles in the current group as unread
   */
  virtual void markAllAsUnread() = 0;

  /* Header view */

  /**
   * Mark the current article as read
   */
  virtual void markAsRead() = 0;

  /**
   * Mark the current article as unread
   */
  virtual void markAsUnread() = 0;

  /**
   * Mark the current thread as read
   */
  virtual void markThreadAsRead() = 0;

  /**
   * Mark the current thread as unread
   */
  virtual void markThreadAsUnread() = 0;

  /* Articles */

  /**
   * Send the pending articles
   */
  virtual void sendPendingMessages() = 0;

  /**
   * Delete the current article
   */
  virtual void deleteArticle() = 0;

  /**
   * Send the current article
   */
  virtual void sendNow() = 0;

  /**
   * Edit the current article
   */
  virtual void editArticle() = 0;

  /**
   * Fetch all the new article headers
   */
  virtual void fetchHeaders() = 0;

  /**
   * Expire articles in all groups
   */
  virtual void expireArticles() = 0;

  /* Kontact integration */
  /**
   * Process command-line options
   * Return true if args were handled, false if there were no args.
   */
  virtual bool handleCommandLine() = 0;

};

#endif