You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
183 lines
5.9 KiB
183 lines
5.9 KiB
/*
|
|
* 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 <tdelibs_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 TDEUI_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
|