Qtitan Components for Qt - Quickstart Guide

Qtitan Components for Qt - Quickstart Guide

Topic describes how to include the Qtitan components for the regular Qt App. The steps described in this topic are relevant to any Qtitan component - QtitanRibbon, QtitanDataGrid, QtitanNavigationDesignUI, QtitanChart, QtitanDocking.

Prerequisites

To use Qtitan Component, you'll need:

Step 1: Install Qtitan Component

  • Goto to the page https://www.devmachines.com/download-for-qt.html
  • Download the installer for platform you use
  • Install it following the recommendations of the installer wizard
  • After install process you'll have headers in the <QTITAN_INSTALL_PATH>/include folder and shared libraries in the <QTITAN_INSTALL_PATH>/bin folder.

Step 2: Configure your app project file (*.pro)

Add the Qtitan Component headers and libraries to your app. To do that include special component project file (*.pri) to your application project file (*.pro):

include(<QTITAN_INSTALL_PATH>/src/shared/qtitan.pri) // To include all the qtitan components installed at <QTITAN_INSTALL_PATH>

or add a specific component as follows:

include(<QTITAN_INSTALL_PATH>/src/shared/qtitanribbon.pri) // QtitanRibbon
include(<QTITAN_INSTALL_PATH>/src/shared/qtitandatagrid.pri) // QtitanDataGrid
include(<QTITAN_INSTALL_PATH>/src/shared/qtitannavigation.pri) // QtitanNavigationDesignUI
include(<QTITAN_INSTALL_PATH>/src/shared/qtitanchart.pri) // QtitanChart
include(<QTITAN_INSTALL_PATH>/src/shared/qtitandocking.pri) // QtitanDocking

If Qtitan component was built staticaly add the CONFIG+=qtitan_staticlib before include line:

CONFIG+=qtitan_staticlib
include(<QTITAN_INSTALL_PATH>/src/shared/qtitan.pri)

Step 3: Reconfigure your application

Run qmake.exe from the root of your App. If you need generate Visual Studio project file add "-tp vc" keys to the qmake.exe

qmake.exe -tp vc -r // Will generate Visual Studio project and/or solution file.

Building the Qtitan Component from sources

Topic describes how to build the Qtitan components sources to your environment from the command line.

Windows Visual Studio

Open the bat shell. "Windows logo key" + R, cmd.exe
Set current directory to the <QTITAN_INSTALL_PATH>. C:/>dir <QTITAN_INSTALL_PATH>
vcvars32.bat
qmake.exe -r -platform win32-msvc
nmake all

Windows Visual Studio (static linking)

Open the bat shell. "Windows logo key" + R, cmd.exe
Set current directory to the <QTITAN_INSTALL_PATH>. C:/>dir <QTITAN_INSTALL_PATH>
vcvars32.bat
qmake.exe -staticlib -r -platform win32-msvc
nmake all

Windows Qt-Creator (mingw)

Open the bat shell. "Windows logo key" + R, cmd.exe
Set current directory to the <QTITAN_INSTALL_PATH>. C:/>dir <QTITAN_INSTALL_PATH>
vcvars32.bat
qmake.exe -r -platform win32-g++
mingw32-make all

Windows Qt-Creator (mingw, static linking)

Open the bat shell. "Windows logo key" + R, cmd.exe
Set current directory to the <QTITAN_INSTALL_PATH>. C:/>dir <QTITAN_INSTALL_PATH>
vcvars32.bat
qmake.exe -staticlib -r -platform win32-g++
mingw32-make all

Extra flags that can be used to build sources

Static linking

To use static linking add the -staticlib or CONFIG+=qtitan_staticlib key to the qmake.exe.

qmake.exe -staticlib -r -platform <platform>
or
qmake.exe CONFIG+=qtitan_staticlib -r -platform <platform>

Ignore private headers

Qtitan Components uses Qt private headers to implement a set of nice features. You can ignore private headers to add switch-key to the command line. In such case some features will be lost. Use this flag only if you understand what you are doing.

If you wish prevent use of the private headers then add the CONFIG+=qtitan_no_private key to the qmake.exe.

qmake.exe CONFIG+=qtitan_no_private -r -platform <platform>