summaryrefslogtreecommitdiffstats
path: root/kaddressbook/printing/kabentrypainter.h
blob: 6c5b8dca9e1ad2c638adc94ee37c33948c40398a (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
/*
    This file is part of KAddressBook.
    Copyright (c) 1996-2002 Mirko Boehm <mirko@kde.org>

    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 KABENTRYPAINTER_H
#define KABENTRYPAINTER_H

#include <kabc/addressbook.h>

#include <qcolor.h>
#include <qfont.h>
#include <qrect.h>
#include <qvaluelist.h>

typedef QValueList<QRect> QRectList;

class KABEntryPainter
{
  public:
    KABEntryPainter();
    ~KABEntryPainter();

    /**
      Paint one entry using the given painter. May not only be used on
      printer objects but on any suitable QPaintDevice.
      The function does not paint a background, just the contents of the
      addressee.

      @param addr The addressee that should be printed.
      @param window The rectangle where the addressee should be printed to.
      @param p A painter object to print it.
      @param top The starting pixel in vertical direction (coordinate
                 system origin in the upper left corner), it is zero by
                 default, but may be larger than this to place another
                 addressee below an already printed one.
      @param fake If this is true, the addressee is not really printed,
                  it only calculates the space needed to draw this entry
                  onto the given window.

      @returns false if some error happens, otherwise true.
     */
    bool printAddressee( const KABC::Addressee &addr, const QRect &window,
                         QPainter *p, int top = 0, bool fake = false,
                         QRect *rect = 0 );

    void setForegroundColor( const QColor &color = Qt::black );
    void setBackgroundColor( const QColor &color = Qt::black );
    void setHeaderColor( const QColor &color = Qt::white );

    void setHeaderFont( const QFont &font = QFont( "Helvetica", 12, QFont::Normal, true ) );
    void setHeadLineFont( const QFont &font = QFont( "Helvetica", 12, QFont::Normal, true ) );
    void setBodyFont( const QFont &font = QFont( "Helvetica", 12, QFont::Normal, true ) );
    void setFixedFont( const QFont &font = QFont( "Courier", 12, QFont::Normal, true ) );
    void setCommentFont( const QFont &font = QFont( "Helvetica", 10, QFont::Normal, true ) );

    void setUseHeaderColor( bool value = true );

    void setShowAddresses( bool value = true );
    void setShowEmails( bool value = true );
    void setShowPhones( bool value = true );
    void setShowURLs( bool value = true );

    /**
      Returns the index of the rectangle if the point p is inside of
      one of the email addresses. The index is the position of the
      email address in the emails list. If it does not point at one of
      the email addresses, -1 is returned.
     */
    int hitsEmail( const QPoint &p );

    /**
      Returns the index of the rectangle if the point p is inside of
      one of the telephone numbers. See hitsEmail
     */
    int hitsPhone( const QPoint &p );

    /**
      Returns the index of the rectangle if the point p is inside of
      one of the telephone numbers. See hitsEmail
     */
    int hitsTalk( const QPoint &p );

    /**
      Returns the index of the rectangle if the point p is inside of
      one of the telephone numbers. See hitsEmail
     */
    int hitsURL( const QPoint &p );

  private:
    int hits( const QRectList& rects, const QPoint &p );

    QColor mForegroundColor;
    QColor mBackgroundColor;
    QColor mHeaderColor;

    QFont mHeaderFont;
    QFont mHeadLineFont;
    QFont mBodyFont;
    QFont mFixedFont;
    QFont mCommentFont;

    bool mUseHeaderColor;
    bool mShowAddresses;
    bool mShowEmails;
    bool mShowPhones;
    bool mShowURLs;

    QRectList mEmailRects;
    QRectList mPhoneRects;
    QRectList mURLRects;
    QRectList mTalkRects;
};

#endif