view libgui/src/m-editor/find-dialog.cc @ 30564:796f54d4ddbf stable

update Octave Project Developers copyright for the new year In files that have the "Octave Project Developers" copyright notice, update for 2021. In all .txi and .texi files except gpl.txi and gpl.texi in the doc/liboctave and doc/interpreter directories, change the copyright to "Octave Project Developers", the same as used for other source files. Update copyright notices for 2022 (not done since 2019). For gpl.txi and gpl.texi, change the copyright notice to be "Free Software Foundation, Inc." and leave the date at 2007 only because this file only contains the text of the GPL, not anything created by the Octave Project Developers. Add Paul Thomas to contributors.in.
author John W. Eaton <jwe@octave.org>
date Tue, 28 Dec 2021 18:22:40 -0500
parents d4d83344d653
children e2c8c852399e
line wrap: on
line source

// Find dialog derived from an example from Qt Toolkit (license below (**))

////////////////////////////////////////////////////////////////////////
//
// Copyright (C) 2009-2022 The Octave Project Developers
//
// See the file COPYRIGHT.md in the top-level directory of this
// or <https://octave.org/copyright/>.
//
//  All rights reserved.
//  Contact: Nokia Corporation (qt-info@nokia.com)
//
// This file is part of Octave.
//
// Octave 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 3 of the License, or
// (at your option) any later version.
//
// Octave 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 Octave; see the file COPYING.  If not, see
// <https://www.gnu.org/licenses/>.
//
// ** This file is part of the examples of the Qt Toolkit.
// **
// ** $QT_BEGIN_LICENSE:LGPL$
// ** Commercial Usage
// ** Licensees holding valid Qt Commercial licenses may use this file in
// ** accordance with the Qt Commercial License Agreement provided with the
// ** Software or, alternatively, in accordance with the terms contained in
// ** a written agreement between you and Nokia.
// **
// ** GNU Lesser General Public License Usage
// ** Alternatively, this file may be used under the terms of the GNU Lesser
// ** General Public License version 2.1 as published by the Free Software
// ** Foundation and appearing in the file LICENSE.LGPL included in the
// ** packaging of this file.  Please review the following information to
// ** ensure the GNU Lesser General Public License version 2.1 requirements
// ** will be met: https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
// **
// ** In addition, as a special exception, Nokia gives you certain additional
// ** rights.  These rights are described in the Nokia Qt LGPL Exception
// ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
// **
// ** GNU General Public License Usage
// ** Alternatively, this file may be used under the terms of the GNU
// ** General Public License version 3.0 as published by the Free Software
// ** Foundation and appearing in the file LICENSE.GPL included in the
// ** packaging of this file.  Please review the following information to
// ** ensure the GNU General Public License version 3.0 requirements will be
// ** met: https://www.gnu.org/copyleft/gpl.html.
// **
// ** If you have questions regarding the use of this file, please contact
// ** Nokia at qt-info@nokia.com.
// ** $QT_END_LICENSE$
//
////////////////////////////////////////////////////////////////////////

#if defined (HAVE_CONFIG_H)
#  include "config.h"
#endif

#if defined (HAVE_QSCINTILLA)

#include <QApplication>
#include <QCheckBox>
#include <QCheckBox>
#include <QCompleter>
#include <QDesktopWidget>
#include <QDialogButtonBox>
#include <QGridLayout>
#include <QIcon>
#include <QLabel>
#include <QLineEdit>
#include <QMessageBox>
#include <QPushButton>
#include <QVBoxLayout>

#include "find-dialog.h"
#include "gui-preferences-ed.h"
#include "resource-manager.h"
#include "octave-qobject.h"

