gtextarea.h

/*
 * File: gtextarea.h
 * -----------------
 *
 * @author Marty Stepp
 * @version 2021/04/09
 * - added sgl namespace
 * @version 2019/04/23
 * - moved some event listener code to GInteractor superclass
 * @version 2018/09/10
 * - added doc comments for new documentation generation
 * @version 2018/08/23
 * - renamed to gtextarea.h to replace Java version
 * @version 2018/06/25
 * - initial version
 */


#ifndef _gtextarea_h
#define _gtextarea_h

#include <string>
#include <QTextEdit>

#include "ginteractor.h"

namespace sgl {

class _Internal_QTextEdit;

class GTextArea : public GInteractor {
public:
    GTextArea(int rows, int columns, QWidget* parent = nullptr);

    GTextArea(const string& text = "", QWidget* parent = nullptr);

    ~GTextArea() override;

    virtual void appendFormattedText(const string& text, const string& color = "", const string& font = "");

    virtual void appendHtml(const string& html);

    virtual void appendText(const string& text);

    virtual void clearSelection();

    virtual void clearText();

    virtual int getColumns() const;

    virtual int getCursorPosition() const;

    virtual string getHtml() const;

    /* @inherit */
    _Internal_QWidget* getInternalWidget() const override;

    virtual string getPlaceholder() const;

    virtual int getRows() const;

    virtual string getSelectedText() const;

    virtual int getSelectionEnd() const;

    virtual int getSelectionLength() const;

    virtual int getSelectionStart() const;

    virtual string getText() const;

    /* @inherit */
    string getType() const override;

    /* @inherit */
    QWidget* getWidget() const override;

    virtual bool isContextMenuEnabled() const;

    virtual bool isEditable() const;

    virtual bool isLineWrap() const;

    virtual void moveCursorToEnd();

    virtual void moveCursorToStart();

    virtual void removeTextChangeListener();

    virtual void scrollToBottom();

    virtual void scrollToTop();

    virtual void select(int startIndex, int length);

    virtual void selectAll();

    virtual void setColumns(int columns);

    virtual void setContextMenuEnabled(bool enabled);

    virtual void setCursorPosition(int index, bool keepAnchor = false);

    virtual void setEditable(bool value);

    virtual void setHtml(const string& html);

    virtual void setLineWrap(bool wrap);

    void setMouseListener(GEventListener func) override;

    void setMouseListener(GEventListenerVoid func) override;

    virtual void setPlaceholder(const string& text);

    virtual void setRows(int rows);

    virtual void setRowsColumns(int rows, int columns);

    virtual void setText(const string& text);

    virtual void setTextChangeListener(GEventListener func);

    virtual void setTextChangeListener(GEventListenerVoid func);

private:
    Q_DISABLE_COPY(GTextArea)

    _Internal_QTextEdit* _iqtextedit;
    bool _contextMenuEnabled;

    // helper used by getRows, getColumns, etc.
    GDimension getRowColumnSize() const;

    friend class _Internal_QTextEdit;
};

class _Internal_QTextEdit : public QTextEdit, public _Internal_QWidget {
    Q_OBJECT

public:
    _Internal_QTextEdit(GTextArea* gtextArea, QWidget* parent = nullptr);
    void contextMenuEvent(QContextMenuEvent* event) override;
    void detach() override;
    void keyPressEvent(QKeyEvent* event) override;
    void keyReleaseEvent(QKeyEvent* event) override;
    void mousePressEvent(QMouseEvent* event) override;
    void mouseReleaseEvent(QMouseEvent* event) override;
    QSize sizeHint() const override;

public slots:
    void handleScroll(int value);
    void handleTextChange();

private:
    GTextArea* _gtextarea;

    friend class GTextArea;
};

} // namespace sgl

#endif // _gtextarea_h