@@ -47,16 +47,16 | |||||
47 |
|
47 | |||
48 | \snippet doc_src_qtcharts.cpp 0 |
|
48 | \snippet doc_src_qtcharts.cpp 0 | |
49 |
|
49 | |||
50 | \note If you are only using a few classes from this module, we recommend including only those |
|
50 | \note Since Qt Creator 3.0, projects created with Qt Quick Application | |
51 | specific classes instead of the whole module. |
|
51 | wizard based on the Qt Quick 2 template uses QGuiApplication by default. | |
|
52 | All such QGuiApplication instances in the project must be replaced with | |||
|
53 | QApplication as the module depends on Qt's \l{Graphics View Framework} | |||
|
54 | for rendering. | |||
52 |
|
55 | |||
53 | To link against the Qt Charts module, add this line to your \c qmake project file: |
|
56 | To link against the Qt Charts module, add this line to your \c qmake project file: | |
54 |
|
57 | |||
55 | \snippet doc_src_qtcharts.pro 0 |
|
58 | \snippet doc_src_qtcharts.pro 0 | |
56 |
|
59 | |||
57 | See the \l{Qt Charts Getting Started}{Getting started} page for further information on |
|
|||
58 | how to use Qt Charts in your application. |
|
|||
59 |
|
||||
60 | \section1 References |
|
60 | \section1 References | |
61 | \list |
|
61 | \list | |
62 | \li \l{Qt Charts C++ Classes} |
|
62 | \li \l{Qt Charts C++ Classes} |
@@ -86,124 +86,3 | |||||
86 |
|
86 | |||
87 | \annotatedlist qtcharts_examples |
|
87 | \annotatedlist qtcharts_examples | |
88 | */ |
|
88 | */ | |
89 |
|
||||
90 | /*! |
|
|||
91 | \group qtcharts_getting_started |
|
|||
92 | \title Qt Charts Getting Started |
|
|||
93 |
|
||||
94 | \section1 Installing the Qt Charts module |
|
|||
95 |
|
||||
96 | Use the \c {Package Manager} in \c {Maintenance Tool} or the \c {Online installer} to install |
|
|||
97 | the Qt Charts module. The module can be found under \c {Qt Enterprise Add-Ons} in the |
|
|||
98 | package manager. |
|
|||
99 |
|
||||
100 | After installation Qt Charts documentation and examples are available in Qt Creator. |
|
|||
101 | Examples can be found on the examples page of Qt Creator by selecting the Qt Charts |
|
|||
102 | component from the drop-down menu. |
|
|||
103 |
|
||||
104 | The source code is installed into the QtCharts folder under EnterpriseAddOns. |
|
|||
105 |
|
||||
106 | \section1 Building Qt Charts |
|
|||
107 |
|
||||
108 | To build the Qt Charts module from source code yourself, set up a command prompt with |
|
|||
109 | an environment for building Qt applications, navigate to the directory containing |
|
|||
110 | \c {qtcharts.pro}, and configure the project with qmake: |
|
|||
111 | \code |
|
|||
112 | qmake |
|
|||
113 | \endcode |
|
|||
114 |
|
||||
115 | qmake should be run from the folder where Qt has been installed. For example, |
|
|||
116 | if Qt is built with -prefix /opt/MyXCompiledQt, then qmake should be run |
|
|||
117 | from /opt/MyXCompiledQt/bin/qmake. |
|
|||
118 |
|
||||
119 | After running qmake, build the project with make: |
|
|||
120 | \table |
|
|||
121 | \header |
|
|||
122 | \li OS \li Make command |
|
|||
123 | \row |
|
|||
124 | \li Linux \li make |
|
|||
125 | \row |
|
|||
126 | \li Windows (MinGw) \li mingw32-make |
|
|||
127 | \row |
|
|||
128 | \li Windows (MSVC) \li nmake |
|
|||
129 | \row |
|
|||
130 | \li OSX \li make |
|
|||
131 | \endtable |
|
|||
132 |
|
||||
133 | The above generates the default makefiles for your configuration, which is typically |
|
|||
134 | the release build if you are using precompiled binary Qt distribution. To build both debug |
|
|||
135 | and release, or one specifically, use one of the following qmake lines instead. |
|
|||
136 |
|
||||
137 | For debug builds: |
|
|||
138 | \code |
|
|||
139 | qmake CONFIG+=debug |
|
|||
140 | make |
|
|||
141 | \endcode |
|
|||
142 | or |
|
|||
143 | \code |
|
|||
144 | qmake CONFIG+=debug_and_release |
|
|||
145 | make debug |
|
|||
146 | \endcode |
|
|||
147 |
|
||||
148 | For release builds: |
|
|||
149 | \code |
|
|||
150 | qmake CONFIG+=release |
|
|||
151 | make |
|
|||
152 | \endcode |
|
|||
153 | or |
|
|||
154 | \code |
|
|||
155 | qmake CONFIG+=debug_and_release |
|
|||
156 | make release |
|
|||
157 | \endcode |
|
|||
158 |
|
||||
159 | For both builds (Windows/OS X only): |
|
|||
160 | \code |
|
|||
161 | qmake CONFIG+="debug_and_release build_all" |
|
|||
162 | make |
|
|||
163 | \endcode |
|
|||
164 |
|
||||
165 | After building, install the module to your Qt directory: |
|
|||
166 | \code |
|
|||
167 | make install |
|
|||
168 | \endcode |
|
|||
169 |
|
||||
170 | If you want to uninstall the module: |
|
|||
171 | \code |
|
|||
172 | make uninstall |
|
|||
173 | \endcode |
|
|||
174 |
|
||||
175 | To build a statically linked version of the Qt Charts module, give the following commands: |
|
|||
176 |
|
||||
177 | \snippet doc_src_qtcharts.cpp 1 |
|
|||
178 |
|
||||
179 | \section1 Running examples |
|
|||
180 |
|
||||
181 | Qt Charts examples are found under the \c examples subdirectory. To build and run a single |
|
|||
182 | example, in this case qmlpolarchart, navigate to the example directory and enter the following |
|
|||
183 | commands: |
|
|||
184 |
|
||||
185 | \snippet doc_src_qtcharts.cpp 2 |
|
|||
186 |
|
||||
187 | \note On some platforms, such as Windows, the executable can be generated under debug or |
|
|||
188 | release folders, depending on your build. |
|
|||
189 |
|
||||
190 | \section1 Creating a simple application |
|
|||
191 |
|
||||
192 | To create a simple application, start by creating a new Qt Gui Application project in Qt |
|
|||
193 | Creator and add this line to the \c .pro file of the project: |
|
|||
194 |
|
||||
195 | \snippet doc_src_qtcharts.pro 0 |
|
|||
196 |
|
||||
197 | In the \c main.cpp file, include the module headers and declare namespace usage: |
|
|||
198 |
|
||||
199 | \snippet doc_src_qtcharts.cpp 0 |
|
|||
200 |
|
||||
201 | \note Since Qt Creator 3.0 the project created with Qt Quick Application wizard based on |
|
|||
202 | Qt Quick 2 template uses QGuiApplication by default. As Qt Charts utilizes Qt Graphics View |
|
|||
203 | Framework for drawing, QApplication must be used. The project created with the wizard is |
|
|||
204 | usable with Qt Charts after the QGuiApplication is replaced with QApplication. |
|
|||
205 |
|
||||
206 | For further code examples, see one of the Qt Charts examples: |
|
|||
207 |
|
||||
208 | \annotatedlist qtcharts_examples |
|
|||
209 | */ |
|
General Comments 0
You need to be logged in to leave comments.
Login now