namespace octave
{
  find_dialog::find_dialog (base_qobject& oct_qobj,
                            octave_dock_widget *ed, QWidget *p)
    : QDialog (p), m_octave_qobj (oct_qobj), m_editor (ed),
      m_in_sel (false), m_sel_beg (-1), m_sel_end (-1)
  {
    setWindowTitle (tr ("Editor: Find and Replace"));
    setWindowIcon (QIcon (":/actions/icons/find.png"));

    m_search_label = new QLabel (tr ("Find &what:"));
    m_search_line_edit = new QComboBox (this);
    m_search_line_edit->setToolTip (tr ("Enter text to search for"));
    m_search_line_edit->setEditable (true);
    m_search_line_edit->setMaxCount (m_mru_length);
    m_search_line_edit->completer ()->setCaseSensitivity (Qt::CaseSensitive);
    m_search_label->setBuddy (m_search_line_edit);

    m_replace_label = new QLabel (tr ("Re&place with:"));
    m_replace_line_edit = new QComboBox (this);
    m_replace_line_edit->setToolTip (tr ("Enter new text replacing search hits"));
    m_replace_line_edit->setEditable (true);
    m_replace_line_edit->setMaxCount (m_mru_length);
    m_replace_line_edit->completer ()->setCaseSensitivity (Qt::CaseSensitive);
    m_replace_label->setBuddy (m_replace_line_edit);

     int width = QFontMetrics (m_search_line_edit->font ()).averageCharWidth();
     m_search_line_edit->setFixedWidth (20*width);
     m_replace_line_edit->setFixedWidth (20*width);

    m_case_check_box = new QCheckBox (tr ("Match &case"));
    m_from_start_check_box = new QCheckBox (tr ("Search from &start"));
    m_wrap_check_box = new QCheckBox (tr ("&Wrap while searching"));
    m_wrap_check_box->setChecked (true);
    m_find_next_button = new QPushButton (tr ("&Find Next"));
    m_find_prev_button = new QPushButton (tr ("Find &Previous"));
    m_replace_button = new QPushButton (tr ("&Replace"));
    m_replace_all_button = new QPushButton (tr ("Replace &All"));

    m_more_button = new QPushButton (tr ("&More..."));
    m_more_button->setCheckable (true);
    m_more_button->setAutoDefault (false);

    m_button_box = new QDialogButtonBox (Qt::Vertical);
    m_button_box->addButton (m_find_next_button, QDialogButtonBox::ActionRole);
    m_button_box->addButton (m_find_prev_button, QDialogButtonBox::ActionRole);
    m_button_box->addButton (m_replace_button, QDialogButtonBox::ActionRole);
    m_button_box->addButton (m_replace_all_button, QDialogButtonBox::ActionRole);
    m_button_box->addButton (m_more_button, QDialogButtonBox::ActionRole);
    m_button_box->addButton (QDialogButtonBox::Close);

    m_extension = new QWidget (this);
    m_whole_words_check_box = new QCheckBox (tr ("&Whole words"));
    m_regex_check_box = new QCheckBox (tr ("Regular E&xpressions"));
    m_backward_check_box = new QCheckBox (tr ("Search &backward"));
    m_search_selection_check_box = new QCheckBox (tr ("Search se&lection"));
    m_search_selection_check_box->setCheckable (true);

    connect (m_find_next_button, &QPushButton::clicked,
             this, &find_dialog::find_next);
    connect (m_find_prev_button, &QPushButton::clicked,
             this, &find_dialog::find_prev);
    connect (m_more_button, &QPushButton::toggled,
             m_extension, &QWidget::setVisible);
    connect (m_replace_button, &QPushButton::clicked,
             this, &find_dialog::replace);
    connect (m_replace_all_button, &QPushButton::clicked,
             this, &find_dialog::replace_all);
    connect (m_backward_check_box, &QCheckBox::stateChanged,
             this, &find_dialog::handle_backward_search_changed);
    connect (m_button_box, &QDialogButtonBox::rejected,
             this, &find_dialog::close);

    connect (m_search_selection_check_box, &QCheckBox::stateChanged,
             this, &find_dialog::handle_sel_search_changed);

    QVBoxLayout *extension_layout = new QVBoxLayout ();
    extension_layout->setMargin (0);
    extension_layout->addWidget (m_whole_words_check_box);
    extension_layout->addWidget (m_backward_check_box);
    extension_layout->addWidget (m_search_selection_check_box);
    m_extension->setLayout (extension_layout);

    QGridLayout *top_left_layout = new QGridLayout;
    top_left_layout->addWidget (m_search_label, 1, 1);
    top_left_layout->addWidget (m_search_line_edit, 1, 2);
    top_left_layout->addWidget (m_replace_label, 2, 1);
    top_left_layout->addWidget (m_replace_line_edit, 2, 2);

    QVBoxLayout *left_layout = new QVBoxLayout;
    left_layout->addLayout (top_left_layout);
    left_layout->insertStretch (1, 5);
    left_layout->addWidget (m_case_check_box);
    left_layout->addWidget (m_from_start_check_box);
    left_layout->addWidget (m_wrap_check_box);
    left_layout->addWidget (m_regex_check_box);

    QGridLayout *main_layout = new QGridLayout;
    main_layout->setSizeConstraint (QLayout::SetFixedSize);
    main_layout->addLayout (left_layout, 0, 0);
    main_layout->addWidget (m_button_box, 0, 1);
    main_layout->addWidget (m_extension, 1, 0);
    setLayout (main_layout);

    m_extension->hide ();
    m_find_next_button->setDefault (true);
    m_find_result_available = false;
    m_rep_all = 0;
    m_rep_active = false;

    // Connect required external signals
    connect (ed, SIGNAL (edit_area_changed (octave_qscintilla *)),
             this, SLOT (update_edit_area (octave_qscintilla *)));

    setWindowModality (Qt::NonModal);

    setAttribute(Qt::WA_ShowWithoutActivating);
    setAttribute(Qt::WA_DeleteOnClose);
  }

