homescreenapp/hsutils/inc/hswidgetpositioningonwidgetmove.h
author hgs
Fri, 23 Jul 2010 13:47:57 +0300
changeset 69 87476091b3f5
parent 63 52b0f64eeb51
permissions -rw-r--r--
201029
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
62
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef HSWIDGETPOSITIONINGONWIDGETMOVE_H
hgs
parents:
diff changeset
    19
#define HSWIDGETPOSITIONINGONWIDGETMOVE_H
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#include <QVariantHash>
hgs
parents:
diff changeset
    22
#include <QList>
hgs
parents:
diff changeset
    23
#include <QRectF>
hgs
parents:
diff changeset
    24
#include <QPointF>
hgs
parents:
diff changeset
    25
#include <QLineF>
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
#include "hsutils_global.h"
hgs
parents:
diff changeset
    28
#include "hstest_global.h"
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
HOMESCREEN_TEST_CLASS(t_hsUtils)
hgs
parents:
diff changeset
    31
hgs
parents:
diff changeset
    32
class HSUTILS_EXPORT HsWidgetPositioningOnWidgetMove
hgs
parents:
diff changeset
    33
{
hgs
parents:
diff changeset
    34
public:
hgs
parents:
diff changeset
    35
    class Result
hgs
parents:
diff changeset
    36
    {
hgs
parents:
diff changeset
    37
    public:
hgs
parents:
diff changeset
    38
        Result() : hasHorizontalSnap(false), hasVerticalSnap(false),
hgs
parents:
diff changeset
    39
                   horizontalSnapPosition(0.0), verticalSnapPosition(0.0)
hgs
parents:
diff changeset
    40
        { }
hgs
parents:
diff changeset
    41
        bool isNull() const 
hgs
parents:
diff changeset
    42
        { return !hasHorizontalSnap && !hasVerticalSnap; }
hgs
parents:
diff changeset
    43
hgs
parents:
diff changeset
    44
        bool hasHorizontalSnap;
hgs
parents:
diff changeset
    45
        bool hasVerticalSnap;
hgs
parents:
diff changeset
    46
        qreal horizontalSnapPosition;
hgs
parents:
diff changeset
    47
        qreal verticalSnapPosition;
hgs
parents:
diff changeset
    48
        QLineF verticalSnapLine;
hgs
parents:
diff changeset
    49
        QLineF horizontalSnapLine;
hgs
parents:
diff changeset
    50
    };
hgs
parents:
diff changeset
    51
hgs
parents:
diff changeset
    52
    virtual ~HsWidgetPositioningOnWidgetMove() {}
hgs
parents:
diff changeset
    53
    
hgs
parents:
diff changeset
    54
    virtual void setConfiguration(const QVariantHash &configuration) = 0;
hgs
parents:
diff changeset
    55
hgs
parents:
diff changeset
    56
    virtual void setPagePresentation(const QRectF &containerRect, 
hgs
parents:
diff changeset
    57
                                     const QList<QRectF> &inactiveRects,
hgs
parents:
diff changeset
    58
                                     const QRectF &activeRect) = 0;
hgs
parents:
diff changeset
    59
hgs
parents:
diff changeset
    60
    virtual Result run(const QRectF &movingRect) = 0;
hgs
parents:
diff changeset
    61
hgs
parents:
diff changeset
    62
    static void setInstance(HsWidgetPositioningOnWidgetMove *instance);
hgs
parents:
diff changeset
    63
    static HsWidgetPositioningOnWidgetMove *instance();
hgs
parents:
diff changeset
    64
hgs
parents:
diff changeset
    65
private:
hgs
parents:
diff changeset
    66
    static HsWidgetPositioningOnWidgetMove *mInstance;
hgs
parents:
diff changeset
    67
};
hgs
parents:
diff changeset
    68
hgs
parents:
diff changeset
    69
