src/Qtx/QtxSearchTool.h

Go to the documentation of this file.

// Copyright (C) 2007-2011  CEA/DEN, EDF R&D, OPEN CASCADE
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License.
//
// 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
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
//
// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//

// File   : QtxSearchTool.h
// Author : Vadim SANDLER, Open CASCADE S.A.S. (vadim.sandler@opencascade.com)
//
#ifndef QTXSEARCHTOOL_H
#define QTXSEARCHTOOL_H

#include "Qtx.h"
#include <QFrame>
#include <QList>
#include <QMap>
#include <QPersistentModelIndex>
#include <QPointer>

class QCheckBox;
class QLineEdit;
class QShortcut;
class QTimer;
class QToolButton;
class QTreeView;

class QTX_EXPORT QtxSearchTool : public QFrame
{
  Q_OBJECT

  enum {
    fAny,             
    fNext,            
    fPrevious,        
    fFirst,           
    fLast             
  };

public:
  class Searcher;

  typedef enum { 
    Search    = 0x00000001,                          
    Next      = 0x00000002,                          
    Prev      = 0x00000004,                          
    First     = 0x00000008,                          
    Last      = 0x00000010,                          
    Close     = 0x00000020,                          
    Case      = 0x00000040,                          
    RegExp    = 0x00000080,                          
    Wrap      = 0x00000100,                          
    Basic     = Search   | Next   | Prev | Close,    
    Standard  = Basic    | First  | Last,            
    Modifiers = Case     | RegExp | Wrap,            
    All       = Standard | Modifiers                 
  } Controls;

  typedef enum {
    None        = 0x00000000,                                 
    HotKey      = 0x00000001,                                 
    SlashKey    = 0x00000002,                                 
    StandardKey = 0x00000004,                                 
    PrintKey    = 0x00000008,                                 
    Any         = HotKey | SlashKey | StandardKey | PrintKey  
  } Activator;

  QtxSearchTool( QWidget*, QWidget* = 0, int = All );
  QtxSearchTool( QWidget*, int = All );
  virtual ~QtxSearchTool();

  QWidget*            watchedWidget() const;
  void                setWatchedWidget( QWidget* );

  Searcher*           searcher() const;
  void                setSearcher( Searcher* );

  int                 activators() const;
  void                setActivators( const int );

  int                 controls() const;
  void                setControls( const int );

  QList<QKeySequence> shortcuts() const;
  void                setShortcuts( const QKeySequence& );
  void                setShortcuts( const QList<QKeySequence>& );

  int                 addCustomWidget( QWidget*, int = -1 );
  QWidget*            customWidget( int ) const;
  int                 customWidgetId( QWidget* ) const;

  bool                isAutoHideEnabled() const;
  void                enableAutoHide( bool );

  bool                isCaseSensitive() const;
  bool                isRegExpSearch() const;
  bool                isSearchWrapped() const;

  void                setCaseSensitive( bool );
  void                setRegExpSearch( bool );
  void                setSearchWrapped( bool );

  virtual bool        event( QEvent* );
  virtual bool        eventFilter( QObject*, QEvent* );

public slots:
  virtual void        find();
  virtual void        findNext();
  virtual void        findPrevious();
  virtual void        findFirst();
  virtual void        findLast();

private slots:
  void                find( const QString&, int = fAny );
  void                modifierSwitched();

private:
  void                init();
  bool                focused() const;
  void                clearShortcuts();
  void                initShortcuts( const QList<QKeySequence>& );
  void                updateShortcuts();
  void                updateControls();

private:
  typedef QPointer<QShortcut> ShortcutPtr;
  typedef QList<ShortcutPtr>  ShortcutList;

private:
  QWidget*            myBtnWidget;
  QWidget*            myModWidget;
  QLineEdit*          myData;
  QToolButton*        myToFirst;
  QToolButton*        myToLast;
  QToolButton*        myNext;
  QToolButton*        myPrev;
  QToolButton*        myClose;
  QCheckBox*          myIsCaseSens;
  QCheckBox*          myIsRegExp;
  QCheckBox*          myWrap;
  QWidget*            myWatched;
  Searcher*           mySearcher;
  int                 myControls;
  int                 myActivators;
  ShortcutList        myShortcuts;
  QTimer*             myAutoHideTimer;
  bool                myAutoHideEnabled;
  QMap<int, QWidget*> myWidgets;
};

class QTX_EXPORT QtxSearchTool::Searcher
{
public:
  Searcher();
  virtual ~Searcher();

  virtual bool find( const QString&, QtxSearchTool* ) = 0;
  virtual bool findNext( const QString&, QtxSearchTool* ) = 0;
  virtual bool findPrevious( const QString&, QtxSearchTool* ) = 0;
  virtual bool findFirst( const QString&, QtxSearchTool* ) = 0;
  virtual bool findLast( const QString&, QtxSearchTool* ) = 0;
};

class QTX_EXPORT QtxTreeViewSearcher : public QtxSearchTool::Searcher
{
public:
  QtxTreeViewSearcher( QTreeView*, int = 0 );
  virtual ~QtxTreeViewSearcher();

  int                    searchColumn() const;
  void                   setSearchColumn( int );
  
  virtual bool           find( const QString&, QtxSearchTool* );
  virtual bool           findNext( const QString&, QtxSearchTool* );
  virtual bool           findPrevious( const QString&, QtxSearchTool* );
  virtual bool           findFirst( const QString&, QtxSearchTool* );
  virtual bool           findLast( const QString&, QtxSearchTool* );

protected:
  virtual Qt::MatchFlags matchFlags( QtxSearchTool* ) const;
  
private:
  QModelIndexList        findItems( const QString&, QtxSearchTool* );
  QModelIndex            findNearest( const QModelIndex&, const QModelIndexList&, bool );
  void                   showItem( const QModelIndex& );
  QString                getId( const QModelIndex& );
  int                    compareIndices( const QModelIndex&, const QModelIndex& );

private:
  QTreeView*             myView;
  int                    myColumn;
  QPersistentModelIndex  myIndex;
};

#endif // QTXSEARCHTOOL_H