Widget Set

Overview Qtilities provides a number of easy to use and useful widgets to use in Qt applications. This page provides an overview of those widgets. Table of contents: Search Box Widget Property Editor Interface Logging Widgets Code Editor Widget Configuration Widget (Application Settings) Qtilities Main Window Architecture

First Steps Getting Started The Basics Examples and Plugins Overviews Action Management Building Trees Debugging Applications Extension System Factories Logging Modules Object Management Observers Observer Widgets Project Management Tasking Widget Set

Search Box Widget

The Qtilities::CoreGui::SearchBoxWidget class provides a ready to use, customizable search box widget. Below is a screenshot of the search box widget in search and replace mode with all buttons enabled:

Search Box Widget

Property Editor Interface

The Qtilities::CoreGui::ObjectPropertyBrowser class provides an easy to use interface to the Qt Property Browser Framework. Through the interface you can view the Q_PROPERTY properties of any object and it is possible to filter which subclasses of the object can be set. See the class documentation for more information.

Below is a screenshot of the property editor widget in the tree browser mode. For a list of the available modes, see the Qtilities::CoreGui::ObjectPropertyBrowser::BrowserType enumeration.

Property Browser (Tree Browser Mode)

Logging Widgets

When using the Qtilities logger you can use the Qtilities::CoreGui::LoggerGui class to obtain logging widgets as well as a configuration widget for the logger. See the class documentation for more information.

Below is an example dock log widget. Note the ready to use search box widget and actions.

Log Dock Widget

String List Widget

The StringListWidget class is a simple widget which can be used to display a QStringList. You can give your string list a type using setStringType() and the list of strings to be displayed is set using setStringList().

The widget is a QMainWindow with a toolbar at the top containing actions to remove and add strings. To customize the operation of the widget the string list model can be accessed using stringListModel() and the view can be accessed through listView().

Below is an image of the string list widget with the string type set to "Architecture".

The String List Widget

Code Editor Widget

The Qtilities::CoreGui::CodeEditorWidget class is a code editor which can be embedded in applications where the user must be able to edit a file. The goal of the code editor widget is not to provide a complete code editor solution, but rather to provide a widget to edit files (code or text) where full code editing capabilities (code folding etc.) are not required.

A screenshot of the code editor widget is shown in the Qtilities Main Window Architecture section below.

Configuration Widget (Application Settings)

The Qtilities::CoreGui::ConfigurationWidget class provides a ready to use application settings widget. See the class documentation for more information.

Below is an example configuration widget taken from the ObjectManagementExample in the QtilitiesExamples project:

Example: Project Configuration Widget

Qtilities Main Window Architecture

Qtilities provides a main window architecture which allows you to create complex main windows easily. The Qtilities::CoreGui::QtilitiesMainWindow class is the main class. It supports modes that can be added to it, where modes are classes implementing the Qtilities::CoreGui::Interfaces::IMode interface. Each mode provide a widget which and an icon identifying the mode. Modes are listed in a top to bottom list view on the left hand of the main window and when a mode is clicked, its widget is set as the active widget in the main window.

The Qtilities::CoreGui::DynamicSideWidgetViewer class is able to display widgets implementing the Qtilities::CoreGui::Interfaces::ISideViewerWidget interface. Each side viewer is wrapped using the Qtilities::CoreGui::DynamicSideWidgetWrapper class which provides actions to remove the side viewer or to duplicate the side viewer. The side viewer wrapper also allows side viewer widgets to add custom actions to the wrapper widget. The Qtilities::CoreGui::SideViewerWidgetFactory class can be used to simplify development of side viewer widgets.

Below is an example of the main window architecture in action. This screenshot was taken form the MainWindowExample in the QtilitiesExamples project.

Example Of Main Window Architecture