class HsSnapRectangle
hgs
parents:
diff changeset
    70
{
hgs
parents:
diff changeset
    71
public:
hgs
parents:
diff changeset
    72
    HsSnapRectangle() : rectangle(QRectF()) 
hgs
parents:
diff changeset
    73
    { }
hgs
parents:
diff changeset
    74
    HsSnapRectangle(QRectF rect) : rectangle(rect), isLeftSnapableForAbove(true), isLeftSnapableForBelow(true),
hgs
parents:
diff changeset
    75
                                   isRightSnapableForAbove(true), isRightSnapableForBelow(true),
hgs
parents:
diff changeset
    76
                                   isTopSnapableForLeft(true), isTopSnapableForRight(true),
hgs
parents:
diff changeset
    77
                                   isBottomSnapableForLeft(true), isBottomSnapableForRight(true)
hgs
parents:
diff changeset
    78
    { }
hgs
parents:
diff changeset
    79
hgs
parents:
diff changeset
    80
    QRectF rectangle;
hgs
parents:
diff changeset
    81
    bool isLeftSnapableForAbove;
hgs
parents:
diff changeset
    82
    bool isLeftSnapableForBelow;
hgs
parents:
diff changeset
    83
    bool isRightSnapableForAbove;
hgs
parents:
diff changeset
    84
    bool isRightSnapableForBelow;
hgs
parents:
diff changeset
    85
    bool isTopSnapableForLeft;
hgs
parents:
diff changeset
    86
    bool isTopSnapableForRight;
hgs
parents:
diff changeset
    87
    bool isBottomSnapableForLeft;
hgs
parents:
diff changeset
    88
    bool isBottomSnapableForRight;
hgs
parents:
diff changeset
    89
};
hgs
parents:
diff changeset
    90
hgs
parents:
diff changeset
    91
