File indexing completed on 2024-12-08 11:07:00

 /****************************************************************************
 **
 ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
 ** Contact: http://www.qt-project.org/legal
 **
 ** This file is part of the Qt3Support module of the Qt Toolkit.
 **
 ** $QT_BEGIN_LICENSE:LGPL$
 ** Commercial License Usage
 ** Licensees holding valid commercial Qt licenses may use this file in
 ** accordance with the commercial license agreement provided with the
 ** Software or, alternatively, in accordance with the terms contained in
 ** a written agreement between you and Digia.  For licensing terms and
 ** conditions see http://qt.digia.com/licensing.  For further information
 ** use the contact form at http://qt.digia.com/contact-us.
 **
 ** GNU Lesser General Public License Usage
 ** Alternatively, this file may be used under the terms of the GNU Lesser
 ** General Public License version 2.1 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.LGPL included in the
 ** packaging of this file.  Please review the following information to
 ** ensure the GNU Lesser General Public License version 2.1 requirements
 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
 **
 ** In addition, as a special exception, Digia gives you certain additional
 ** rights.  These rights are described in the Digia Qt LGPL Exception
 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
 **
 ** GNU General Public License Usage
 ** Alternatively, this file may be used under the terms of the GNU
 ** General Public License version 3.0 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.  Please review the following information to
 ** ensure the GNU General Public License version 3.0 requirements will be
 ** met: http://www.gnu.org/copyleft/gpl.html.
 **
 **
 ** $QT_END_LICENSE$
 **
 ****************************************************************************/
 
 #ifndef KTL_Q3SCROLLVIEW_H
 #define KTL_Q3SCROLLVIEW_H
 
 #include <QScrollBar>
 #include <ktlqt3support/ktlq3frame.h>
 
 // QT_BEGIN_HEADER
 
 // QT_BEGIN_NAMESPACE
 
 // QT_MODULE(Qt3SupportLight)
 
 class KtlQ3ScrollViewData;
 
 class KtlQ3ScrollView : public KtlQ3Frame
 {
     Q_OBJECT
     Q_ENUMS(ResizePolicy ScrollBarMode)
     Q_PROPERTY(ResizePolicy resizePolicy READ resizePolicy WRITE setResizePolicy)
     Q_PROPERTY(ScrollBarMode vScrollBarMode READ vScrollBarMode WRITE setVScrollBarMode)
     Q_PROPERTY(ScrollBarMode hScrollBarMode READ hScrollBarMode WRITE setHScrollBarMode)
     Q_PROPERTY(int visibleWidth READ visibleWidth)
     Q_PROPERTY(int visibleHeight READ visibleHeight)
     Q_PROPERTY(int contentsWidth READ contentsWidth)
     Q_PROPERTY(int contentsHeight READ contentsHeight)
     Q_PROPERTY(int contentsX READ contentsX)
     Q_PROPERTY(int contentsY READ contentsY)
     Q_PROPERTY(bool dragAutoScroll READ dragAutoScroll WRITE setDragAutoScroll)
 
 public:
     KtlQ3ScrollView(QWidget *parent = nullptr, const char *name = nullptr, Qt::WindowFlags f = {});
     ~KtlQ3ScrollView() override;
 
     enum ResizePolicy { Default, Manual, AutoOne, AutoOneFit };
     virtual void setResizePolicy(ResizePolicy);
     ResizePolicy resizePolicy() const;
 
     void styleChange(QStyle &);
     void removeChild(QWidget *child);
     virtual void addChild(QWidget *child, int x = 0, int y = 0);
     virtual void moveChild(QWidget *child, int x, int y);
     int childX(QWidget *child);
     int childY(QWidget *child);
     bool childIsVisible(QWidget *child)
     {
         return child->isVisible();
     } // obsolete functions
     void showChild(QWidget *child, bool yes = true)
     {
         child->setVisible(yes);
     }
 
     enum ScrollBarMode { Auto, AlwaysOff, AlwaysOn };
 
     ScrollBarMode vScrollBarMode() const;
     virtual void setVScrollBarMode(ScrollBarMode);
 
     ScrollBarMode hScrollBarMode() const;
     virtual void setHScrollBarMode(ScrollBarMode);
 
     QWidget *cornerWidget() const;
     virtual void setCornerWidget(QWidget *);
 
     // ### 4.0: Consider providing a factory function for scrollbars
     //          (e.g. make the two following functions virtual)
     QScrollBar *horizontalScrollBar() const;
     QScrollBar *verticalScrollBar() const;
     QWidget *viewport() const;
     QWidget *clipper() const;
 
     int visibleWidth() const;
     int visibleHeight() const;
 
     int contentsWidth() const;
     int contentsHeight() const;
     int contentsX() const;
     int contentsY() const;
 
     void resize(int w, int h);
     void resize(const QSize &);
     void setVisible(bool visible) override;
 
     void updateContents(int x, int y, int w, int h);
     void updateContents(const QRect &r);
     void updateContents();
     void repaintContents(int x, int y, int w, int h, bool erase = true);
     void repaintContents(const QRect &r, bool erase = true);
     void repaintContents(bool erase = true);
     void contentsToViewport(int x, int y, int &vx, int &vy) const;
     void viewportToContents(int vx, int vy, int &x, int &y) const;
     QPoint contentsToViewport(const QPoint &) const;
     QPoint viewportToContents(const QPoint &) const;
     void enableClipper(bool y);
 
     void setStaticBackground(bool y);
     bool hasStaticBackground() const;
 
     QSize viewportSize(int, int) const;
     QSize sizeHint() const override;
     QSize minimumSizeHint() const override;
 
     void removeChild(QObject *child);
 
     bool isHorizontalSliderPressed();
     bool isVerticalSliderPressed();
 
     virtual void setDragAutoScroll(bool b);
     bool dragAutoScroll() const;
 
 Q_SIGNALS:
     void contentsMoving(int x, int y);
     void horizontalSliderPressed();
     void horizontalSliderReleased();
     void verticalSliderPressed();
     void verticalSliderReleased();
 
 public Q_SLOTS:
     virtual void resizeContents(int w, int h);
     void scrollBy(int dx, int dy);
     virtual void setContentsPos(int x, int y);
     void ensureVisible(int x, int y);
     void ensureVisible(int x, int y, int xmargin, int ymargin);
     void center(int x, int y);
     void center(int x, int y, float xmargin, float ymargin);
 
     void updateScrollBars(); // ### virtual in 4.0
     void setEnabled(bool enable);
 
 protected:
     virtual void drawContents(QPainter *, int cx, int cy, int cw, int ch);
     virtual void drawContentsOffset(QPainter *, int ox, int oy, int cx, int cy, int cw, int ch);
 
     virtual void contentsMousePressEvent(QMouseEvent *);
     virtual void contentsMouseReleaseEvent(QMouseEvent *);
     virtual void contentsMouseDoubleClickEvent(QMouseEvent *);
     virtual void contentsMouseMoveEvent(QMouseEvent *);
     virtual void contentsDragEnterEvent(QDragEnterEvent *);
     virtual void contentsDragMoveEvent(QDragMoveEvent *);
     virtual void contentsDragLeaveEvent(QDragLeaveEvent *);
     virtual void contentsDropEvent(QDropEvent *);
     virtual void contentsWheelEvent(QWheelEvent *);
     virtual void contentsContextMenuEvent(QContextMenuEvent *);
 
     virtual void viewportPaintEvent(QPaintEvent *);
     virtual void viewportResizeEvent(QResizeEvent *);
     virtual void viewportMousePressEvent(QMouseEvent *);
     virtual void viewportMouseReleaseEvent(QMouseEvent *);
     virtual void viewportMouseDoubleClickEvent(QMouseEvent *);
     virtual void viewportMouseMoveEvent(QMouseEvent *);
     virtual void viewportDragEnterEvent(QDragEnterEvent *);
     virtual void viewportDragMoveEvent(QDragMoveEvent *);
     virtual void viewportDragLeaveEvent(QDragLeaveEvent *);
     virtual void viewportDropEvent(QDropEvent *);
     virtual void viewportWheelEvent(QWheelEvent *);
     virtual void viewportContextMenuEvent(QContextMenuEvent *);
 
     void frameChanged() override;
 
 public:
     virtual void setMargins(int left, int top, int right, int bottom);
     int leftMargin() const;
     int topMargin() const;
     int rightMargin() const;
     int bottomMargin() const;
 
 protected:
     bool focusNextPrevChild(bool next) override;
 
     virtual void setHBarGeometry(QScrollBar &hbar, int x, int y, int w, int h);
     virtual void setVBarGeometry(QScrollBar &vbar, int x, int y, int w, int h);
 
     void resizeEvent(QResizeEvent *) override;
     void mousePressEvent(QMouseEvent *) override;
     void mouseReleaseEvent(QMouseEvent *) override;
     void mouseDoubleClickEvent(QMouseEvent *) override;
     void mouseMoveEvent(QMouseEvent *) override;
     void wheelEvent(QWheelEvent *) override;
     void contextMenuEvent(QContextMenuEvent *) override;
     bool eventFilter(QObject *, QEvent *e) override;
 
     void setCachedSizeHint(const QSize &sh) const;
     QSize cachedSizeHint() const;
     void fontChange(const QFont &);
 
 private:
     void drawContents(QPainter *) override;
     void moveContents(int x, int y);
 
     KtlQ3ScrollViewData *d;
 
 private Q_SLOTS:
     void hslide(int);
     void vslide(int);
     void hbarIsPressed();
     void hbarIsReleased();
     void vbarIsPressed();
     void vbarIsReleased();
     void doDragAutoScroll();
     void startDragAutoScroll();
     void stopDragAutoScroll();
 
 private: // Disabled copy constructor and operator=
     Q_DISABLE_COPY(KtlQ3ScrollView)
     void changeFrameRect(const QRect &);
 
 public:
     void disableSizeHintCaching();
 };
 
 class KtlQAbstractScrollAreaWidget : public QWidget
 {
     Q_OBJECT
 
 public:
     KtlQAbstractScrollAreaWidget(KtlQ3ScrollView *parent = nullptr, const char *name = nullptr, Qt::WindowFlags f = {})
         : QWidget(parent, f)
     {
         setObjectName(name);
         setAutoFillBackground(true);
     }
 };
 
 class KtlQClipperWidget : public QWidget
 {
     Q_OBJECT
 
 public:
     KtlQClipperWidget(QWidget *parent = nullptr, const char *name = nullptr, Qt::WindowFlags f = {})
         : QWidget(parent, f)
     {
         setObjectName(name);
     }
 };
 
 // QT_END_NAMESPACE
 
 // QT_END_HEADER
 
 #endif // KTL_Q3SCROLLVIEW_H