  // The edit_area has changed: update relevant data of the file dialog
  void find_dialog::update_edit_area (octave_qscintilla *edit_area)
  {
    m_edit_area = edit_area;
    m_search_selection_check_box->setEnabled (edit_area->hasSelectedText ());

    connect (m_edit_area, SIGNAL (copyAvailable (bool)),
             this,       SLOT (handle_selection_changed (bool)),
             Qt::UniqueConnection);
  }

  void find_dialog::save_settings ()
  {
    resource_manager& rmgr = m_octave_qobj.get_resource_manager ();
    gui_settings *s = rmgr.get_settings ();

    // Save position
    QPoint dlg_pos = pos ();

#if defined (Q_OS_WIN32)
    int y = dlg_pos.y ();
#else
    int y = dlg_pos.y () - geometry ().height () + frameGeometry ().height ();
#endif

    m_last_position = QPoint (dlg_pos.x (), y);

    s->setValue (ed_fdlg_pos.key, m_last_position);

    // Is current search/replace text in the mru list?
    mru_update (m_search_line_edit);
    mru_update (m_replace_line_edit);

    // Store mru lists
    QStringList mru;
    for (int i = 0; i < m_search_line_edit->count (); i++)
      mru.append (m_search_line_edit->itemText (i));
    s->setValue (ed_fdlg_search.key, mru);

    mru.clear ();
    for (int i = 0; i < m_replace_line_edit->count (); i++)
      mru.append (m_replace_line_edit->itemText (i));
    s->setValue (ed_fdlg_replace.key, mru);

    // Store dialog's options
    int opts = 0
               + m_extension->isVisible () * FIND_DLG_MORE
               + m_case_check_box->isChecked () * FIND_DLG_CASE
               + m_from_start_check_box->isChecked () * FIND_DLG_START
               + m_wrap_check_box->isChecked () * FIND_DLG_WRAP
               + m_regex_check_box->isChecked () * FIND_DLG_REGX
               + m_whole_words_check_box->isChecked () * FIND_DLG_WORDS
               + m_backward_check_box->isChecked () * FIND_DLG_BACK
               + m_search_selection_check_box->isChecked () * FIND_DLG_SEL;
    s->setValue (ed_fdlg_opts.key, opts);

    s->sync ();
  }

