libs/widgets/KoTagChooserWidget.h

0001 /*
0002  *    This file is part of the KDE project
0003  *    Copyright (c) 2002 Patrick Julien <freak@codepimps.org>
0004  *    Copyright (c) 2007 Jan Hambrecht <jaham@gmx.net>
0005  *    Copyright (c) 2007 Sven Langkamp <sven.langkamp@gmail.com>
0006  *    Copyright (C) 2011 Srikanth Tiyyagura <srikanth.tulasiram@gmail.com>
0007  *    Copyright (c) 2011 José Luis Vergara <pentalis@gmail.com>
0008  *    Copyright (c) 2013 Sascha Suelzer <s.suelzer@gmail.com>
0009  *
0010  *    This library is free software; you can redistribute it and/or
0011  *    modify it under the terms of the GNU Library General Public
0012  *    License as published by the Free Software Foundation; either
0013  *    version 2 of the License, or (at your option) any later version.
0014  *
0015  *    This library is distributed in the hope that it will be useful,
0016  *    but WITHOUT ANY WARRANTY; without even the implied warranty of
0017  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
0018  *    Library General Public License for more details.
0019  *
0020  *    You should have received a copy of the GNU Library General Public License
0021  *    along with this library; see the file COPYING.LIB.  If not, write to
0022  *    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
0023  *    Boston, MA 02110-1301, USA.
0024  */
0025
0026 #ifndef KOTAGCHOOSERWIDGET_H
0027 #define KOTAGCHOOSERWIDGET_H
0028
0029 #include <QWidget>
0030 #include "kowidgets_export.h"
0031
0032 class KOWIDGETS_EXPORT KoTagChooserWidget : public QWidget
0033 {
0034     Q_OBJECT
0035
0036 public:
0037     explicit KoTagChooserWidget(QWidget* parent);
0038     ~KoTagChooserWidget() override;
0039     void setCurrentIndex(int index);
0040     int findIndexOf(const QString &tagName);
0041     void insertItem(const QString &tagName);
0042     void insertItemAt(int index, const QString &tag);
0043     QString currentlySelectedTag();
0044     QStringList allTags();
0045     bool selectedTagIsReadOnly();
0046     void removeItem(const QString &item);
0047     void addItems(QStringList tagNames);
0048     void addReadOnlyItem(const QString &tagName);
0049     void clear();
0050     void setUndeletionCandidate(const QString &tag);
0051     void showTagToolButton(bool show);
0052
0053 Q_SIGNALS:
0054     void newTagRequested(const QString &tagname);
0055     void tagDeletionRequested(const QString &tagname);
0056     void tagRenamingRequested(const QString &oldTagname, const QString &newTagname);
0057     void tagUndeletionRequested(const QString &tagname);
0058     void tagUndeletionListPurgeRequested();
0059     void popupMenuAboutToShow();
0060     void tagChosen(const QString &tag);
0061
0062 private Q_SLOTS:
0063     void tagRenamingRequested(const QString &newName);
0064     void tagOptionsContextMenuAboutToShow();
0065     void contextDeleteCurrentTag();
0066
0067 private:
0068     /// pimpl because chooser will most likely get upgraded at some point
0069     class Private;
0070     Private* const d;
0071
0072 };
0073 ;
0074
0075 #endif // KOTAGCHOOSERWIDGET_H