diff options
Diffstat (limited to 'tdeui/klanguagebutton.h')
| -rw-r--r-- | tdeui/klanguagebutton.h | 182 |
1 files changed, 182 insertions, 0 deletions
diff --git a/tdeui/klanguagebutton.h b/tdeui/klanguagebutton.h new file mode 100644 index 000000000..4b381abe9 --- /dev/null +++ b/tdeui/klanguagebutton.h @@ -0,0 +1,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 TQWidget +{ + 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 |