File indexing completed on 2024-04-28 07:29:26

 /*
     KmPlot - a math. function plotter for the KDE-Desktop
 
     SPDX-FileCopyrightText: 2006 David Saxton <david@bluehaze.org>
 
     This file is part of the KDE Project.
     KmPlot is part of the KDE-EDU Project.
 
     SPDX-License-Identifier: GPL-2.0-or-later
 
 */
 
 #ifndef EQUATIONEDIT_H
 #define EQUATIONEDIT_H
 
 #include "function.h"
 
 #include <QMap>
 #include <QWidget>
 
 class Equation;
 class EquationEdit;
 class EquationEditWidget;
 class EquationEditor;
 class EquationEditorWidget;
 class EquationHighlighter;
 class QPushButton;
 
 typedef QMap<QChar, QChar> CharMap;
 
 /**
  * A line edit for equations that also does syntax highlighting, error checking,
  * etc, and provides a button for invoking an advanced equation editor.
  * \author David Saxton
  */
 class EquationEdit : public QWidget
 {
     Q_OBJECT
     Q_PROPERTY(QString text READ text WRITE setText NOTIFY textEdited USER true)
 
 public:
     enum InputType {
         Function,
         Expression,
     };
 
     explicit EquationEdit(QWidget *parent);
 
     /**
      * Set the current error message and position of the error. This is
      * used to inform the user if his equation is Ok or not.
      */
     void setError(const QString &message, int position);
     /**
      * Check the validity of the current text. Called from
      * EquationHighlighter when it needs to highlight text.
      */
     void checkTextValidity();
     /**
      * Sets whether the equation edit should be storing a function (i.e. of
      * the form f(x)=[expression]), or just an expression (i.e. without the
      * f(x)= part). By default, this assumes that an expression is being
      * stored.
      */
     void setInputType(InputType type);
     /**
      * Prepends \p prefix to the start of the text when validating it.
      */
     void setValidatePrefix(const QString &prefix);
     /**
      * Hide/show the edit button.
      */
     void showEditButton(bool show);
     /**
      * Changes the equation type.
      */
     void setEquationType(Equation::Type type);
     /**
      * \return a pointer that the equation that this equation edit uses for
      * validation, etc.
      */
     Equation *equation() const
     {
         return m_equation;
     }
     /**
      * For inserting the currently selected text into a function. For
      * example, if "2+x" is selected, \p before is "sin(" and \p after is
      * ")", then the text will become "sin(2+x)".
      */
     void wrapSelected(const QString &before, const QString &after);
 
     QString text() const;
     void clear();
     void selectAll();
     void insertText(const QString &text);
 
     /**
      * Attempts to evaluate the text and return it.
      * \a ok Will be set to whether the text could be evaluated as a number.
      */
     double value(bool *ok = nullptr);
 
     /**
      * @internal workaround for QTBUG-10907
      */
     void setTabChain(QWidget *next);
 
 signals:
     void editingFinished();
     void textEdited(const QString &text);
     void textChanged(const QString &text);
     void returnPressed();
     void upPressed();
     void downPressed();
 
 public Q_SLOTS:
     void setText(const QString &text);
     /**
      * Launches a dialog for editing the equation.
      */
     void invokeEquationEditor();
 
     void reHighlight();
 
 protected Q_SLOTS:
     void slotTextChanged();
 
 protected:
     EquationHighlighter *m_highlighter;
     Equation *m_equation;
     InputType m_inputType;
     bool m_settingText : 1;
     bool m_cleaningText : 1;
     bool m_forcingRehighlight : 1;
     QString m_validatePrefix;
     EquationEditWidget *m_equationEditWidget;
     QPushButton *m_editButton;
 
     static CharMap m_replaceMap;
 
     friend class EquationEditor;
     friend class EquationEditorWidget;
     friend class EquationEditWidget;
     friend class EquationHighlighter;
 };
 
 #endif