diff options
Diffstat (limited to 'src/libktorrent/interfaces/prefpageinterface.h')
-rw-r--r-- | src/libktorrent/interfaces/prefpageinterface.h | 84 |
1 files changed, 84 insertions, 0 deletions
diff --git a/src/libktorrent/interfaces/prefpageinterface.h b/src/libktorrent/interfaces/prefpageinterface.h new file mode 100644 index 0000000..850a344 --- /dev/null +++ b/src/libktorrent/interfaces/prefpageinterface.h @@ -0,0 +1,84 @@ +/*************************************************************************** + * Copyright (C) 2005 by Joris Guisson * + * [email protected] * + * * + * 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 PREFPAGEINTERFACE_H +#define PREFPAGEINTERFACE_H + +#include <tqpixmap.h> + +class TQWidget; + +namespace kt +{ + /** + * @author Ivan Vasic + * @brief Interface to add configuration dialog page. + * + * This interface allows plugins and others to add their own pages in Configuration dialog + */ + class PrefPageInterface + { + public: + /** + * Constructor, set the name, header and pixmap + * @param name + * @param header + * @param pix + */ + PrefPageInterface(const TQString & name,const TQString & header,const TQPixmap & pix); + virtual ~PrefPageInterface(); + + const TQString& getItemName() { return itemName; } + const TQString& getHeader() { return header; } + const TQPixmap& getPixmap() { return pixmap; } + + /** + * Apply the changes that have been made in the + * pref page. If the settings the user gave isn't valid false should be returned. + * This will prevent the dialog from closing. + * @return true if the data validates, false otherwise + */ + virtual bool apply() = 0; + + /** + * Create the actual widget. + * @param parent The parent of the widget + */ + virtual void createWidget(TQWidget* parent)=0; + + /** + * Update all data on the widget, gets called before + * the preference dialog gets shown. + */ + virtual void updateData() = 0; + + /// Delete the widget, gets called when the page gets removed. + virtual void deleteWidget() = 0; + + private: + ///Used in IconList mode. You should prefer a pixmap with size 32x32 pixels + TQPixmap pixmap; + ///String used in the list or as tab item name. + TQString itemName; + ///Header text use in the list modes. Ignored in Tabbed mode. If empty, the item text is used instead. + TQString header; + }; +} +#endif + |