#include <hbstyleframeprimitivedata.h>

#include <QGraphicsSceneResizeEvent>

    @beta

    @hbcore

    \class HbScrollArea

    \brief The HbScrollArea class provides a touch-enabled scrolling view onto another

    widget.

    A scroll area displays the contents of another widget within a frame. If the size of

    this widget exceeds the size of the frame, the user can scroll so that the entire

    contents can be viewed. The user scrolls through the contents by using a dragging

    gesture. If scroll bars are enabled and the scroll bar is interactive, the user can

    also scroll through the contents using the scroll bar (HbScrollBar class).

    %HbScrollArea is a concrete class that you can use directly in your applications to

    provide default scrolling behavior. %HbScrollArea is also a base class for

    HbAbstractItemView and the item view classes that derive from it. If necessary, you

    can subclass %HbScrollArea to add additional features, such as touch and selection

    feedback.

    \image html hbscrollarea.png A scroll area containing a large image and showing scrollbars

    %HbScrollArea provides properties that you can use to customize the following aspects

    of the scroll area:

    - <b>Scrolling style</b>. The user scrolls through the contents by using a dragging

         movement. This property controls what happens when the user releases the pressure.

         The default is that a follow-on animation continues the scrolling if the dragging

         was fast. Alternatively, the scrolling can stop as soon as the user releases the

         pressure, regardless of the dragging speed. Call setScrollingStyle() to set this

         property.

    - <b>Friction effect</b>. This property controls the speed of the follow-on scrolling

         animation. When the friction effect is enabled, it slows the animation and causes

         it to stop more quickly than when the effect is not enabled. Call setFrictionEnabled()

         to set this property.

    - <b>Clamping style</b>. This property controls how scrolling is constrained relative

         to the contents of the scrolling area. Scrolling can be limited to the bounding

         rectangle of the contents or it can go beyond the bounding rectangle and bounce

         back to its limits (this is the default). Call setClampingStyle() to set this

         property.

    - <b>Scroll direction</b>. This property controls the scrolling direction. The default is

         vertical scrolling, but this can be changed to horizontal or bi-directional scrolling.

         Call setScrollDirections() to set this property.

    - <b>Scrollbar policy</b>. There is a separate scrollbar policy property for both scrollbars.

         You can set these so that the scrollbar is always shown, never shown, only shown when

         needed or for short periods (autohide), which is the default behavior. Call

         setVerticalScrollBarPolicy() and setHorizontalScrollBarPolicy() to set these properties.

    - <b>Continuation indicators</b>. This property controls whether visual feedback is provided

         to indicate when scrolling is possible. The default value is false. Call

         setContinuationIndicators() to set this property.

    The contents widget must be an object of a class derived from QGraphicsWidget. After

    constructing this widget, you set it into the scroll area by calling setContentWidget().

    The scroll area uses QGraphicsWidget::sizeHint() to resize the content widget to fit,

    taking into account the scroll direction. For example, when the scrolling direction is

    vertical, the scroll area resizes the contents widget to fit the width of the scroll area.

    \section _usecases_hbscrollarea Using the HbScrollArea class

    This example creates an HbScrollArea widget and sets a large photo as its contents.

    \code

int main(int argc, char *argv[])

{

    HbApplication app(argc, argv);

    app.setApplicationName( "Scroll Area" );

    HbMainWindow window;

    HbView* view = new HbView();

    // Create the scroll area object.

    HbScrollArea* scrollArea = new HbScrollArea();

    // Create the content widget.

    QGraphicsWidget* content = new QGraphicsWidget();

    // Create a pixmap as a child of the content widget.

    QString string(":/gfx/beach.jpg");

    QGraphicsPixmapItem* pixmapItem = new QGraphicsPixmapItem(string, content);

    // Set the preferred size of the content widget to match the full size of the photo.

    content->setPreferredSize(pixmapItem->boundingRect().size());

    // Load the content widget into the scrolling area.

    scrollArea->setContentWidget(content);

    // Set the scroll area to scroll in both directions.

    scrollArea->setScrollDirections(Qt::Vertical | Qt::Horizontal);

    view->setWidget(scrollArea);

    window.addView(view);

    window.show();

    return app.exec();

}

    \endcode

    \sa HbScrollBar

 */

    This signal is emitted when the scrolling direction changes.

    This signal is emitted when a scrolling action begins.

    This signal is emitted when a scrolling action ends.

    \fn void HbScrollArea::scrollPositionChanged(const QPointF &newPosition)

    This signal is emitted when the scroll position is changed, but only if this signal

    is connected to a slot.

    Defines the clamping styles supported by HbScrollArea. The clamping style

    controls the behavior when scrolling to the edge of the contents of the scrolling

    area.

    \sa setClampingStyle(), clampingStyle()

    Scrolling is limited to the bounding rectangle of the contents.

