summaryrefslogtreecommitdiffstats
path: root/kspread/plugins/insertcalendar/kspread_plugininsertcalendar.h
blob: 9eb6060df6c355d9dbcd8143ff3d24606f22bef0 (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
/***************************************************************************
 *   Copyright (C) 2005 by Raphael Langerhorst                             *
 *   [email protected]                                            *
 *                                                                         *
 *   Permission is hereby granted, free of charge, to any person obtaining *
 *   a copy of this software and associated documentation files (the       *
 *   "Software"), to deal in the Software without restriction, including   *
 *   without limitation the rights to use, copy, modify, merge, publish,   *
 *   distribute, sublicense, and/or sell copies of the Software, and to    *
 *   permit persons to whom the Software is furnished to do so, subject to *
 *   the following conditions:                                             *
 *                                                                         *
 *   The above copyright notice and this permission notice shall be        *
 *   included in all copies or substantial portions of the Software.       *
 *                                                                         *
 *   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,       *
 *   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF    *
 *   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*
 *   IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR     *
 *   OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, *
 *   ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR *
 *   OTHER DEALINGS IN THE SOFTWARE.                                       *
 ***************************************************************************/

#ifndef KSPREAD_PLUGININSERTCALENDAR_H
#define KSPREAD_PLUGININSERTCALENDAR_H

#include <kparts/plugin.h>

#include <koffice_export.h>

#include <qdatetime.h>

class KAboutData;

namespace KSpread
{
class View;

class InsertCalendarDialog;

/**
 * \class PluginInsertCalender kspread_plugininsertcalendar.h
 * \brief Plugin for inserting a calendar into a spreadsheet.
 * @author Raphael Langerhorst
 *
 * The plugin class for the Insert Calendar plugin.
 * This plugin is designed to work in KSpread and
 * makes it possible to insert calendars into
 * the spreadsheet.
 */
class KSPREAD_EXPORT PluginInsertCalendar : public KParts::Plugin
{
  Q_OBJECT

  protected:

    /**
     * This is the parent part of the plugin. It is used
     * to access the spreadsheet and actually insert the
     * calendar.
     *
     * It is set in the constructor.
     */
    View* m_kspreadView;

    /**
     * This is the dialog used to select the start/end dates
     * of the calendar. It is the user interface of this
     * plugin.
     * @see InsertCalendarDialog, slotShowDialog, slotInsertCalendar
     */
    InsertCalendarDialog* m_dialog;

  public:

    /**
     * Constructor. This constructor is usable with KGenericFactory.
     */
    PluginInsertCalendar( QObject *parent, const char *name, const QStringList& args );

    /**
     * Virtual destructor.
     */
    virtual ~PluginInsertCalendar();

  public:

    /**
     * Creates about data for the Insert Calendar plugin.
     */
    static KAboutData* createAboutData();

  public slots:

     /**
      * This is called from the plugin action, it shows a dialog that
      * allows start and end date selection and various other
      * options. The calendar can then be inserted into a spreadsheet.
      */
     void slotShowDialog();

     /**
      * This actually inserts the calendar. It reads the configuration
      * from the insert calendar dialog and builds an calendar in the
      * spreadsheet accordingly.
      */
     void slotInsertCalendar(const QDate &start, const QDate &end);
};

}

#endif