summaryrefslogtreecommitdiffabout
path: root/kaddressbook/jumpbuttonbar.h
blob: d534f2b52ee62ee6516a739dfbbd58282c25421a (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
/*                                                                      
    This file is part of KAddressBook.                                  
    Copyright (c) 2002 Mike Pilone <mpilone@slac.com>                   
                                                                        
    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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, 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 JUMPBUTTONBAR_H
#define JUMPBUTTONBAR_H

#include <qsizepolicy.h>
#include <qwidget.h>
#include <qptrlist.h>
#include <qstringlist.h>

class QChar;
class QGridLayout;
class QResizeEvent;
class QPushButton;
class JumpButton;

namespace KABC {
class Field;
}

class KABCore;

/**
  Used to draw the jump button bar on the right of the view.
 */
class JumpButtonBar : public QWidget
{
  Q_OBJECT
  
  public:
    JumpButtonBar( KABCore *core, QWidget *parent, const char *name = 0 );
    ~JumpButtonBar();
    
    QSizePolicy sizePolicy() const;    
    
  public slots:
    /**
      This method removes all buttons from the GUI and recreates them
      according to the current global search field and the content of
      the address book.
     */
    void recreateButtons();
    
  signals:
    /**
      Emitted whenever a letter is selected by the user.
     */
    void jumpToLetter( const QString &character );

  protected slots:
    void letterClicked();

  private:
    void sortListLocaleAware( QStringList &list );

    KABCore *mCore;

    QGridLayout *mButtonLayout;
    QStringList mCharacters;
    QPtrList<JumpButton> mButtons;
};

#endif