  void find_dialog::restore_settings (QPoint ed_bottom_right)
  {
    resource_manager& rmgr = m_octave_qobj.get_resource_manager ();
    gui_settings *s = rmgr.get_settings ();

    // Get mru lists for search and replace text
    QStringList mru = s->value (ed_fdlg_search.key).toStringList ();
    while (mru.length () > m_mru_length)
      mru.removeLast ();
    m_search_line_edit->addItems (mru);

    mru = s->value (ed_fdlg_replace.key).toStringList ();
    while (mru.length () > m_mru_length)
      mru.removeLast ();
    m_replace_line_edit->addItems (mru);

    // Get the dialog's options
    int opts = s->value (ed_fdlg_opts.key, ed_fdlg_opts.def).toInt ();

    m_extension->setVisible (FIND_DLG_MORE & opts);
    m_case_check_box->setChecked (FIND_DLG_CASE & opts);
    m_from_start_check_box->setChecked (FIND_DLG_START & opts);
    m_wrap_check_box->setChecked (FIND_DLG_WRAP & opts);
    m_regex_check_box->setChecked (FIND_DLG_REGX & opts);
    m_whole_words_check_box->setChecked (FIND_DLG_WORDS & opts);
    m_backward_check_box->setChecked (FIND_DLG_BACK & opts);
    m_search_selection_check_box->setChecked (FIND_DLG_SEL & opts);

    // Position:  lower right of editor's position
    int xp = ed_bottom_right.x () - sizeHint ().width ();
    int yp = ed_bottom_right.y () - sizeHint ().height ();

    m_last_position = s->value (ed_fdlg_pos.key, QPoint (xp, yp)).toPoint ();
    move (m_last_position);

    if (QApplication::desktop ()->screenNumber (this) == -1)
      {
        // Last used position is not on screen anymore, use default pos.
        m_last_position = QPoint (xp, yp);
        move (m_last_position);

        if (QApplication::desktop ()->screenNumber (this) == -1)
          {
            // Default position is not on screen, last resort
            m_last_position = QPoint (50, 100); // upper left
            move (m_last_position);
          }
      }

  }

  // set text of "search from start" depending on backward search
  void find_dialog::handle_backward_search_changed (int backward)
  {
    if (backward)
      m_from_start_check_box->setText (tr ("Search from end"));
    else
      m_from_start_check_box->setText (tr ("Search from start"));
  }

  // search text has changed: reset the search
  void find_dialog::handle_search_text_changed (void)
  {
    // Return if nothing has changed
    if (m_search_line_edit->currentText () == m_search_line_edit->itemText (0))
      return;

    if (m_search_selection_check_box->isChecked ())
      m_find_result_available = false;

    mru_update (m_search_line_edit);
  }

  // replaced text has changed: reset the search
  void find_dialog::handle_replace_text_changed (void)
  {
    // Return if nothing has changed
    if (m_replace_line_edit->currentText () == m_replace_line_edit->itemText (0))
      return;

    mru_update (m_replace_line_edit);
  }

  // Update the mru list
  void find_dialog::mru_update (QComboBox *mru)
  {
    // Remove possible empty entries from the mru list
    int index;
    while ((index = mru->findText (QString ())) >= 0)
      mru->removeItem (index);

    // Get current text and return if it is empty
    QString text = mru->currentText ();

    if (text.isEmpty ())
      return;

    // Remove occurrences of the current text in the mru list
    while ((index = mru->findText (text)) >= 0)
      mru->removeItem (index);

    // Remove the last entry from the end if the list is full
    if (mru->count () == m_mru_length)
      mru->removeItem (m_mru_length -1);

    // Insert new item at the beginning and set it as current item
    mru->insertItem (0, text);
    mru->setCurrentIndex (0);
  }

  void find_dialog::handle_sel_search_changed (int selected)
  {
    m_from_start_check_box->setEnabled (! selected);
    m_find_result_available = false;
  }

