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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
/*
* klangbutton.h - Button with language selection drop down menu.
* Derived from the KLangCombo class by Hans Petter Bieker.
*
* Copyright (c) 1999-2003 Hans Petter Bieker <bieker@kde.org>
* (c) 2001 Martijn Klingens <klingens@kde.org>
*
* Requires the Qt widget libraries, available at no cost at
* http://www.troll.no/
*
* 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.
*/
#ifndef __KLANGBUTTON_H__
#define __KLANGBUTTON_H__
#include <tqwidget.h>
#include <kdelibs_export.h>
class KLanguageButtonPrivate;
class TQIconSet;
class TQPopupMenu;
/**
* KLanguageButton provides a combobox with a 2-D dataset. It also supports icons.
* It is also possible to construct a non combobox version.
*
* All items are identified using strings, not integers.
*
* Combined version of KTagCombo and KLanguageCombo but using a QPushButton
* instead.
*/
class KDEUI_EXPORT KLanguageButton : public QWidget
{
Q_OBJECT
public:
/**
* Constructs a combobox widget with parent parent called name.
*
* @param parent The parent of the combo box
* @param name The name of the combo box
*/
KLanguageButton(TQWidget * parent = 0, const char * name = 0);
/**
* Constructs a version with static text. The parent parent is called name.
*
* @param text The text of the button
* @param parent The parent of the button
* @param name The name of the button
*/
KLanguageButton(const TQString & text, TQWidget * parent = 0, const char * name = 0);
/**
* Deconstructor
*/
virtual ~KLanguageButton();
/**
* Inserts an item into the combo box. A negative index will append the item.
*
* @param icon The icon used used when displaying the item.
* @param text The text string used when displaying the item.
* @param id The text string used to identify the item.
* @param submenu The place where the item should be placed.
* @param index The visual position in the submenu.
*/
void insertItem( const TQIconSet& icon, const TQString &text,
const TQString & id, const TQString &submenu = TQString::null,
int index = -1 );
/**
* Inserts an item into the combo box. A negative index will append the item.
*
* @param text The text string used when displaying the item.
* @param id The text string used to identify the item.
* @param submenu The place where the item should be placed.
* @param index The visual position in the submenu.
*/
void insertItem( const TQString &text, const TQString & id,
const TQString &submenu = TQString::null, int index = -1 );
/**
* Inserts a seperator item into the combo box. A negative index will append the item.
*
* @param submenu The place where the item should be placed.
* @param index The visual position in the submenu.
*/
void insertSeparator( const TQString &submenu = TQString::null,
int index = -1 );
/**
* Inserts a submenu into the combo box. A negative index will append the item.
*
* @param icon The icon used used when displaying the item.
* @param text The text string used when displaying the item.
* @param id The text string used to identify the item.
* @param submenu The place where the item should be placed.
* @param index The visual position in the submenu.
*/
void insertSubmenu( const TQIconSet & icon, const TQString &text,
const TQString & id, const TQString &submenu = TQString::null,
int index = -1);
/**
* Inserts a submenu into the combo box. A negative index will append the item.
*
* @param text The text string used when displaying the item.
* @param id The text string used to identify the item.
* @param submenu The place where the item should be placed.
* @param index The visual position in the submenu.
*/
void insertSubmenu( const TQString &text, const TQString & id,
const TQString &submenu = TQString::null, int index = -1);
void insertLanguage( const TQString& path, const TQString& name,
const TQString& sub = TQString::null,
const TQString &submenu = TQString::null, int index = -1);
int count() const;
/**
* Removes all combobox items.
*/
void clear();
/**
* Changes the current text item of the combobox, and makes the text static.
*/
void setText(const TQString & text);
/**
* Returns the id of the combobox's current item.
*/
TQString current() const;
/**
* Returns TRUE if the combobox contains id.
*/
bool contains( const TQString & id ) const;
/**
* Sets id as current item.
*/
void setCurrentItem( const TQString & id );
TQString id( int i ) const;
signals:
/**
* This signal is emitted when a new item is activated. The id is
* the identificator of the selected item.
*/
void activated( const TQString & id );
void highlighted( const TQString & id );
private slots:
void slotActivated( int );
void slotHighlighted( int );
private:
int currentItem() const;
void setCurrentItem( int );
void init(const char * name);
// work space for the new class
TQStringList *m_ids;
TQPopupMenu *m_popup, *m_oldPopup;
int m_current;
KLanguageButtonPrivate * d;
};
#endif
|
