NDEVR
API Documentation
TouchScrollManager.h
1/*--------------------------------------------------------------------------------------------
2Copyright (c) 2019, NDEVR LLC
3tyler.parke@ndevr.org
4 __ __ ____ _____ __ __ _______
5 | \ | | | __ \ | ___|\ \ / / | __ \
6 | \ | | | | \ \ | |___ \ \ / / | |__) |
7 | . \| | | |__/ / | |___ \ V / | _ /
8 | |\ |_|_____/__|_____|___\_/____| | \ \
9 |__| \__________________________________| \__\
10
11Subject to the terms of the Enterprise+ Agreement, NDEVR hereby grants
12Licensee a limited, non-exclusive, non-transferable, royalty-free license
13(without the right to sublicense) to use the API solely for the purpose of
14Licensee's internal development efforts to develop applications for which
15the API was provided.
16
17The above copyright notice and this permission notice shall be included in all
18copies or substantial portions of the Software.
19
20THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
21INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
22PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
23FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
24OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
25DEALINGS IN THE SOFTWARE.
26
27Library: Widgets
28File: TouchScrollManager
29Included in API: True
30Author(s): Tyler Parke
31 *-----------------------------------------------------------------------------------------**/
32#pragma once
33#include "DLLInfo.h"
34#include <QObject>
35#include <QScroller>
36#include <QAbstractItemView>
37namespace NDEVR
38{
42 class NDEVR_WIDGETS_API TouchScrollManager : public QObject
43 {
44 Q_OBJECT
45 public:
48 static void Run(QWidget* widget);
49 protected:
52 TouchScrollManager(QWidget* widget);
53 protected:
55 void setup();
58 void setTouchScroll(bool setup_for_touch);
59 protected slots:
62 void onQScrollerStateChangedSlot(QScroller::State newState);
63 protected:
64 QAbstractItemView::SelectionMode m_actual_selection_mode = QAbstractItemView::NoSelection;
65 Qt::FocusPolicy m_actual_focus_policy = Qt::NoFocus;
66 bool m_actual_auto_scroll = false;
68 QWidget* m_widget;
69 QWidget* m_target;
70 };
71}
72
QTimer * m_scroll_timer
Timer used to delay restoring selection after scrolling.
bool m_actual_auto_scroll
The original auto-scroll setting before touch scroll override.
void onQScrollerStateChangedSlot(QScroller::State newState)
Slot invoked when the QScroller state changes, used to manage selection during scrolling.
Qt::FocusPolicy m_actual_focus_policy
The original focus policy before touch scroll override.
QWidget * m_widget
The widget being managed for touch scrolling.
static void Run(QWidget *widget)
Enables touch-scroll behavior on the given widget.
void setup()
Configures touch scroll settings based on the current widget mode.
TouchScrollManager(QWidget *widget)
Constructs a TouchScrollManager for the given widget.
QWidget * m_target
The target viewport widget that receives scroll events.
QAbstractItemView::SelectionMode m_actual_selection_mode
The original selection mode before touch scroll override.
void setTouchScroll(bool setup_for_touch)
Enables or disables touch-based scrolling on the managed widget.
The primary namespace for the NDEVR SDK.