view libgui/src/octave-dock-widget.h @ 31649:deb553ac2c54

maint: Merge stable to default.
author John W. Eaton <jwe@octave.org>
date Tue, 06 Dec 2022 15:45:27 -0500
parents 431f80aba37a 29d734430e5f
children 88119be1f926
line wrap: on
line source

////////////////////////////////////////////////////////////////////////
//
// Copyright (C) 2012-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_octave_dock_widget_h)
#define octave_octave_dock_widget_h 1

#include <QDockWidget>
#include <QIcon>
#include <QMouseEvent>
#include <QToolButton>

#include "qt-interpreter-events.h"

OCTAVE_BEGIN_NAMESPACE(octave)

  class base_qobject;
  class main_window;

  // The few decoration items common to both main window and variable editor.

  class label_dock_widget : public QDockWidget
  {
    Q_OBJECT

  public:

    label_dock_widget (QWidget *p, base_qobject& oct_qobj);

    ~label_dock_widget (void) = default;

    // set_title() uses the custom title bar while setWindowTitle() uses
    // the default title bar (with style sheets)
    void set_title (const QString&);

  protected slots:

    //! Slots to handle copy & paste.
    //!@{
    virtual void copyClipboard (void) { }
    virtual void pasteClipboard (void) { }
    virtual void selectAll (void) { }
    //!@}

    //! Slot to handle undo.

    virtual void do_undo (void) { }

  protected:

    base_qobject& m_octave_qobj;

    int m_icon_size;
    QWidget *m_title_widget;
    QToolButton *m_dock_button;
    QToolButton *m_close_button;
    QAction *m_dock_action;
    QAction *m_close_action;

    QAbstractButton *m_default_float_button;
    QAbstractButton *m_default_close_button;
  };

  class octave_dock_widget : public label_dock_widget
  {
    Q_OBJECT

  public:

    octave_dock_widget (const QString& obj_name, QWidget *p,
                        base_qobject& oct_qobj);

    ~octave_dock_widget (void) = default;

    void set_predecessor_widget (octave_dock_widget *prev_widget);

    void set_main_window (main_window *mw);

    void set_adopted (bool adopted = true) { m_adopted = adopted; }
    bool adopted (void) const { return m_adopted; }

  signals:

    //! Custom signal that tells whether a user has clicked away that dock
    //! widget, i.e. the active dock widget has changed.

    void active_changed (bool active);

    void queue_make_window (bool widget_was_dragged);

    void queue_make_widget (void);

  protected:

    virtual void closeEvent (QCloseEvent *e);

    QWidget * focusWidget (void);

    bool event (QEvent *event);

  public slots:

    virtual void activate (void);

    virtual void handle_visibility (bool visible);

    virtual void notice_settings (void) { }

    virtual void save_settings (void);

    void init_window_menu_entry (void);

    void handle_settings (void);

    void handle_active_dock_changed (octave_dock_widget *, octave_dock_widget *);

    void moveEvent (QMoveEvent *event);

    void resizeEvent (QResizeEvent *event);

    void make_window (bool widget_was_dragged = false);

    void make_widget (bool not_used = false);

    void default_dock (bool not_used = false);

  protected slots:

    virtual void toplevel_change (bool);

    //! Event filter for double clicks into the window decoration elements.

    bool eventFilter (QObject *obj, QEvent *e);

  private slots:

    void change_visibility (bool);

  private:

    void set_style (bool active);
    void set_focus_predecessor (void);
    void store_geometry (void);

    //! Stores the parent, since we are reparenting to 0.

    main_window *m_main_window;

    bool m_adopted;
    bool m_custom_style;
    bool m_focus_follows_mouse;
    int m_title_3d;
    QColor m_bg_color;
    QColor m_bg_color_active;
    QColor m_fg_color;
    QColor m_fg_color_active;
    QString m_icon_color;
    QString m_icon_color_active;
    octave_dock_widget *m_predecessor_widget;
    QRect m_recent_float_geom;
    QRect m_recent_dock_geom;
    bool m_waiting_for_mouse_button_release;
  };

OCTAVE_END_NAMESPACE(octave)

#endif