  void find_dialog::handle_selection_changed (bool has_selected)
  {
    if (m_rep_active)
      return;

    m_search_selection_check_box->setEnabled (has_selected);
    m_find_result_available = false;
  }

  // initialize search text with selected text if this is in one single line
  void find_dialog::init_search_text (void)
  {
    if (m_edit_area && m_edit_area->hasSelectedText ())
      {
        int lbeg, lend, cbeg, cend;
        m_edit_area->getSelection (&lbeg, &cbeg, &lend, &cend);
        if (lbeg == lend)
          m_search_line_edit->setCurrentText (m_edit_area->selectedText ());
      }

    // set focus to "Find what" and select all text
    m_search_line_edit->setFocus ();
    m_search_line_edit->lineEdit ()->selectAll ();

    // Default to "find" next time.
    // Otherwise, it defaults to the last action, which may be "replace all".
    m_find_next_button->setDefault (true);
  }

  void find_dialog::find_next (void)
  {
    find (! m_backward_check_box->isChecked ());
  }

  void find_dialog::find_prev (void)
  {
    find (m_backward_check_box->isChecked ());
  }

  void find_dialog::find (bool forward)
  {
    if (! m_edit_area)
      return;

    handle_search_text_changed ();

    // line adn col: -1 means search starts at current position
    int line = -1, col = -1;

    bool do_wrap = m_wrap_check_box->isChecked ();
    bool do_forward = forward;

    // Initialize the selection begin and end if it is the first search
    if (! m_find_result_available)
      {
        if (m_search_selection_check_box->isChecked ()
            && m_edit_area->hasSelectedText ())
          {
            int l1, c1, l2, c2;
            m_edit_area->getSelection (&l1, &c1, &l2, &c2);

            // Store the position of the selection
            m_sel_beg = m_edit_area->positionFromLineIndex (l1, c1);
            m_sel_end = m_edit_area->positionFromLineIndex (l2, c2);
            m_in_sel = true;
          }
        else
          m_in_sel = false;
      }

    // Get the correct line/col for beginning the search
    if (m_rep_all)
      {
        // Replace All
        if (m_rep_all == 1)
          {
            // Start at the beginning of file/sel if it is the first try
            if (m_in_sel)
              m_edit_area->lineIndexFromPosition (m_sel_beg, &line, &col);
            else
              {
                line = 0;
                col = 0;
              }
          }
        do_wrap = false;  // Never wrap when replacing all
      }
    else
      {
        // Normal search (not replace all): calculate start position of
        // search (in file or selection)
        if (m_from_start_check_box->isChecked ()
            || (m_in_sel && (! m_find_result_available)))
          {
            // From the beginning or the end of file/sel
            if (do_forward)
              {
                // From the beginning
                if (m_in_sel)
                  m_edit_area->lineIndexFromPosition (m_sel_beg, &line, &col);
                else
                  {
                    line = 0;
                    col = 0;
                  }
              }
            else
              {
                // From the end
                if (m_in_sel)
                  m_edit_area->lineIndexFromPosition (m_sel_end, &line, &col);
                else
                  {
                    line = m_edit_area->lines () - 1;
                    col  = m_edit_area->text (line).length () - 1;
                    if (col == -1)
                      col = 0;
                  }
              }
          }
        else if (! do_forward)
          {
            // Start from where the cursor is.  Fix QScintilla's cursor
            // positioning
            m_edit_area->getCursorPosition (&line, &col);
            if (m_find_result_available && m_edit_area->hasSelectedText ())
              {
                int currpos = m_edit_area->positionFromLineIndex (line, col);
                currpos -= (m_search_line_edit->currentText ().length ());
                if (currpos < 0)
                  currpos = 0;
                m_edit_area->lineIndexFromPosition (currpos, &line, &col);
              }
          }
      }

    // Do the search
    m_find_result_available
      = m_edit_area->findFirst (m_search_line_edit->currentText (),
                                m_regex_check_box->isChecked (),
                                m_case_check_box->isChecked (),
                                m_whole_words_check_box->isChecked (),
                                do_wrap,
                                do_forward,
                                line, col,
                                true
#if defined (HAVE_QSCI_VERSION_2_6_0)
                                , true
#endif
                               );

    if (m_find_result_available)
      {
        // Search successful: reset search-from-start box and check for
        // the current selection
        m_from_start_check_box->setChecked (0);

        if (m_in_sel)
          {
            m_edit_area->getCursorPosition (&line, &col);
            int pos = m_edit_area->positionFromLineIndex (line, col);

            int l1, c1, l2, c2;
            m_edit_area->lineIndexFromPosition (m_sel_beg, &l1, &c1);
            m_edit_area->lineIndexFromPosition (m_sel_end, &l2, &c2);
            m_edit_area->show_selection_markers (l1, c1, l2, c2);

            // Check if new start position is still within the selection
            m_find_result_available =  pos >= m_sel_beg && pos <= m_sel_end;
          }
      }

    // No more search hits
    if (! m_find_result_available)
      {
        if (m_in_sel)
          {
            // Restore real selection and remove marker for selection
            int l1, c1, l2, c2;
            m_edit_area->lineIndexFromPosition (m_sel_beg, &l1, &c1);
            m_edit_area->lineIndexFromPosition (m_sel_end, &l2, &c2);
            m_edit_area->setSelection (l1, c1, l2, c2);
            m_edit_area->clear_selection_markers ();
          }

        // Display message if not replace all
        if (! m_rep_all)
          no_matches_message ();
      }

  }

