summaryrefslogtreecommitdiff
path: root/indra/llui/llscrollcontainer.h
blob: 1295406a3d02182f42fac06aa45c88e16d1fd120 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
/**
 * @file llscrollcontainer.h
 * @brief LLScrollContainer class header file.
 *
 * $LicenseInfo:firstyear=2001&license=viewerlgpl$
 * Second Life Viewer Source Code
 * Copyright (C) 2010, Linden Research, Inc.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation;
 * version 2.1 of the License only.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 *
 * Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA
 * $/LicenseInfo$
 */

#ifndef LL_LLSCROLLCONTAINER_H
#define LL_LLSCROLLCONTAINER_H

#include "lluictrl.h"
#ifndef LL_V4COLOR_H
#include "v4color.h"
#endif
#include "llcoord.h"
#include "llscrollbar.h"


class LLViewBorder;
class LLUICtrlFactory;

/*****************************************************************************
 *
 * A decorator view class meant to encapsulate a clipped region which is
 * scrollable. It automatically takes care of pixel perfect scrolling
 * and cliipping, as well as turning the scrollbars on or off based on
 * the width and height of the view you're scrolling.
 *
 *****************************************************************************/

struct ScrollContainerRegistry : public LLChildRegistry<ScrollContainerRegistry>
{
    LLSINGLETON_EMPTY_CTOR(ScrollContainerRegistry);
};

class LLScrollContainer : public LLUICtrl
{
public:
    // Note: vertical comes before horizontal because vertical
    // scrollbars have priority for mouse and keyboard events.

    struct Params : public LLInitParam::Block<Params, LLUICtrl::Params>
    {
        Optional<bool>      is_opaque,
                            reserve_scroll_corner,
                            border_visible,
                            hide_scrollbar,
                            ignore_arrow_keys;
        Optional<F32>       min_auto_scroll_rate,
                            max_auto_scroll_rate;
        Optional<U32>       max_auto_scroll_zone;
        Optional<LLUIColor> bg_color;
        Optional<LLScrollbar::callback_t> scroll_callback;
        Optional<S32>       size;

        Params();
    };

    // my valid children are stored in this registry
    typedef ScrollContainerRegistry child_registry_t;

protected:
    LLScrollContainer(const Params&);
    friend class LLUICtrlFactory;
public:
    virtual ~LLScrollContainer( void );

    virtual void    setValue(const LLSD& value) { mInnerRect.setValue(value); }

    void            setBorderVisible( BOOL b );

    void            scrollToShowRect( const LLRect& rect, const LLRect& constraint);
    void            scrollToShowRect( const LLRect& rect) { scrollToShowRect(rect, LLRect(0, mInnerRect.getHeight(), mInnerRect.getWidth(), 0)); }

    void            setReserveScrollCorner( BOOL b ) { mReserveScrollCorner = b; }
    LLRect          getVisibleContentRect();
    LLRect          getContentWindowRect();
    virtual const LLRect    getScrolledViewRect() const { return mScrolledView ? mScrolledView->getRect() : LLRect::null; }
    void            pageUp(S32 overlap = 0);
    void            pageDown(S32 overlap = 0);
    void            goToTop();
    void            goToBottom();
    bool            isAtTop() const { return mScrollbar[VERTICAL]->isAtBeginning(); }
    bool            isAtBottom() const { return mScrollbar[VERTICAL]->isAtEnd(); }
    S32             getDocPosVertical() const { return mScrollbar[VERTICAL]->getDocPos(); }
    S32             getDocPosHorizontal() const { return mScrollbar[HORIZONTAL]->getDocPos(); }
    S32             getBorderWidth() const;

    // LLView functionality
    virtual void    reshape(S32 width, S32 height, BOOL called_from_parent = TRUE);
    virtual BOOL    handleKeyHere(KEY key, MASK mask);
    virtual BOOL    handleUnicodeCharHere(llwchar uni_char);
    virtual BOOL    handleScrollWheel( S32 x, S32 y, S32 clicks );
    virtual BOOL    handleScrollHWheel( S32 x, S32 y, S32 clicks );
    virtual BOOL    handleDragAndDrop(S32 x, S32 y, MASK mask, BOOL drop,
                                   EDragAndDropType cargo_type,
                                   void* cargo_data,
                                   EAcceptance* accept,
                                   std::string& tooltip_msg);

    virtual void    draw();
    virtual bool    addChild(LLView* view, S32 tab_group = 0);

    bool canAutoScroll(S32 x, S32 y);
    bool autoScroll(S32 x, S32 y);

    S32 getSize() const { return mSize; }
    void setSize(S32 thickness);

protected:
    LLView*     mScrolledView;

private:
    // internal scrollbar handlers
    virtual void scrollHorizontal( S32 new_pos );
    virtual void scrollVertical( S32 new_pos );
    void updateScroll();
    bool autoScroll(S32 x, S32 y, bool do_scroll);
    void calcVisibleSize( S32 *visible_width, S32 *visible_height, BOOL* show_h_scrollbar, BOOL* show_v_scrollbar ) const;

    LLScrollbar* mScrollbar[ORIENTATION_COUNT];
    S32         mSize;
    BOOL        mIsOpaque;
    LLUIColor   mBackgroundColor;
    LLRect      mInnerRect;
    LLViewBorder* mBorder;
    BOOL        mReserveScrollCorner;
    BOOL        mAutoScrolling;
    F32         mAutoScrollRate;
    F32         mMinAutoScrollRate;
    F32         mMaxAutoScrollRate;
    U32         mMaxAutoScrollZone;
    bool        mHideScrollbar;
    bool        mIgnoreArrowKeys;
};


#endif // LL_LLSCROLLCONTAINER_H