Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 179 insertions, 0 deletions

diff --git a/kdeui/kiconviewsearchline.h b/kdeui/kiconviewsearchline.h
new file mode 100644
index 000000000..3eca6bd23
--- /dev/null
+++ b/kdeui/kiconviewsearchline.h
@@ -0,0 +1,179 @@
+/*
+   This file is part of the KDE libraries
+   Copyright (c) 2004 Gustavo Sverzut Barbieri <gsbarbieri@users.sourceforge.net>
+
+   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 KICONVIEWSEARCHLINE_H
+#define KICONVIEWSEARCHLINE_H
+
+#include <klineedit.h>
+#include <qvaluelist.h>
+
+class QIconView;
+class QIconViewItem;
+
+/**
+ * This class makes it easy to add a search line for filtering the items in a
+ * iconview based on a simple text search.
+ *
+ * No changes to the application other than instantiating this class with an
+ * appropriate QIconView should be needed.
+ *
+ * @since 3.3
+ */
+class KDEUI_EXPORT KIconViewSearchLine : public KLineEdit
+{
+  Q_OBJECT
+
+public:
+
+  /**
+   * Constructs a KIconViewSearchLine with \a iconView being the QIconView to
+   * be filtered.
+   *
+   * If \a iconView is null then the widget will be disabled until a iconview
+   * is set with setIconView().
+   */
+  KIconViewSearchLine( QWidget *parent = 0,
+		       QIconView *iconView = 0,
+		       const char *name = 0 );
+
+  /**
+   * Constructs a KIconViewSearchLine without any QIconView to filter. The
+   * QIconView object has to be set later with setIconView().
+   */
+  KIconViewSearchLine( QWidget *parent, const char *name );
+
+  /**
+   * Destroys the KIconViewSearchLine.
+   */
+  virtual ~KIconViewSearchLine();
+
+  /**
+   * Returns true if the search is case sensitive.  This defaults to false.
+   *
+   * @see setCaseSensitive()
+   */
+  bool caseSensitive() const;
+
+  /**
+   * Returns the iconview that is currently filtered by the search.
+   *
+   * @see setIconView()
+   */
+  QIconView *iconView() const;
+
+
+public slots:
+  /**
+   * Updates search to only make visible the items that match \a s.  If
+   * \a s is null then the line edit's text will be used.
+   */
+  virtual void updateSearch( const QString &s = QString::null );
+
+  /**
+   * Make the search case sensitive or case insensitive.
+   *
+   * @see caseSenstive()
+   */
+  void setCaseSensitive( bool cs );
+
+  /**
+   * Sets the QIconView that is filtered by this search line.  If \a lv is null
+   * then the widget will be disabled.
+   *
+   * @see iconView()
+   */
+  void setIconView( QIconView *iv );
+
+
+  /**
+   * Clear line edit and empty hiddenItems, returning elements to iconView.
+   */
+  void clear();
+
+
+protected:
+  /**
+   * Returns true if \a item matches the search \a s.  This will be evaluated
+   * based on the value of caseSensitive().  This can be overridden in
+   * subclasses to implement more complicated matching schemes.
+   */
+  virtual bool itemMatches( const QIconViewItem *item,
+			    const QString &s ) const;
+
+
+  /**
+   * Do initialization common to both constructors.
+   */
+  void init( QIconView *iconView = 0 );
+
+  /**
+   * Hide item.
+   */
+  void hideItem( QIconViewItem *item );
+
+  /**
+   * Show item.
+   *
+   * Just unhide it, doesn't necessary show it on screen, for that use
+   * iconView->ensureItemVisible()
+   */
+  void showItem( QIconViewItem *item );
+
+
+protected slots:
+  /**
+   * When keys are pressed a new search string is created and a timer is
+   * activated.  The most recent search is activated when this timer runs out
+   * if another key has not yet been pressed.
+   *
+   * This method makes @param s the most recent search and starts the
+   * timer.
+   *
+   * Together with activateSearch() this makes it such that searches are not
+   * started until there is a short break in the users typing.
+   *
+   * @see activateSearch()
+   */
+  void queueSearch( const QString &s );
+
+  /**
+   * When the timer started with queueSearch() expires this slot is called.
+   * If there has been another timer started then this slot does nothing.
+   * However if there are no other pending searches this starts the icon view
+   * search.
+   *
+   * @see queueSearch()
+   */
+  void activateSearch();
+
+
+private slots:
+  /**
+   * Take action need when iconView is deleted.
+   */
+  void iconViewDeleted();
+
+
+private:
+  class KIconViewSearchLinePrivate;
+  KIconViewSearchLinePrivate *d;
+};
+
+
+#endif /* KICONVIEWSEARCHLINE_H */