multiplyinglineeditor.h

/*
    SPDX-FileCopyrightText: 2010 Casey Link <[email protected]>
    SPDX-FileCopyrightText: 2009-2010 Klaralvdalens Datakonsult AB, a KDAB Group company <[email protected]>
 
    Refactored from earlier code by:
    SPDX-FileCopyrightText: 2010 Volker Krause <[email protected]>
    SPDX-FileCopyrightText: 2004 Cornelius Schumacher <[email protected]>
 
    SPDX-License-Identifier: LGPL-2.0-or-later
*/
 
#pragma once
 
#include "kdepim_export.h"
 
#include "multiplyingline.h"
 
#include <KCompletion>
#include <QObject>
#include <QWidget>
 
namespace KPIM
{
class MultiplyingLineView;
 
/**
  @short An Abstract Base Class used to create MultiplyingLines
  Subclass this class and MultiplyingLine, then implement newLine() such that it allocates
  and returns an instance of your MultiplyingLine.
 */
class KDEPIM_EXPORT MultiplyingLineFactory : public QObject
{
    Q_OBJECT
public:
    explicit MultiplyingLineFactory(QObject *parent)
        : QObject(parent)
    {
    }
 
    ~MultiplyingLineFactory() override = default;
 
    virtual MultiplyingLine *newLine(QWidget *parent) = 0;
    virtual int maximumRecipients()
    {
        return -1;
    }
};
 
/**
  @short An editor that adds rows (lines) of widgets and deletes them as the user edits
 
  Line widgets in the MultiplyingLineEditor are usually composed of multiple
  basic widgets. An example is below:
 
  -------------------------------------------------
  | ComboBox|   Line edit             |  Checkbox |  <-- 1 line
  -------------------------------------------------
  | ComboBox|   Line edit             |  Checkbox | <-- another line
 
  Default behavior is one line with default settings, and when
  the user edits it, another line is automatically added.
  Lines are added and deleted on demand.
 
  Implement this class and MultiplyingLineData. Then implement
  MultiplyingLineFactory to return instances of your line.
*/
class KDEPIM_EXPORT MultiplyingLineEditor : public QWidget
{
    Q_OBJECT
    Q_PROPERTY(bool autoResizeView READ autoResizeView WRITE setAutoResizeView)
    Q_PROPERTY(bool dynamicSizeHint READ dynamicSizeHint WRITE setDynamicSizeHint)
 
public:
    // We take ownership of factory
    explicit MultiplyingLineEditor(MultiplyingLineFactory *factory, QWidget *parent = nullptr);
 
    ~MultiplyingLineEditor() override;
 
    /** Get the current line factory for this instance of the widget.
     */
    MultiplyingLineFactory *factory() const;
 
    /** Retrieve the data from the editor */
    Q_REQUIRED_RESULT QList<MultiplyingLineData::Ptr> allData() const;
 
    /** Retrieve the data of the active line */
    MultiplyingLineData::Ptr activeData() const;
 
    /** Clear all lines from the widget.
     */
    void clear();
 
    /** Returns true if the user has made any modifications to the list of
        recipients.
    */
    Q_REQUIRED_RESULT bool isModified();
 
    /** Resets the modified flag to false.
     */
    void clearModified();
 
    /** Adds data to one line of the editor.
        @param data The data you want to add.
        Can be used to add an empty/default  line.
    */
    bool addData(const MultiplyingLineData::Ptr &data = MultiplyingLineData::Ptr(), bool showDialogBox = true);
 
    /** Removes data provided it can be found. The Data class must support operator==
        @param data The data you want to add.
    */
    void removeData(const MultiplyingLineData::Ptr &data);
 
    /**
      Set the width of the left most column to be the argument width.
      This method allows other widgets to align their label/combobox column with ours
      by communicating how many pixels that first column is for them.
      @param w what the left most column width should be
      @return the width that is actually being used.
      */
    int setFirstColumnWidth(int w);
 
    /**
      Set completion mode for all lines
      @param mode the completion mode
      */
    void setCompletionMode(KCompletion::CompletionMode mode);
 
    /**
     Set the underlying view's frame shape, default is none.
     @param shape of type QFrame::Shape
     */
    void setFrameStyle(int shape);
 
    /**
     Make the line view follow it's children's size
     @param resize turn on or off this behavior of auto resizing
     */
    void setAutoResizeView(bool resize);
    Q_REQUIRED_RESULT bool autoResizeView();
 
    /**
     * Sets whether the size hint of the editor shall be calculated
     * dynamically by the number of lines. Default is @c true.
     */
    void setDynamicSizeHint(bool dynamic);
    Q_REQUIRED_RESULT bool dynamicSizeHint() const;
 
    virtual QList<MultiplyingLine *> lines() const;
 
Q_SIGNALS:
    void focusUp();
    void focusDown();
    void completionModeChanged(KCompletion::CompletionMode);
    void sizeHintChanged();
    void lineDeleted(int pos);
    void lineAdded(KPIM::MultiplyingLine *);
 
public Q_SLOTS:
    void setFocus();
    void setFocusTop();
    void setFocusBottom();
 
protected:
    virtual MultiplyingLine *activeLine() const;
    bool mModified = false;
 
private:
    MultiplyingLineFactory *const mMultiplyingLineFactory;
    MultiplyingLineView *mView = nullptr;
};
}