faithui/faith/scrollview.h

Go to the documentation of this file.

#ifndef FAITH__SCROLLVIEW_H
#define FAITH__SCROLLVIEW_H

#include <faith/scrollbar.h>
#include <faith/ui.h>

namespace Faith
{

namespace Internal
{
class ContentsWidget;
class ClipperWidget;
}


class FAITH_UI_EXPORT ScrollView : public Widget
{
        Q_OBJECT
        friend class Internal::ContentsWidget;
        friend class Internal::ClipperWidget;
        
        struct ScrollViewPrivate;
        ScrollViewPrivate *d;

public:
        ScrollView(Widget *parent, const char *name=0);
        ~ScrollView();

        ScrollBar *horizontalScrollBar();
        
        ScrollBar *verticalScrollBar();
        
        Widget *cornerWidget();
        
        Widget *contents();
        
        Widget *clipper();
        
        Faith::Size contentsSize() const;
        
        Faith::Size viewportSize() const;
        
        void setContentsSize(const Faith::Size &size);
        void setContentsSize(int w, int h) { setContentsSize(Size(w,h)); }
        
        Faith::Point contentsLocation() const;
        
signals:
        void scrolledTo(int x, int y);
        
        void scrolledTo(const Faith::Point &pt);

public slots:
        void scrollTo(const Faith::Point &pt);
        
        void scrollTo(int x, int y) { scrollTo(Point(x,y)); }
        
        void ensureVisible(const Faith::Point &pt);
        
        void ensureVisible(int x, int y) { ensureVisible(Point(x,y)); }
        
private slots:
        void faithReadScrollbars();

protected:
        void resizeEvent(Faith::ResizeEvent *e);
        
        void paintEvent(Faith::PaintEvent *e);
        
        virtual void contentsMousePressEvent(Faith::MouseEvent *) { }
        virtual void contentsMouseReleaseEvent(Faith::MouseEvent *) { }
        virtual void contentsMouseMoveEvent(Faith::MouseEvent *) { }
        virtual void contentsKeyPressEvent(Faith::KeyPressEvent *) { }
        virtual void contentsPaintEvent(Faith::PaintEvent *) { }
        virtual void contentsFocusInEvent(Faith::FocusEvent *) { }
        virtual void contentsFocusOutEvent(Faith::FocusEvent *) { }
        virtual void contentsEnterEvent(Faith::Event *) { }
        virtual void contentsLeaveEvent(Faith::Event *) { }

        virtual void viewportEnterEvent(Faith::Event *) { }
        virtual void viewportLeaveEvent(Faith::Event *) { }
        virtual void viewportResizeEvent(Faith::ResizeEvent *) { }

        
private:
        Point normalizeLocation(const Point&);
};

}

#endif

---