kaddressbook

printstyle.h
1 /*
2  This file is part of KAddressBook.
3  Copyright (c) 1996-2002 Mirko Boehm <mirko@kde.org>
4 
5  This program is free software; you can redistribute it and/or modify
6  it under the terms of the GNU General Public License as published by
7  the Free Software Foundation; either version 2 of the License, or
8  (at your option) any later version.
9 
10  This program is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  GNU General Public License for more details.
14 
15  You should have received a copy of the GNU General Public License
16  along with this program; if not, write to the Free Software
17  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 
19  As a special exception, permission is given to link this program
20  with any edition of TQt, and distribute the resulting executable,
21  without including the source code for TQt in the source distribution.
22 */
23 
24 #ifndef PRINTSTYLE_H
25 #define PRINTSTYLE_H
26 
27 #include <tqwidget.h>
28 #include <tqstringlist.h>
29 #include <tqpixmap.h>
30 
31 #include <tdeabc/field.h>
32 
33 namespace KABPrinting {
34 
35 class PrintingWizard;
36 class PrintProgress;
37 
60 class PrintStyle : public TQObject
61 {
62  TQ_OBJECT
63 
64 
65  public:
66  PrintStyle( PrintingWizard* parent, const char* name = 0 );
67  virtual ~PrintStyle();
68 
72  virtual void print( const TDEABC::Addressee::List &contacts, PrintProgress* ) = 0;
73 
79  const TQPixmap& preview();
80 
84  void hidePages();
85 
89  void showPages();
90 
94  TDEABC::Field* preferredSortField();
95 
102  bool preferredSortType();
103 
104  protected:
111  bool setPreview( const TQString& fileName );
112 
116  void setPreview( const TQPixmap& image );
117 
121  void setPreferredSortOptions( TDEABC::Field *field, bool ascending = true );
122 
127 
132  void addPage( TQWidget *page, const TQString &title );
133 
134  private:
135  PrintingWizard *mWizard;
136  TQPixmap mPreview;
137  TQPtrList<TQWidget> mPageList;
138  TQStringList mPageTitles;
139 
140  TDEABC::Field *mSortField;
141  bool mSortType;
142 };
143 
144 
152 {
153  public:
154  PrintStyleFactory( PrintingWizard* parent, const char* name = 0 );
155  virtual ~PrintStyleFactory();
156 
157  virtual PrintStyle *create() const = 0;
158 
163  virtual TQString description() const = 0;
164 
165  protected:
166  PrintingWizard* mParent;
167  const char* mName;
168 };
169 
170 }
171 
172 #endif
This defines a simple widget to display print progress information.
Definition: printprogress.h:41
The factories are used to have all object of the respective print style created in one place.
Definition: printstyle.h:152
virtual TQString description() const =0
Overload this method to provide a one-liner description for your print style.
The class PrintStyle implements the abstract interface to the PrintingWizards style objects.
Definition: printstyle.h:61
bool preferredSortType()
Returns the preferred sort type.
Definition: printstyle.cpp:116
bool setPreview(const TQString &fileName)
Load the preview image from the kaddressbook data directory.
Definition: printstyle.cpp:54
TDEABC::Field * preferredSortField()
Returns the preferred sort criterion field.
Definition: printstyle.cpp:111
void addPage(TQWidget *page, const TQString &title)
Add additional page to the wizard e.g.
Definition: printstyle.cpp:77
PrintingWizard * wizard()
Return the wizard object.
Definition: printstyle.cpp:72
const TQPixmap & preview()
Reimplement this method to provide a preview of what will be printed.
Definition: printstyle.cpp:44
void showPages()
Show all style specific pages in the wizard.
Definition: printstyle.cpp:85
void hidePages()
Hide all style specific pages in the wizard.
Definition: printstyle.cpp:99
virtual void print(const TDEABC::Addressee::List &contacts, PrintProgress *)=0
Reimplement this method to actually print.
void setPreferredSortOptions(TDEABC::Field *field, bool ascending=true)
Set preferred sort options for this printing style.
Definition: printstyle.cpp:105
The PrintingWizard combines pages common for all print styles and those provided by the respective st...