diff options
Diffstat (limited to 'examples/quickcontrols/filesystemexplorer/doc/filesystemexplorer.rst')
-rw-r--r-- | examples/quickcontrols/filesystemexplorer/doc/filesystemexplorer.rst | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/examples/quickcontrols/filesystemexplorer/doc/filesystemexplorer.rst b/examples/quickcontrols/filesystemexplorer/doc/filesystemexplorer.rst new file mode 100644 index 000000000..b46cbec79 --- /dev/null +++ b/examples/quickcontrols/filesystemexplorer/doc/filesystemexplorer.rst @@ -0,0 +1,52 @@ +.. _filesystemexplorer_example: + +Qt Quick Controls - Filesystem Explorer +======================================= + +This example demonstrates how to create a **modern-looking** filesystem +explorer with a dark-themed user interface that has a uniform look +across all operating systems. Custom Qt Quick Controls have been +implemented to provide a clean and intuitive UI for opening and +navigating text-files from the filesystem. + +Frameless Window +---------------- + +To maximize the available space, we use a **frameless window**. The basic +functionality, such as minimizing, maximizing, and closing the window, +has been moved to a customized MenuBar called ``MyMenuBar``. Users can +drag the window thanks to the ``WindowDragHandler`` added to the Sidebar +and MenuBar. + +Customization +------------- + +Combining **customized animations** and **colors** with QtQuick Controls +allows us to easily create custom user interfaces. This example +showcases the potential of QtQuick Controls for creating aesthetically +pleasing UIs. + +.. + + With the knowledge gained from this example, developers can apply + similar techniques to create **their own** customized UIs using PySide's + QtQuick Controls. + + + +.. image:: filesystemexplorer.webp + :target: filesystemexplorer.webp + :alt: QtQuickControls Filesystem Explorer Screenshot + +References +---------- + +If you're interested in the C++ version of this example, you can find it +`here <https://doc-snapshots.qt.io/qt6-dev/qtquickcontrols-filesystemexplorer-example.html>`_. + +Additionally, there is a detailed +`tutorial <https://doc.qt.io/qtforpython-6/tutorials/extendedexplorer/extendedexplorer.html>`_ +available that provides step-by-step instructions on how to extend this example +with additional features. This tutorial can be helpful if you want to explore +and learn more about building upon the existing functionality of the filesystem +explorer. |