diff options
author | Tomi Korpipää <tomi.korpipaa@digia.com> | 2013-10-09 08:55:09 +0300 |
---|---|---|
committer | Tomi Korpipää <tomi.korpipaa@digia.com> | 2013-10-09 09:13:06 +0300 |
commit | 5f02a038891db0cfd6a9fa08d7576141485e5d71 (patch) | |
tree | 383c8173283a043d0815f85d1745a771554fbc2d /examples/itemmodel | |
parent | 36e42a1988e5c88c76c06415a1aaa19209a6e720 (diff) |
Renamed examples
Task-number: QTRD-2418
Change-Id: Ic0cae9a8caebcbd0f1cf57eb98fb7d543d7d7289
Change-Id: Ic0cae9a8caebcbd0f1cf57eb98fb7d543d7d7289
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@digia.com>
Diffstat (limited to 'examples/itemmodel')
-rw-r--r-- | examples/itemmodel/doc/images/itemmodel-example-2.png | bin | 0 -> 198263 bytes | |||
-rw-r--r-- | examples/itemmodel/doc/images/itemmodel-example.png | bin | 0 -> 135559 bytes | |||
-rw-r--r-- | examples/itemmodel/doc/src/itemmodel.qdoc | 182 | ||||
-rw-r--r-- | examples/itemmodel/itemmodel.pro | 12 | ||||
-rw-r--r-- | examples/itemmodel/main.cpp | 287 |
5 files changed, 481 insertions, 0 deletions
diff --git a/examples/itemmodel/doc/images/itemmodel-example-2.png b/examples/itemmodel/doc/images/itemmodel-example-2.png Binary files differnew file mode 100644 index 00000000..2083a8e0 --- /dev/null +++ b/examples/itemmodel/doc/images/itemmodel-example-2.png diff --git a/examples/itemmodel/doc/images/itemmodel-example.png b/examples/itemmodel/doc/images/itemmodel-example.png Binary files differnew file mode 100644 index 00000000..a87f4bdf --- /dev/null +++ b/examples/itemmodel/doc/images/itemmodel-example.png diff --git a/examples/itemmodel/doc/src/itemmodel.qdoc b/examples/itemmodel/doc/src/itemmodel.qdoc new file mode 100644 index 00000000..f014bfea --- /dev/null +++ b/examples/itemmodel/doc/src/itemmodel.qdoc @@ -0,0 +1,182 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVisualization module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +/*! + \example itemmodel + \title Item Model Example + \ingroup qtdatavisualization_examples + \brief Using an item model as data source for Q3DBars. + + The item model example shows how to make a simple 3D bar graph using Q3DBars and how to modify + the data being drawn at run-time. The example shows how to: + + \list + \li How to create an application with Q3DBars and widgets + \li How to use QItemModelBarDataMapping and QItemModelBarDataProxy to set data to the graph + \li How to use a table widget to modify the data in the graph + \endlist + + \image itemmodel-example-2.png + + \section1 Creating the application + + First, in main.cpp, we create a QApplication, instantiate Q3DBars and a window container for it: + + \snippet ../examples/itemmodel/main.cpp 0 + + The call to QWidget::createWindowContainer is required, as all data visualization types + (Q3DBars, Q3DScatter, Q3DSurface) inherit QWindow. Any class inheriting QWindow cannot be used + as a widget any other way. + + Then we'll create a layout and add the graph and the table widget into it: + + \snippet ../examples/itemmodel/main.cpp 1 + + The table widget is going to be used to display the numerical data being inserted into the + graph, and to modify it (See \l {Adding data to the graph} and \l {Interacting with the data}). + + We need to instantiate QItemModelBarDataMapping and QItemModelBarDataProxy and give them to the + graph: + + \snippet ../examples/itemmodel/main.cpp 2 + + Here we tell the mapping object to directly map model's rows and columns into proxy's rows and + columns instead of defining row and column roles to map for them. Then we give the model from + the table widget and the mapping object to the proxy. Finally we set the proxy as the active + data proxy for the graph. + + Next, let's create another class to handle the data addition and other interaction with the + graph. Let's call it GraphDataGenerator (See \l {Setting up the graph} and + \l {Adding data to the graph} for details) and connect some signals between Q3DBars, + GraphDataGenerator and QTableWidget (See \l {Interacting with the data} for a closer look): + + \snippet ../examples/itemmodel/main.cpp 3 + + The application main is done and we can show the graph and start the event loop: + + \snippet ../examples/itemmodel/main.cpp 4 + + \section1 Setting up the graph + + Let's set up the visual attributes for the graph in the constructor of GraphDataGenerator: + + \snippet ../examples/itemmodel/main.cpp 5 + \snippet ../examples/itemmodel/main.cpp 6 + \snippet ../examples/itemmodel/main.cpp 7 + + First we set bar thickness ratio to 1.0, which means bars will be as wide as they are deep. 1.0 + is also the default value, so the line is basically unnecessary. It's left there so you could + easily try how changing it affects the graph. The second line sets bar spacings to 0.2, which + means there will be a gap of 20% of the bar's thickness between the bars in both directions. + + Then, we set the bar type to flat pyramids, overriding the default bar type. + We want to be able to select rows of data for a closer inspection, so we set the selection mode + to slice row. This means that whenever we select a bar in the graph, the whole row will be + displayed separately. + + Next line sets the font to \c Impact. If your system doesn't have it, it will be replaced by + system default. + + And finally, we set theme to \c Digia and camera position to \c {Preset Front}. Now the initial + graph settings are done. + + \note You do not need to set any of these in case you're happy with the defaults. You can + easily try them by commenting out the contents of the constructor. + + \section1 Adding data to the graph + + We created the data generator in the application main and gave it the graph and the table + widget as parameters: + + \code GraphDataGenerator generator(graph, tableWidget); \endcode + + We added a separate start method to the generator, so that it wouldn't start doing anything + until everything else is set up. We then called the method when starting the application: + + \code generator.start(); \endcode + + Let's have a look at the contents of the \c start() method: + + \snippet ../examples/itemmodel/main.cpp 8 + + The main thing \c start() does is set up the data model. It also activates a timer for getting + the accurate dimensions of the table widget after it's been filled with data. The reason we + do this is that the widget doesn't know its final visual domensions until all the data has been + inserted to it and it has been shown. The whole data timer implementation is not vital for the + application, so we won't take a closer look at it. It's just there to make the table look better. + + In \c setupModel() we first introduce the row and column labels, and the actual data: + + \snippet ../examples/itemmodel/main.cpp 9 + + Then we set up the axes: + + \snippet ../examples/itemmodel/main.cpp 10 + + The other lines there are pretty self-explanatory except for the one with the segment count. + We're setting it to five as we want the value axis (the Y-axis) to show more values than just + the lowest and the highest. + + Next we will set up the table widget: + + \snippet ../examples/itemmodel/main.cpp 11 + + After that all that's left is adding the data to the table widget: + + \snippet ../examples/itemmodel/main.cpp 12 + + Now we have a bar graph and a table widget, both displaying the same data. + + You're probably wondering how the data can be displayed in the graph, as the only thing we did + was add it to the table widget? That's because of what we did earlier, in the application main: + + \snippet ../examples/itemmodel/main.cpp 2 + + We created QItemModelBarDataMapping and QItemModelBarDataProxy instances, and gave the proxy + the model of the table widget and the model mapping we just created. Then we set the proxy as + the active proxy for the graph. The proxy maps the rows and the columns in the model of the table + widget into rows and columns for itself using the model mapping, and the graph gets the data + to be displayed from its active proxy. + + \section1 Interacting with the data + + We made a couple of signal connections in the application main earlier: + + \snippet ../examples/itemmodel/main.cpp 3 + + Now we'll find out what these were for. + + The first one connects a signal from Q3DBars to the GraphDataGenerator. Signal + Q3DBars::selectedBarPosChanged() is emitted when a bar is selected from the graph. We connect + that to a method in the data generator that selects the same data item in the table widget: + + \snippet ../examples/itemmodel/main.cpp 13 + + The second connection does the opposite; it connects a signal from the table widget to a + method in the data generator. The method then selects the corresponding bar in the graph: + + \snippet ../examples/itemmodel/main.cpp 14 + + You can even select an item in the widget and change the value of it, and the new value is + updated to the graph. This is handled again by the active proxy with mapping between the data + in the table widget and itself. + + \image itemmodel-example.png + + \section1 Example contents +*/ diff --git a/examples/itemmodel/itemmodel.pro b/examples/itemmodel/itemmodel.pro new file mode 100644 index 00000000..f319f690 --- /dev/null +++ b/examples/itemmodel/itemmodel.pro @@ -0,0 +1,12 @@ +!include( ../examples.pri ) { + error( "Couldn't find the examples.pri file!" ) +} + +SOURCES += main.cpp + +INSTALLS += target + +QT += widgets + +OTHER_FILES += doc/src/* \ + doc/images/* diff --git a/examples/itemmodel/main.cpp b/examples/itemmodel/main.cpp new file mode 100644 index 00000000..6ab685ed --- /dev/null +++ b/examples/itemmodel/main.cpp @@ -0,0 +1,287 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVisualization module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +#include <QtDataVisualization/q3dbars.h> +#include <QtDataVisualization/q3dcategoryaxis.h> +#include <QtDataVisualization/qitemmodelbardataproxy.h> +#include <QtDataVisualization/q3dvalueaxis.h> +#include <QtDataVisualization/q3dscene.h> +#include <QtDataVisualization/q3dcamera.h> + +#include <QApplication> +#include <QVBoxLayout> +#include <QTableWidget> +#include <QScreen> +#include <QTimer> +#include <QFont> +#include <QDebug> +#include <QHeaderView> + +#define USE_STATIC_DATA + +using namespace QtDataVisualization; + +class GraphDataGenerator : public QObject +{ +public: + explicit GraphDataGenerator(Q3DBars *bargraph, QTableWidget *tableWidget); + ~GraphDataGenerator(); + + void setupModel(); + void addRow(); + void changeStyle(); + void changePresetCamera(); + void changeTheme(); + void start(); + void selectFromTable(const QPoint &selection); + void selectedFromTable(int currentRow, int currentColumn, int previousRow, int previousColumn); + void fixTableSize(); + +private: + Q3DBars *m_graph; + QTimer *m_dataTimer; + QTimer *m_styleTimer; + QTimer *m_presetTimer; + QTimer *m_themeTimer; + int m_columnCount; + int m_rowCount; + QTableWidget *m_tableWidget; // not owned +}; + +GraphDataGenerator::GraphDataGenerator(Q3DBars *bargraph, QTableWidget *tableWidget) + : m_graph(bargraph), + m_dataTimer(0), + m_styleTimer(0), + m_presetTimer(0), + m_themeTimer(0), + m_columnCount(100), + m_rowCount(50), + m_tableWidget(tableWidget) +{ + //! [5] + // Set up bar specifications; make the bars as wide as they are deep, + // and add a small space between them + m_graph->setBarThickness(1.0); + m_graph->setBarSpacing(QSizeF(0.2, 0.2)); + + // Set bar type to flat pyramids + m_graph->setBarType(QDataVis::MeshStylePyramids, false); + + //! [5] + +#ifndef USE_STATIC_DATA + // Set up sample space; make it as deep as it's wide + m_graph->setDataWindow(m_rowCount, m_columnCount); + m_tableWidget->setColumnCount(m_columnCount); + + // Set selection mode to full + m_graph->setSelectionMode(QDataVis::SelectionModeItemRowAndColumn); + + // Hide axis labels by explicitly setting one empty string as label list + m_graph->rowAxis()->setCategoryLabels(QStringList(QString())); + m_graph->columnAxis()->setCategoryLabels(QStringList(QString())); + + m_graph->activeDataProxy()->setItemLabelFormat(QStringLiteral("@valueLabel")); +#else + //! [6] + + // Set selection mode to slice row + m_graph->setSelectionMode(QDataVis::SelectionModeSliceRow); + + // Set font + m_graph->setFont(QFont("Impact", 20)); + + //! [6] +#endif + + //! [7] + + // Set theme + m_graph->setTheme(QDataVis::ThemeDigia); + + // Set preset camera position + m_graph->scene()->activeCamera()->setCameraPreset(QDataVis::CameraPresetFront); + //! [7] +} + +GraphDataGenerator::~GraphDataGenerator() +{ + if (m_dataTimer) { + m_dataTimer->stop(); + delete m_dataTimer; + } + delete m_graph; +} + +void GraphDataGenerator::start() +{ +#ifndef USE_STATIC_DATA + m_dataTimer = new QTimer(); + m_dataTimer->setTimerType(Qt::CoarseTimer); + QObject::connect(m_dataTimer, &QTimer::timeout, this, &GraphDataGenerator::addRow); + m_dataTimer->start(0); + m_tableWidget->setFixedWidth(m_graph->width()); +#else + //! [8] + setupModel(); + // Table needs to be shown before the size of its headers can be accurately obtained, + // so we postpone it a bit + m_dataTimer = new QTimer(); + m_dataTimer->setSingleShot(true); + QObject::connect(m_dataTimer, &QTimer::timeout, this, &GraphDataGenerator::fixTableSize); + m_dataTimer->start(0); + //! [8] +#endif +} + +void GraphDataGenerator::setupModel() +{ + //! [9] + // Set up row and column names + QStringList days; + days << "Monday" << "Tuesday" << "Wednesday" << "Thursday" << "Friday" << "Saturday" << "Sunday"; + QStringList weeks; + weeks << "week 1" << "week 2" << "week 3" << "week 4" << "week 5"; + + // Set up data Mon Tue Wed Thu Fri Sat Sun + float hours[5][7] = {{2.0, 1.0, 3.0, 0.2, 1.0, 5.0, 10.0}, // week 1 + {0.5, 1.0, 3.0, 1.0, 2.0, 2.0, 3.0}, // week 2 + {1.0, 1.0, 2.0, 1.0, 4.0, 4.0, 4.0}, // week 3 + {0.0, 1.0, 0.0, 0.0, 2.0, 2.0, 0.3}, // week 4 + {3.0, 3.0, 6.0, 2.0, 2.0, 1.0, 1.0}}; // week 5 + //! [9] + + // Add labels + //! [10] + m_graph->rowAxis()->setTitle("Week of year"); + m_graph->columnAxis()->setTitle("Day of week"); + m_graph->valueAxis()->setTitle("Hours spent on the Internet"); + m_graph->valueAxis()->setSegmentCount(5); + m_graph->valueAxis()->setLabelFormat("%.1f h"); + //! [10] + + //! [11] + m_tableWidget->setRowCount(5); + m_tableWidget->setColumnCount(7); + m_tableWidget->setHorizontalHeaderLabels(days); + m_tableWidget->setVerticalHeaderLabels(weeks); + m_tableWidget->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff); + m_tableWidget->setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff); + m_tableWidget->setCurrentCell(-1, -1); + //! [11] + + //! [12] + for (int week = 0; week < weeks.size(); week++) { + for (int day = 0; day < days.size(); day++) { + QModelIndex index = m_tableWidget->model()->index(week, day); + m_tableWidget->model()->setData(index, hours[week][day]); + } + } + //! [12] +} + +void GraphDataGenerator::addRow() +{ + m_tableWidget->model()->insertRow(0); + if (m_tableWidget->model()->rowCount() > m_rowCount) + m_tableWidget->model()->removeRow(m_rowCount); + for (int i = 0; i < m_columnCount; i++) { + QModelIndex index = m_tableWidget->model()->index(0, i); + m_tableWidget->model()->setData(index, + ((qreal)i / (qreal)m_columnCount) / 2.0 + (qreal)(rand() % 30) / 100.0); + } + m_tableWidget->resizeColumnsToContents(); +} + +//! [13] +void GraphDataGenerator::selectFromTable(const QPoint &selection) +{ + m_tableWidget->setFocus(); + m_tableWidget->setCurrentCell(selection.x(), selection.y()); +} +//! [13] + +//! [14] +void GraphDataGenerator::selectedFromTable(int currentRow, int currentColumn, + int previousRow, int previousColumn) +{ + Q_UNUSED(previousRow) + Q_UNUSED(previousColumn) + m_graph->setSelectedBarPos(QPoint(currentRow, currentColumn)); +} +//! [14] + +void GraphDataGenerator::fixTableSize() +{ + int width = m_tableWidget->horizontalHeader()->length(); + width += m_tableWidget->verticalHeader()->width(); + m_tableWidget->setFixedWidth(width + 2); + int height = m_tableWidget->verticalHeader()->length(); + height += m_tableWidget->horizontalHeader()->height(); + m_tableWidget->setFixedHeight(height + 2); +} + +int main(int argc, char **argv) +{ + //! [0] + QApplication app(argc, argv); + Q3DBars *graph = new Q3DBars(); + QWidget *container = QWidget::createWindowContainer(graph); + //! [0] + + QSize screenSize = graph->screen()->size(); + container->setMinimumSize(QSize(screenSize.width() / 2, screenSize.height() / 2)); + container->setMaximumSize(screenSize); + container->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding); + container->setFocusPolicy(Qt::StrongFocus); + + //! [1] + QWidget widget; + QVBoxLayout *layout = new QVBoxLayout(&widget); + QTableWidget *tableWidget = new QTableWidget(&widget); + layout->addWidget(container, 1); + layout->addWidget(tableWidget, 1, Qt::AlignHCenter); + //! [1] + + tableWidget->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed); + tableWidget->setAlternatingRowColors(true); + widget.setWindowTitle(QStringLiteral("Hours spent on the Internet")); + + //! [2] + // Since we are dealing with QTableWidget, the model will already have data sorted properly + // in rows and columns, so create a mapping to utilize this. + QItemModelBarDataMapping *mapping = new QItemModelBarDataMapping; + mapping->setUseModelCategories(true); + QItemModelBarDataProxy *proxy = new QItemModelBarDataProxy(tableWidget->model(), mapping); + graph->setActiveDataProxy(proxy); + //! [2] + + //! [3] + GraphDataGenerator generator(graph, tableWidget); + QObject::connect(graph, &Q3DBars::selectedBarPosChanged, &generator, + &GraphDataGenerator::selectFromTable); + QObject::connect(tableWidget, &QTableWidget::currentCellChanged, &generator, + &GraphDataGenerator::selectedFromTable); + //! [3] + + //! [4] + widget.show(); + generator.start(); + return app.exec(); + //! [4] +} |