file-editor-tab.h

Go to the documentation of this file.

////////////////////////////////////////////////////////////////////////
//
// Copyright (C) 2011-2022 The Octave Project Developers
//
// See the file COPYRIGHT.md in the top-level directory of this
// distribution or <https://octave.org/copyright/>.
//
// 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/>.
//
////////////////////////////////////////////////////////////////////////
 
#if ! defined (octave_file_editor_tab_h)
#define octave_file_editor_tab_h 1
 
#include <QAbstractButton>
#include <QCloseEvent>
#include <QDateTime>
#include <QFileInfo>
#include <QFileSystemWatcher>
#include <QLabel>
#include <QStatusBar>
#include <QWidget>
#include <Qsci/qsciapis.h>
 
#include "gui-settings.h"
#include "marker.h"
#include "octave-qscintilla.h"
#include "qt-interpreter-events.h"
 
class octave_value_list;
 
namespace octave
{
  class base_qobject;
  class file_editor;
 
  class file_editor_tab : public QWidget
  {
    Q_OBJECT
 
  public:
 
    file_editor_tab (base_qobject& oct_qobj, const QString& directory = "");
 
    ~file_editor_tab (void);
 
    octave_qscintilla * qsci_edit_area (void) { return m_edit_area; }
 
    // Will initiate close if associated with the identifier tag.
    bool conditional_close (void);
 
    void update_breakpoints ();
 
    QString file_name (void) const { return m_file_name; }
    QString encoding (void) const { return m_encoding; }
 
  signals:
 
    void tab_ready_to_close (void);
    void file_name_changed (const QString& fileName,
                            const QString& toolTip,
                            bool modified);
    void editor_state_changed (bool copy_available, bool is_octave_file,
                               bool is_modified);
    void set_focus_editor_signal (QWidget *);
    void edit_area_changed (octave_qscintilla *edit_area);
    void tab_remove_request (void);
    void mru_add_file (const QString& file_name, const QString& encoding);
    void editor_check_conflict_save (const QString& saveFileName,
                                     bool remove_on_success);
    void run_file_signal (const QFileInfo& info);
    void request_open_file (const QString&, const QString& = QString ());
    void edit_mfile_request (const QString&, const QString&,
                             const QString&, int);
 
    void autoc_closed (void);
 
    void update_breakpoints_signal (const octave_value_list& args);
 
    void remove_breakpoint_via_debugger_linenr (int debugger_linenr);
    void request_remove_breakpoint_via_editor_linenr (int editor_linenr);
    void remove_all_breakpoints_signal (void);
    void find_translated_line_number (int original_linenr,
                                      int& translated_linenr, marker*&);
    void find_linenr_just_before (int linenr, int& original_linenr,
                                  int& editor_linenr);
    void report_marker_linenr (QIntList& lines, QStringList& conditions);
    void remove_position_via_debugger_linenr (int debugger_linenr);
    void remove_all_positions (void);
 
    void debug_quit_signal (void);
 
    void interpreter_event (const fcn_callback& fcn);
    void interpreter_event (const meth_callback& meth);
 
    void maybe_remove_next (int remove_line);
 
    void dbstop_if (const QString& prompt, int line, const QString& cond);
    void request_add_breakpoint (int line, const QString& cond);
    void request_add_octave_apis (const QStringList&);
    void api_entries_added (void);
 
    void do_save_file_signal (const QString& file_to_save,
                              bool remove_on_success, bool restore_breakpoints);
 
    void confirm_dbquit_and_save_signal (const QString& file_to_save,
                                         const QString& base_name,
                                         bool remove_on_success,
                                         bool restore_breakpoints);
 
    // FIXME: The following is similar to "process_octave_code" signal.
    // However, currently that signal is connected to something that simply
    // focuses a window and does not actually communicate with Octave.
    //
    // void evaluate_octave_command (const QString& command);
 
  public slots:
 
    void update_window_title (bool modified);
    void handle_copy_available (bool enableCopy);
    void handle_margin_clicked (int line, int margin,
                                Qt::KeyboardModifiers state);
 
    // Tells the editor tab to react on changed settings.
    void notice_settings (const gui_settings *settings, bool init = false);
 
    // Change to a different editor tab by identifier tag.
    void change_editor_state (const QWidget *ID);
 
    void set_focus (const QWidget *ID);
    void set_current_directory (const QString& dir);
    void context_help (const QWidget *ID, bool);
    void context_edit (const QWidget *ID);
    void save_file (const QWidget *ID);
    void save_file (const QWidget *ID, const QString& fileName,
                    bool remove_on_success);
    void save_file_as (const QWidget *ID);
    void print_file (const QWidget *ID);
    void run_file (const QWidget *ID, bool step_into = false);
    void context_run (const QWidget *ID);
    void toggle_bookmark (const QWidget *ID);
    void next_bookmark (const QWidget *ID);
    void previous_bookmark (const QWidget *ID);
    void remove_bookmark (const QWidget *ID);
 
    void toggle_breakpoint (const QWidget *ID);
    void next_breakpoint (const QWidget *ID);
    void previous_breakpoint (const QWidget *ID);
    void remove_all_breakpoints (const QWidget *ID);
 
    void scintilla_command (const QWidget *, unsigned int);
 
    void comment_selected_text (const QWidget *ID, bool input_str);
    void uncomment_selected_text (const QWidget *ID);
 