  void find_dialog::do_replace (void)
  {
    if (m_edit_area)
      {
        m_rep_active = true;  // changes in selection not made by the user

        m_edit_area->replace (m_replace_line_edit->currentText ());
        if (m_in_sel)
          {
            // Update the length of the selection
            m_sel_end = m_sel_end
                        - m_search_line_edit->currentText ().toUtf8 ().size ()
                        + m_replace_line_edit->currentText ().toUtf8 ().size ();
          }

        m_rep_active = false;
      }
  }

  void find_dialog::replace (void)
  {
    if (m_edit_area)
      {
        handle_replace_text_changed ();

        // Do the replace if we have selected text
        if (m_find_result_available && m_edit_area->hasSelectedText ())
          do_replace ();

        find_next ();
      }
  }

  void find_dialog::replace_all (void)
  {
    int line, col;

    if (m_edit_area)
      {
        handle_replace_text_changed ();

        m_edit_area->getCursorPosition (&line, &col);

        m_rep_all = 1;
        find_next ();  // find first occurrence (forward)

        m_edit_area->beginUndoAction ();
        while (m_find_result_available)   // while search string is found
          {
            do_replace ();
            m_rep_all++;                                          // inc counter
            find_next ();                                        // find next
          }
        m_edit_area->endUndoAction ();

        QMessageBox msg_box (QMessageBox::Information, tr ("Replace Result"),
                             tr ("%1 items replaced").arg (m_rep_all-1),
                             QMessageBox::Ok, this);
        msg_box.exec ();

        m_rep_all = 0;
        m_find_result_available = false;

        if (! m_search_selection_check_box->isChecked ())
          m_edit_area->setCursorPosition (line, col);
      }
  }

  void find_dialog::no_matches_message (void)
  {
    QMessageBox msg_box (QMessageBox::Information, tr ("Find Result"),
                         tr ("No more matches found"), QMessageBox::Ok, this);
    msg_box.exec ();
  }

  void find_dialog::reject ()
  {
    close ();
  }

  void find_dialog::closeEvent (QCloseEvent *e)
  {
    save_settings ();
    e->accept ();
  }

  // Show and hide with (re-)storing position, otherwise there is always
  // a small shift each time the dialog is shown again
  void find_dialog::set_visible (bool visible)
  {
    if (visible)
      {
        show ();
        move (m_last_position);
      }
    else
      {
        m_last_position = pos ();
        hide ();
      }
  }

}
#endif