class HSUTILS_EXPORT HsSnapToLines : public HsWidgetPositioningOnWidgetMove
hgs
parents:
diff changeset
    92
{
hgs
parents:
diff changeset
    93
public:
hgs
parents:
diff changeset
    94
    HsSnapToLines();
hgs
parents:
diff changeset
    95
hgs
parents:
diff changeset
    96
    void setConfiguration(const QVariantHash &configuration);
hgs
parents:
diff changeset
    97
hgs
parents:
diff changeset
    98
    void setPagePresentation(const QRectF &containerRect, 
hgs
parents:
diff changeset
    99
                             const QList<QRectF> &inactiveRects,
hgs
parents:
diff changeset
   100
                             const QRectF &activeRect);
hgs
parents:
diff changeset
   101
hgs
parents:
diff changeset
   102
    Result run(const QRectF &movingRect);
hgs
parents:
diff changeset
   103
private:
hgs
parents:
diff changeset
   104
hgs
parents:
diff changeset
   105
    void createSnappableRectangles(const QList<QRectF> &inactiveRects);
hgs
parents:
diff changeset
   106
    void checkInactiveRectLieAboveOrBelowOfMovingRect();
69
hgs
parents: 63
diff changeset
   107
    void checkInactiveRectVerticalEdgesInRange(qreal movingRectVerticalEdgePosition);
hgs
parents: 63
diff changeset
   108
    void checkInactiveRectBetterFitForHorizontalSnapping(qreal containerVerticalEdgeToInactiveRectVerticalEdge,
hgs
parents: 63
diff changeset
   109
                                                         qreal containerOtherVerticalEdgeToInactiveRectOtherVerticalEdge);
62
hgs
parents:
diff changeset
   110
    void compareLeftSideOfMovingRectForSnapping();
hgs
parents:
diff changeset
   111
    void compareRightSideOfMovingRectForSnapping();
hgs
parents:
diff changeset
   112
    void checkInactiveRectLieLeftOrRightOfMovingRect();
69
hgs
parents: 63
diff changeset
   113
    void checkInactiveRectHorizontalEdgesInRange(qreal movingRectHorizontalEdgePosition);
hgs
parents: 63
diff changeset
   114
    void checkInactiveRectBetterFitForVerticalSnapping(qreal containerHorizontalEdgeToInactiveRectHorizontalEdge,
hgs
parents: 63
diff changeset
   115
                                                       qreal containerOtherHorizontalEdgeToInactiveRectOtherHorizontalEdge);
62
hgs
parents:
diff changeset
   116
    void compareTopOfMovingRectForSnapping();
hgs
parents:
diff changeset
   117
    void compareBottomOfMovingRectForSnapping();
69
hgs
parents: 63
diff changeset
   118
    void createVerticalLine();
hgs
parents: 63
diff changeset
   119
    void createHorizontalLine();
62
hgs
parents:
diff changeset
   120
    void extendVerticalLine();
hgs
parents:
diff changeset
   121
    void extendHorizontalLine();
hgs
parents:
diff changeset
   122
    void checkInactiveRectPositionToVerticalLine();
hgs
parents:
diff changeset
   123
    void extendVerticalLineToIncludeInactiveRect();
hgs
parents:
diff changeset
   124
    void checkInactiveRectPositionToHorizontalLine();
hgs
parents:
diff changeset
   125
    void extendHorizontalLineToIncludeInactiveRect();
hgs
parents:
diff changeset
   126
hgs
parents:
diff changeset
   127
private: //data
hgs
parents:
diff changeset
   128
    QRectF mContainerRect;
hgs
parents:
diff changeset
   129
hgs
parents:
diff changeset
   130
    qreal mActiveRectWidth;
hgs
parents:
diff changeset
   131
    qreal mActiveRectHeight;
hgs
parents:
diff changeset
   132
hgs
parents:
diff changeset
   133
    QList<HsSnapRectangle> mInactiveSnapRects;
hgs
parents:
diff changeset
   134
hgs
parents:
diff changeset
   135
    QRectF mInactiveRectToCompare;
hgs
parents:
diff changeset
   136
    HsSnapRectangle mInactiveSnapRectToCompare;
hgs
parents:
diff changeset
   137
    QRectF mMovingRect;
69
hgs
parents: 63
diff changeset
   138
hgs
parents: 63
diff changeset
   139
    qreal mMinDistancePosition;
62
hgs
parents:
diff changeset
   140
    qreal mHorizontalSnapPosition;
hgs
parents:
diff changeset
   141
    qreal mVerticalSnapPosition;
hgs
parents:
diff changeset
   142
hgs
parents:
diff changeset
   143
    bool mHorizontalSnapFound;
hgs
parents:
diff changeset
   144
    QLineF mVerticalLine;
hgs
parents:
diff changeset
   145
hgs
parents:
diff changeset
   146
    bool mVerticalSnapFound;
hgs
parents:
diff changeset
   147
    QLineF mHorizontalLine;
hgs
parents:
diff changeset
   148
hgs
parents:
diff changeset
   149
    bool mRectLieAbove;
hgs
parents:
diff changeset
   150
    bool mLeftInRange;
hgs
parents:
diff changeset
   151
    bool mRightInRange;
69
hgs
parents: 63
diff changeset
   152
    bool mIsBetterFitHorizontalSnap;
hgs
parents: 63
diff changeset
   153
    qreal mDistanceVerticalEdges;
hgs
parents: 63
diff changeset
   154
    qreal mVerticalEdgeToLeftOfInactiveRect;
hgs
parents: 63
diff changeset
   155
    qreal mVerticalEdgeToRightOfInactiveRect;
62
hgs
parents:
diff changeset
   156
    qreal mMinVerticalEdgesDistance;
hgs
parents:
diff changeset
   157
    qreal mVerticalDistance;
hgs
parents:
diff changeset
   158
    qreal mVerticalDistanceFromSelectedRect;
hgs
parents:
diff changeset
   159
    qreal mContainerVerticalEdgeDistance;
hgs
parents:
diff changeset
   160
hgs
parents:
diff changeset
   161
    bool mRectLieLeft;
hgs
parents:
diff changeset
   162
    bool mTopInRange;
hgs
parents:
diff changeset
   163
    bool mBottomInRange;
69
hgs
parents: 63
diff changeset
   164
    bool mIsBetterFitVerticalSnap;
hgs
parents: 63
diff changeset
   165
    qreal mDistanceHorizontalEdges;
hgs
parents: 63
diff changeset
   166
    qreal mHorizontalEdgeToTopOfInactiveRect;
hgs
parents: 63
diff changeset
   167
    qreal mHorizontalEdgeToBottomOfInactiveRect;
62
hgs
parents:
diff changeset
   168
    qreal mMinHorizontalEdgesDistance;
hgs
parents:
diff changeset
   169
    qreal mHorizontalDistance;
hgs
parents:
diff changeset
   170
    qreal mHorizontalDistanceFromSelectedRect;
hgs
parents:
diff changeset
   171
    qreal mContainerHorizontalEdgeDistance;
hgs
parents:
diff changeset
   172
hgs
parents:
diff changeset
   173
    bool mSnapEnabled;
hgs
parents:
diff changeset
   174
    qreal mSnapForce;
hgs
parents:
diff changeset
   175
    qreal mSnapGap;
hgs
parents:
diff changeset
   176
hgs
parents:
diff changeset
   177
    bool mRectVerticalEdgeLiesInLineWithVerticalLine;
hgs
parents:
diff changeset
   178
    bool mRectLieAboveVerticalLine;
hgs
parents:
diff changeset
   179
    bool mRectLieBelowVerticalLine;
hgs
parents:
diff changeset
   180
hgs
parents:
diff changeset
   181
    bool mRectHorizontalEdgeLiesInLineWithHorizontalLine;
hgs
parents:
diff changeset
   182
    bool mRectLieLeftOfHorizontalLine;
hgs
parents:
diff changeset
   183
    bool mRectLiesRightOfHorizontalLine;
hgs
parents:
diff changeset
   184
hgs
parents:
diff changeset
   185
    HOMESCREEN_TEST_FRIEND_CLASS(t_hsUtils)
hgs
parents:
diff changeset
   186
};
hgs
parents:
diff changeset
   187
hgs
parents:
diff changeset
   188
#endif // HSWIDGETPOSITIONINGONWIDGETMOVE_H