include/QtWidgets/qgraphicswidget.h

0001 // Copyright (C) 2016 The Qt Company Ltd.
0002 // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
0003
0004 #ifndef QGRAPHICSWIDGET_H
0005 #define QGRAPHICSWIDGET_H
0006
0007 #include <QtWidgets/qtwidgetsglobal.h>
0008 #include <QtGui/qfont.h>
0009 #if QT_CONFIG(action)
0010 #  include <QtGui/qaction.h>
0011 #endif
0012 #include <QtWidgets/qgraphicslayoutitem.h>
0013 #include <QtWidgets/qgraphicsitem.h>
0014 #include <QtGui/qpalette.h>
0015
0016 QT_REQUIRE_CONFIG(graphicsview);
0017
0018 QT_BEGIN_NAMESPACE
0019
0020 class QFont;
0021 class QFontMetrics;
0022 class QGraphicsLayout;
0023 class QGraphicsSceneMoveEvent;
0024 class QGraphicsWidgetPrivate;
0025 class QGraphicsSceneResizeEvent;
0026 class QStyle;
0027 class QStyleOption;
0028
0029 class QGraphicsWidgetPrivate;
0030
0031 class Q_WIDGETS_EXPORT QGraphicsWidget : public QGraphicsObject, public QGraphicsLayoutItem
0032 {
0033     Q_OBJECT
0034     Q_INTERFACES(QGraphicsItem QGraphicsLayoutItem)
0035     Q_PROPERTY(QPalette palette READ palette WRITE setPalette)
0036     Q_PROPERTY(QFont font READ font WRITE setFont)
0037     Q_PROPERTY(Qt::LayoutDirection layoutDirection READ layoutDirection WRITE setLayoutDirection
0038                RESET unsetLayoutDirection)
0039     Q_PROPERTY(QSizeF size READ size WRITE resize NOTIFY geometryChanged)
0040     Q_PROPERTY(QSizeF minimumSize READ minimumSize WRITE setMinimumSize)
0041     Q_PROPERTY(QSizeF preferredSize READ preferredSize WRITE setPreferredSize)
0042     Q_PROPERTY(QSizeF maximumSize READ maximumSize WRITE setMaximumSize)
0043     Q_PROPERTY(QSizePolicy sizePolicy READ sizePolicy WRITE setSizePolicy)
0044     Q_PROPERTY(Qt::FocusPolicy focusPolicy READ focusPolicy WRITE setFocusPolicy)
0045     Q_PROPERTY(Qt::WindowFlags windowFlags READ windowFlags WRITE setWindowFlags)
0046     Q_PROPERTY(QString windowTitle READ windowTitle WRITE setWindowTitle)
0047     Q_PROPERTY(QRectF geometry READ geometry WRITE setGeometry NOTIFY geometryChanged)
0048     Q_PROPERTY(bool autoFillBackground READ autoFillBackground WRITE setAutoFillBackground)
0049     Q_PROPERTY(QGraphicsLayout* layout READ layout WRITE setLayout NOTIFY layoutChanged)
0050 public:
0051     QGraphicsWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags());
0052     ~QGraphicsWidget();
0053     QGraphicsLayout *layout() const;
0054     void setLayout(QGraphicsLayout *layout);
0055     void adjustSize();
0056
0057     Qt::LayoutDirection layoutDirection() const;
0058     void setLayoutDirection(Qt::LayoutDirection direction);
0059     void unsetLayoutDirection();
0060
0061     QStyle *style() const;
0062     void setStyle(QStyle *style);
0063
0064     QFont font() const;
0065     void setFont(const QFont &font);
0066
0067     QPalette palette() const;
0068     void setPalette(const QPalette &palette);
0069
0070     bool autoFillBackground() const;
0071     void setAutoFillBackground(bool enabled);
0072
0073     void resize(const QSizeF &size);
0074     inline void resize(qreal w, qreal h) { resize(QSizeF(w, h)); }
0075     QSizeF size() const;
0076
0077     void setGeometry(const QRectF &rect) override;
0078     inline void setGeometry(qreal x, qreal y, qreal w, qreal h);
0079     inline QRectF rect() const { return QRectF(QPointF(), size()); }
0080
0081     void setContentsMargins(qreal left, qreal top, qreal right, qreal bottom);
0082     void setContentsMargins(QMarginsF margins);
0083     void getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const override;
0084
0085     void setWindowFrameMargins(qreal left, qreal top, qreal right, qreal bottom);
0086     void setWindowFrameMargins(QMarginsF margins);
0087     void getWindowFrameMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const;
0088     void unsetWindowFrameMargins();
0089     QRectF windowFrameGeometry() const;
0090     QRectF windowFrameRect() const;
0091
0092     // Window handling
0093     Qt::WindowFlags windowFlags() const;
0094     Qt::WindowType windowType() const;
0095     void setWindowFlags(Qt::WindowFlags wFlags);
0096     bool isActiveWindow() const;
0097     void setWindowTitle(const QString &title);
0098     QString windowTitle() const;
0099
0100     // Focus handling
0101     Qt::FocusPolicy focusPolicy() const;
0102     void setFocusPolicy(Qt::FocusPolicy policy);
0103     static void setTabOrder(QGraphicsWidget *first, QGraphicsWidget *second);
0104     QGraphicsWidget *focusWidget() const;
0105
0106 #ifndef QT_NO_SHORTCUT
0107     int grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context = Qt::WindowShortcut);
0108     void releaseShortcut(int id);
0109     void setShortcutEnabled(int id, bool enabled = true);
0110     void setShortcutAutoRepeat(int id, bool enabled = true);
0111 #endif
0112
0113 #ifndef QT_NO_ACTION
0114     //actions
0115     void addAction(QAction *action);
0116     void addActions(const QList<QAction*> &actions);
0117     void insertActions(QAction *before, const QList<QAction*> &actions);
0118     void insertAction(QAction *before, QAction *action);
0119     void removeAction(QAction *action);
0120     QList<QAction*> actions() const;
0121 #endif
0122
0123     void setAttribute(Qt::WidgetAttribute attribute, bool on = true);
0124     bool testAttribute(Qt::WidgetAttribute attribute) const;
0125
0126     enum {
0127         Type = 11
0128     };
0129     int type() const override;
0130
0131     void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override;
0132     virtual void paintWindowFrame(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr);
0133     QRectF boundingRect() const override;
0134     QPainterPath shape() const override;
0135
0136 #if 0
0137     void dumpFocusChain();
0138 #endif
0139
0140     using QObject::children;
0141
0142 Q_SIGNALS:
0143     void geometryChanged();
0144     void layoutChanged();
0145
0146 public Q_SLOTS:
0147     bool close();
0148
0149 protected:
0150     virtual void initStyleOption(QStyleOption *option) const;
0151
0152     QSizeF sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const override;
0153     void updateGeometry() override;
0154
0155     // Notification
0156     QVariant itemChange(GraphicsItemChange change, const QVariant &value) override;
0157     virtual QVariant propertyChange(const QString &propertyName, const QVariant &value);
0158
0159     // Scene events
0160     bool sceneEvent(QEvent *event) override;
0161     virtual bool windowFrameEvent(QEvent *e);
0162     virtual Qt::WindowFrameSection windowFrameSectionAt(const QPointF& pos) const;
0163
0164     // Base event handlers
0165     bool event(QEvent *event) override;
0166     //virtual void actionEvent(QActionEvent *event);
0167     virtual void changeEvent(QEvent *event);
0168     virtual void closeEvent(QCloseEvent *event);
0169     //void create(WId window = 0, bool initializeWindow = true, bool destroyOldWindow = true);
0170     //void destroy(bool destroyWindow = true, bool destroySubWindows = true);
0171     void focusInEvent(QFocusEvent *event) override;
0172     virtual bool focusNextPrevChild(bool next);
0173     void focusOutEvent(QFocusEvent *event) override;
0174     virtual void hideEvent(QHideEvent *event);
0175     //virtual int metric(PaintDeviceMetric m ) const;
0176     virtual void moveEvent(QGraphicsSceneMoveEvent *event);
0177     virtual void polishEvent();
0178     //void resetInputContext ();
0179     virtual void resizeEvent(QGraphicsSceneResizeEvent *event);
0180     virtual void showEvent(QShowEvent *event);
0181     //virtual void tabletEvent(QTabletEvent *event);
0182     virtual void hoverMoveEvent(QGraphicsSceneHoverEvent *event) override;
0183     virtual void hoverLeaveEvent(QGraphicsSceneHoverEvent *event) override;
0184     virtual void grabMouseEvent(QEvent *event);
0185     virtual void ungrabMouseEvent(QEvent *event);
0186     virtual void grabKeyboardEvent(QEvent *event);
0187     virtual void ungrabKeyboardEvent(QEvent *event);
0188     QGraphicsWidget(QGraphicsWidgetPrivate &, QGraphicsItem *parent, Qt::WindowFlags wFlags = Qt::WindowFlags());
0189
0190 private:
0191     Q_DISABLE_COPY(QGraphicsWidget)
0192     Q_DECLARE_PRIVATE_D(QGraphicsItem::d_ptr.data(), QGraphicsWidget)
0193     friend class QGraphicsScene;
0194     friend class QGraphicsScenePrivate;
0195     friend class QGraphicsView;
0196     friend class QGraphicsItem;
0197     friend class QGraphicsItemPrivate;
0198     friend class QGraphicsLayout;
0199     friend class QWidget;
0200     friend class QApplication;
0201 };
0202
0203 inline void QGraphicsWidget::setGeometry(qreal ax, qreal ay, qreal aw, qreal ah)
0204 { setGeometry(QRectF(ax, ay, aw, ah)); }
0205
0206 QT_END_NAMESPACE
0207
0208 #endif
0209