qgslayoutitemwidget.h

Go to the documentation of this file.

/***************************************************************************
                             qgslayoutitemwidget.h
                             ------------------------
    Date                 : July 2017
    Copyright            : (C) 2017 Nyall Dawson
    Email                : nyall dot dawson at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   This program 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 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
#ifndef QGSLAYOUTITEMWIDGET_H
#define QGSLAYOUTITEMWIDGET_H
 
#include "ui_qgslayoutitemwidgetbase.h"
 
#include "qgis_gui.h"
#include "qgslayoutitem.h"
#include "qgslayoutobject.h"
#include "qgspanelwidget.h"
 
#include <QObject>
#include <QPointer>
 
class QgsLayoutDesignerInterface;
class QgsPropertyOverrideButton;
class QgsLayoutAtlas;
class QgsMasterLayoutInterface;
 
// NOTE - the inheritance here is tricky, as we need to avoid the multiple inheritance
// diamond problem and the ideal base object (QgsLayoutConfigObject) MUST be a QObject
// because of its slots.
 
// So here we go:
// QgsLayoutItemWidget is just a QWidget which is embedded inside specific item property
// widgets and contains common settings like position and rotation of the items. While the
// actual individual item type widgets MUST be QgsPanelWidgets unfortunately QgsLayoutItemWidget
// CANNOT be a QgsPanelWidget and must instead be a generic QWidget (otherwise a QgsPanelWidget
// contains a child QgsPanelWidget, which breaks lots of assumptions made in QgsPanelWidget
// and related classes).
// So QgsLayoutItemWidget HAS a QgsLayoutConfigObject to handle these common tasks.
// Specific item property widgets (e.g., QgsLayoutMapWidget) should inherit from QgsLayoutItemBaseWidget
// (which is a QgsPanelWidget) and also HAS a QgsLayoutConfigObject, with protected methods
// which are just proxied through to the QgsLayoutConfigObject.
// phew!
// long story short - don't change this without good reason. If you add a new item type, inherit
// from QgsLayoutItemBaseWidget and trust that everything else has been done for you.

class GUI_EXPORT QgsLayoutConfigObject : public QObject
{
    Q_OBJECT
  public:

    QgsLayoutConfigObject( QWidget *parent SIP_TRANSFERTHIS, QgsLayoutObject *layoutObject );

    void initializeDataDefinedButton( QgsPropertyOverrideButton *button, QgsLayoutObject::DataDefinedProperty key );

    void updateDataDefinedButton( QgsPropertyOverrideButton *button );

    QgsVectorLayer *coverageLayer() const;

    QgsLayoutAtlas *layoutAtlas() const;

    void setObject( QgsLayoutObject *object ) SIP_SKIP;
 
  private slots:
    void updateDataDefinedProperty();

    void updateDataDefinedButtons();
 
  private:
    QPointer<QgsLayoutObject> mLayoutObject;
};

class GUI_EXPORT QgsLayoutItemBaseWidget : public QgsPanelWidget
{
    Q_OBJECT
 
  public:

    QgsLayoutItemBaseWidget( QWidget *parent SIP_TRANSFERTHIS, QgsLayoutObject *layoutObject );

    QgsLayoutObject *layoutObject();

    bool setItem( QgsLayoutItem *item );

    virtual void setReportTypeString( const QString &string );

    virtual void setDesignerInterface( QgsLayoutDesignerInterface *iface );

    virtual void setMasterLayout( QgsMasterLayoutInterface *masterLayout );
 
  protected:

    void registerDataDefinedButton( QgsPropertyOverrideButton *button, QgsLayoutObject::DataDefinedProperty property );

    void updateDataDefinedButton( QgsPropertyOverrideButton *button );

    QgsVectorLayer *coverageLayer() const;

    virtual bool setNewItem( QgsLayoutItem *item );

    QgsLayoutAtlas *layoutAtlas() const;
 
  private:
    QgsLayoutConfigObject *mConfigObject = nullptr;
 
    QgsLayoutObject *mObject = nullptr;
};
 

class GUI_EXPORT QgsLayoutItemPropertiesWidget : public QWidget, private Ui::QgsLayoutItemWidgetBase
{
    Q_OBJECT
  public:

    QgsLayoutItemPropertiesWidget( QWidget *parent, QgsLayoutItem *item );

    QgsLayoutItem::ReferencePoint positionMode() const;

    void showBackgroundGroup( bool showGroup );

    void showFrameGroup( bool showGroup );

    void setItem( QgsLayoutItem *item );

    void setMasterLayout( QgsMasterLayoutInterface *masterLayout );

    void updateVariables();
 
  protected slots:
    void initializeDataDefinedButtons();
    void populateDataDefinedButtons();
 
  private slots:

    void mFrameColorButton_colorChanged( const QColor &newFrameColor );

    void mBackgroundColorButton_colorChanged( const QColor &newBackgroundColor );
    //    void on_mTransparencySlider_valueChanged( int value );
    //    void on_mTransparencySpinBox_valueChanged( int value );
    void mStrokeWidthSpinBox_valueChanged( double d );
    void strokeUnitChanged( Qgis::LayoutUnit unit );
    void mFrameGroupBox_toggled( bool state );
    void mFrameJoinStyleCombo_currentIndexChanged( int index );
    void mBackgroundGroupBox_toggled( bool state );
    void mItemIdLineEdit_editingFinished();
    void exportGroupNameEditingFinished();
 
    //adjust coordinates in line edits
    void mPageSpinBox_valueChanged( int );
    void mXPosSpin_valueChanged( double );
    void mYPosSpin_valueChanged( double );
    void positionUnitsChanged( Qgis::LayoutUnit unit );
    void mWidthSpin_valueChanged( double );
    void mHeightSpin_valueChanged( double );
    void sizeUnitsChanged( Qgis::LayoutUnit unit );
 
    void mUpperLeftCheckBox_stateChanged( bool state );
    void mUpperMiddleCheckBox_stateChanged( bool state );
    void mUpperRightCheckBox_stateChanged( bool state );
    void mMiddleLeftCheckBox_stateChanged( bool state );
    void mMiddleCheckBox_stateChanged( bool state );
    void mMiddleRightCheckBox_stateChanged( bool state );
    void mLowerLeftCheckBox_stateChanged( bool state );
    void mLowerMiddleCheckBox_stateChanged( bool state );
    void mLowerRightCheckBox_stateChanged( bool state );
 
    void mBlendModeCombo_currentIndexChanged( int index );
    void opacityChanged( double value );
 
    void mItemRotationSpinBox_valueChanged( double val );
    void mExcludeFromPrintsCheckBox_toggled( bool checked );
 
    void setValuesForGuiElements();
    //sets the values for all position related (x, y, width, height) elements
    void setValuesForGuiPositionElements();
    //sets the values for all non-position related elements
    void setValuesForGuiNonPositionElements();
 
    void variablesChanged();
 
  private:
    QPointer<QgsLayoutItem> mItem;
    QgsLayoutConfigObject *mConfigObject = nullptr;
 
    bool mFreezeXPosSpin = false;
    bool mFreezeYPosSpin = false;
    bool mFreezeWidthSpin = false;
    bool mFreezeHeightSpin = false;
    bool mFreezePageSpin = false;
    bool mBlockVariableUpdates = false;
    //    void changeItemTransparency( int value );
    void changeItemPosition();
    void changeItemReference( QgsLayoutItem::ReferencePoint point );
    void changeItemSize();
};
 
 
#endif // QGSLAYOUTITEMWIDGET_H