diff options
Diffstat (limited to 'kdeui/ktimezonewidget.h')
-rw-r--r-- | kdeui/ktimezonewidget.h | 112 |
1 files changed, 0 insertions, 112 deletions
diff --git a/kdeui/ktimezonewidget.h b/kdeui/ktimezonewidget.h deleted file mode 100644 index a09b1dd56..000000000 --- a/kdeui/ktimezonewidget.h +++ /dev/null @@ -1,112 +0,0 @@ -/* - Copyright (C) 2005, S.R.Haque <srhaque@iee.org>. - This file is part of the KDE project - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Library General Public - License version 2, as published by the Free Software Foundation. - - This library 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 - Library General Public License for more details. - - You should have received a copy of the GNU Library General Public License - along with this library; see the file COPYING.LIB. If not, write to - the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, - Boston, MA 02110-1301, USA. -*/ - -#ifndef KTIMEZONEWIDGET_H -#define KTIMEZONEWIDGET_H - -#include <kdelibs_export.h> -#include <klistview.h> -#include <tqstring.h> - -class KTimezone; -class KTimezones; -class KTimezoneWidgetPrivate; - -/** - * @brief A timezone selection widget. - * - * \b Detail: - * - * This class provides for selection of one or more timezones. - * - * \b Example: - * - * To use the class to implement a system timezone selection feature: - * \code - * - * // This adds a timezone widget to a dialog. - * m_timezones = new KTimezoneWidget(this, "Timezones"); - * ... - * \endcode - * - * To use the class to implement a multiple-choice custom timezone selector: - * \code - * - * m_timezones = new KTimezoneWidget(this, "Timezones", vcalendarTimezones); - * m_timezones->setSelectionModeExt(KListView::Multi); - * ... - * \endcode - * - * @author S.R.Haque <srhaque@iee.org> - * @since 3.5 - */ -class KDEUI_EXPORT KTimezoneWidget : - public KListView -{ - Q_OBJECT - -public: - /** - * Constructs a timezone selection widget. - * - * @param parent The parent widget. - * @param name The name of this widget. - * @param db The timezone database to use. If 0, the system timezone - * database is used. - */ - KTimezoneWidget(TQWidget *parent = 0, const char *name = 0, KTimezones *db = 0); - - /** - * Destroys the timezone selection widget. - */ - virtual ~KTimezoneWidget(); - - /** - * Returns the currently selected timezones. See TQListView::selectionChanged(). - * - * @return a list of timezone names, in the format used by the database - * supplied to the {@link KTimezoneWidget() } constructor. - */ - TQStringList selection() const; - - /** - * Select/deselect the named timezone. - * - * @param zone The timezone name to be selected. Ignored if not recognised! - * @param selected The new selection state. - */ - void setSelected(const TQString &zone, bool selected); - - /** - * Format a timezone name in a standardised manner. The returned value is - * transformed via an i18n lookup, so the caller should previously have - * set the timezone catalogue: - * \code - * KGlobal::locale()->insertCatalogue("timezones"); - * \endcode - * - * @return formatted timezone name. - */ - static TQString displayName(const KTimezone *zone); - -private: - KTimezoneWidgetPrivate *d; -}; - -#endif |