TripleWhy

Longscroll-Qt

Longscroll-qt is a C++ library to create very long, fast and responsive scrollable widgets in Qt.

The longscroll widget can visualize a large list of items, similar to a QAbstractItemView. The main differences are that longscroll-qt is responsive, has much more flexible layout options and uses real widgets to display items. This allows easy user interaction and simple customization as you can for example use the Qt designer to create an item widget. longscroll-qt also offers a fully customizable navigator widget which is shown between two rows, creating a complete google-images-like view.

The library was tested and works with millions of image items.

Longscroll-Qt API Docs

Online documentation for the current release can be found at https://triplewhy.gitlab.io/longscroll-qt/doc/.

You can also download a html or qhp version to integrate into Qt Assistant and Qt Creator.

Longscroll-Qt Examples

The library comes with two examples. To understand the behavior best, keep resizing the window.

• examples/simple sets up a simple program using only a few lines of code to get you up running fast.
• examples/demo demonstrates the power of longscroll-qt by providing a gui that lets you dynamically change nearly every setting to see what it does.

The documentation of longscroll::ContentWidget can give a good overview of what longscroll-qt can do, as most of its functionality is provided by that class.

Longscroll-Qt Stylesheets

Longscroll-qt widgets can be styled like any other widget. Since longscroll-qt uses a namespace, longscroll by default, stylesheets have to specify it too. For example:

longscroll--ContentWidget {
    background: blue;
}
longscroll--ImageWidget {
    background: yellow;
}

 

Longscroll-Qt Requirements

Longscroll-qt needs Qt 5 and a C++11 compatible compiler. It can run on all systems that have Qt, including Linux, Windows and MacOS. Building the documentation additionally requires doxygen and graphviz.

On Ubuntu all requirements (including docs) can be installed with the following packages:

# apt-get install build-essential clang qtbase5-dev qtbase5-doc-html qttools5-dev-tools doxygen graphviz libqt5sql5-sqlite

 

Longscroll-Qt Screenshots

This library can best be experienced by running and resizing the demo program. The following are some layout possibilities from the documentation:

And here are some real screenshots:

Longscroll-Qt License

Longscroll-qt is licensed under AGPL v3. (Contact TripleWhy for a commercial license.)