    void indent_selected_text (const QWidget *ID);
    void unindent_selected_text (const QWidget *ID);
    void smart_indent_line_or_selected_text (const QWidget *ID);
    void convert_eol (const QWidget *ID, QsciScintilla::EolMode);
 
    void zoom_in (const QWidget *ID);
    void zoom_out (const QWidget *ID);
    void zoom_normal (const QWidget *ID);
 
    void goto_line (const QWidget *ID, int line = -1);
    void move_match_brace (const QWidget *ID, bool select);
    void show_auto_completion (const QWidget *ID);
 
    void insert_debugger_pointer (const QWidget *ID, int line = -1);
    void delete_debugger_pointer (const QWidget *ID, int line = -1);
 
    void do_breakpoint_marker (bool insert, const QWidget *ID, int line = -1,
                               const QString& cond = "");
 
    void recover_from_exit (void);
    void set_modified (bool modified = true);
 
    void set_encoding (const QString& new_encoding);
 
    QString load_file (const QString& fileName);
 
    void new_file (const QString& commands = QString ());
 
    void file_has_changed (const QString& path, bool do_close = false);
 
    void handle_context_menu_edit (const QString&);
    void handle_context_menu_break_condition (int linenr);
 
    void handle_request_add_breakpoint (int line, const QString& cond);
    void handle_request_remove_breakpoint (int line);
 
    void update_breakpoints_handler (const octave_value_list& argout);
    void update_rowcol_indicator (int line, int col);
    void update_lexer_settings (bool update_apis_only = false);
 
  private slots:
 
    // When user closes message box for decoding problems
    void handle_decode_warning_answer (QAbstractButton *btn);
 
    // When user closes message box for reload question.
    void handle_file_reload_answer (int decision);
 
    // When user closes message box for resave question.
    void handle_file_resave_answer (int decision);
 
    // When user closes QFileDialog box.
    void handle_save_file_as_answer (const QString& fileName);
    void handle_save_file_as_answer_close (const QString& fileName);
    void handle_save_file_as_answer_cancel (void);
    void handle_save_as_filter_selected (const QString& filter);
 
    // When user changes encoding after decoding errors were found
    void handle_current_enc_changed (const QString& enc);
 
    // When apis preparation has finished and is ready to save
    void save_apis_info (void);
 
    // When the numer of lines changes -> adapt width of margin
    void auto_margin_width (void);
 
    void handle_cursor_moved (int line, int col);
    void handle_char_added (int character);
    void handle_double_click (int p, int l, int modifier);
    void handle_lines_changed (void);
 
    void handle_remove_next (int remove_line);
    void handle_dbstop_if (const QString& prompt, int line,
                           const QString& cond);
    void handle_add_octave_apis (const QStringList& api_entries);
    void handle_api_entries_added (void);
 
    void do_save_file (const QString& file_to_save, bool remove_on_success,
                       bool restore_breakpoints);
 
    void confirm_dbquit_and_save (const QString& file_to_save,
                                  const QString& base_name,
                                  bool remove_on_success,
                                  bool restore_breakpoints);
 
  protected:
 
    void closeEvent (QCloseEvent *event);
    void set_file_name (const QString& fileName);
 
  private:
 
    base_qobject& m_octave_qobj;
 
    void add_breakpoint_event (int line, const QString& cond);
 
    bool valid_file_name (const QString& file = QString ());
    void save_file (const QString& saveFileName, bool remove_on_success = false,
                    bool restore_breakpoints = true);
    void save_file_as (bool remove_on_success = false);
    bool check_valid_identifier (QString file_name);
    QTextCodec * check_valid_codec (void);
 
    bool unchanged_or_saved (void);
 
    void update_lexer (void);
 
    void show_dialog (QDialog *dlg, bool modal);
  public:
    int check_file_modified (bool remove = false);
  private:
    void do_comment_selected_text (bool comment, bool input_str = false);
    void do_indent_selected_text (bool indent);
    void do_smart_indent_line_or_selected_text (void);
 
    void check_restore_breakpoints (void);
    void center_current_line (bool always=true);
 
    QString get_function_name (void);
 
    QsciScintilla::EolMode detect_eol_mode (void);
    void update_eol_indicator (void);
 
    octave_qscintilla *m_edit_area;
 
    QStatusBar *m_status_bar;
    QLabel *m_row_indicator;
    QLabel *m_col_indicator;
    QLabel *m_eol_indicator;
    QLabel *m_enc_indicator;
 
    QsciScintilla::EolMode m_save_as_desired_eol;
 
    QString m_file_name;
    QString m_file_name_short;
    QString m_ced;
    QString m_encoding;
    QString m_new_encoding;
    QDateTime m_last_modified;
 
    bool m_autoc_active;
    bool m_copy_available;
    bool m_is_octave_file;
    bool m_always_reload_changed_files;
    bool m_smart_indent;
    int m_auto_endif;
    int m_ind_char_width;
 
    QFileSystemWatcher m_file_system_watcher;
 
    QIntList m_bp_lines;
    QStringList m_bp_conditions;
 
    QsciAPIs *m_lexer_apis;
    QString m_prep_apis_path;
    QString m_prep_apis_file;
 
    int m_line_break;
    bool m_line_break_comments;
    int m_line;
    int m_col;
    bool m_lines_changed;
    bool m_highlight_all_occurrences;
    int m_bp_restore_count;
 
    struct breakpoint_info
    {
      bool remove_next;
      int remove_line;
      int do_not_remove_line;
    };
 
    breakpoint_info m_breakpoint_info;
  };
}
 
#endif