*/

    Scrolling can go beyond the bounding rectangle of the contents, but bounces

    back to the limits of the bounding rectangle when released or when the follow-on

    scrolling animation stops. This is the default clamping style.

*/

    Scrolling is unclamped. Typically you use this only in a subclass that implements

    its own custom clamping behavior.

*/

    Defines the scrolling styles supported by HbScrollArea. The scrolling style

    controls which gestures the user can use to scroll the contents and how the scrolling

    responds to those gestures.

    \sa setScrollingStyle(), scrollingStyle()

    The user can scroll through the contents by using a dragging motion. The scrolling

    stops as soon as the user stops the dragging motion.

    \deprecated

    The user can scroll through the contents by using a dragging motion and a quick

    flicking motion triggers a follow-on scrolling animation.

    The user can scroll through the contents by using a dragging motion. In addition

    a fast dragging motion triggers a follow-on scrolling animation when the user

    stops dragging and releases the pressure. This is the default scrolling style.

    Defines the scroll bar visibility modes supported by  HbScrollArea.

    \sa setVerticalScrollBarPolicy(), verticalScrollBarPolicy(),

    setHorizontalScrollBarPolicy(), horizontalScrollBarPolicy()

    Show the scroll bar only when the contents are too large to fit.

    Never show the scroll bar.

    Always show the scroll bar.

    Show the scroll bar for a short period when the contents are first displayed or

    when the user scrolls the contents. This is the default behavior.

    Constructs an HbScrollArea object with the given \a parent.

HbScrollArea::HbScrollArea(QGraphicsItem* parent) :

    Protected constructor.

    Destructor

    Returns a pointer to the widget that is contained within the scroll area

    and that defines the contents to be scrolled.

    \sa setContentWidget()

   Assigns a widget (QGraphicsWidget object) to the scroll area. This widget defines

   the contents of the scroll area. The HbScrollArea object takes ownership of the

   contents widget.

   \sa contentWidget()

    Removes the scroll area's content widget from the scroll area, returns it, and

    transfers ownership of the content widget to the caller. This is useful when you

    need to switch the contents without deleting previous contents.

 */

    Returns the value of the \c clampingStyle property.

    \sa setClampingStyle(), HbScrollArea::ClampingStyle

    Sets the \c clampingStyle property, which controls how scrolling is constrained

    relative to the contents of the scrolling area. The possible values are defined

    by the HbScrollArea::ClampingStyle enum. The default is

    HbScrollArea::BounceBackClamping.

    \sa clampingStyle()

    Returns the value of the \c scrollingStyle property.

    \sa setScrollingStyle()

    Sets the \c scrollingStyle property, which controls which gestures the user can

    use to scroll the contents and how the scrolling responds to those gestures. The

    possible values are defined by the HbScrollArea::ScrollingStyle enum. The default

    value is HbScrollArea::PanWithFollowOn.

    \sa scrollingStyle()

    Returns the value of the \c scrollDirections property.

    \sa setScrollDirections()

    Sets the \c scrollDirections property, which controls the scrolling direction. The

    possible values are defined by the Qt::Orientations enum, as shown in the following

    table. The default value is Qt::Vertical.

    <table border="1" style="border-collapse: collapse; border: solid;">

    <tr><th>To enable:</th><th>Set to:</th></tr>

    <tr><td>Horizontal scrolling</td><td>Qt::Horizontal</td></tr>

    <tr><td>Vertical scrolling</td><td>Qt::Vertical</td></tr>

    <tr><td>Scrolling in both directions</td><td>Qt::Horizontal | Qt::Vertical</td></tr>

    </table>

    \sa scrollDirections()

    Returns true if the friction effect is enabled, false otherwise.

    \sa setFrictionEnabled()

    Sets the \c frictionEnabled property. The default value is true, which

    indicates that the friction effect is enabled.

    When the HbScrollArea::PanWithFollowOn scrolling style is in use, the

    \c frictionEnabled property controls the speed of the follow-on scrolling

    animation. When the friction effect is enabled (the default), it slows the

    animation and causes it to stop earlier than when the friction effect is not

    in use.

    \sa frictionEnabled()