diff options
author | Gabriel de Dietrich <gabriel.dietrich-de@nokia.com> | 2012-08-17 13:23:19 +0200 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-08-20 12:20:55 +0200 |
commit | 806dda08d685bc5f9ed71dfe8b61f21848d48066 (patch) | |
tree | a63533a1c4a335ae17adc105abb0ae4e62e2f26e /examples/widgets/layouts/borderlayout | |
parent | 9f942014e31842b512c3198de035d041c59f54a9 (diff) |
Moving .qdoc files under examples/widgets/doc
Updated those .qdoc files to refer to the new relative examples
emplacement. Images and snippets to be moved later.
Also grouped all widgets related examples under widgets.
Change-Id: Ib29696e2d8948524537f53e8dda88f9ee26a597f
Reviewed-by: J-P Nurmi <j-p.nurmi@nokia.com>
Diffstat (limited to 'examples/widgets/layouts/borderlayout')
-rw-r--r-- | examples/widgets/layouts/borderlayout/borderlayout.cpp | 213 | ||||
-rw-r--r-- | examples/widgets/layouts/borderlayout/borderlayout.desktop | 11 | ||||
-rw-r--r-- | examples/widgets/layouts/borderlayout/borderlayout.h | 88 | ||||
-rw-r--r-- | examples/widgets/layouts/borderlayout/borderlayout.pro | 13 | ||||
-rw-r--r-- | examples/widgets/layouts/borderlayout/main.cpp | 51 | ||||
-rw-r--r-- | examples/widgets/layouts/borderlayout/window.cpp | 68 | ||||
-rw-r--r-- | examples/widgets/layouts/borderlayout/window.h | 61 |
7 files changed, 505 insertions, 0 deletions
diff --git a/examples/widgets/layouts/borderlayout/borderlayout.cpp b/examples/widgets/layouts/borderlayout/borderlayout.cpp new file mode 100644 index 0000000000..fd08a32fe1 --- /dev/null +++ b/examples/widgets/layouts/borderlayout/borderlayout.cpp @@ -0,0 +1,213 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/ +** +** This file is part of the examples of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:BSD$ +** You may use this file under the terms of the BSD license as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * Redistributions in binary form must reproduce the above copyright +** notice, this list of conditions and the following disclaimer in +** the documentation and/or other materials provided with the +** distribution. +** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor +** the names of its contributors may be used to endorse or promote +** products derived from this software without specific prior written +** permission. +** +** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include <QtWidgets> + +#include "borderlayout.h" + +BorderLayout::BorderLayout(QWidget *parent, int margin, int spacing) + : QLayout(parent) +{ + setMargin(margin); + setSpacing(spacing); +} + +BorderLayout::BorderLayout(int spacing) +{ + setSpacing(spacing); +} + + +BorderLayout::~BorderLayout() +{ + QLayoutItem *l; + while ((l = takeAt(0))) + delete l; +} + +void BorderLayout::addItem(QLayoutItem *item) +{ + add(item, West); +} + +void BorderLayout::addWidget(QWidget *widget, Position position) +{ + add(new QWidgetItem(widget), position); +} + +Qt::Orientations BorderLayout::expandingDirections() const +{ + return Qt::Horizontal | Qt::Vertical; +} + +bool BorderLayout::hasHeightForWidth() const +{ + return false; +} + +int BorderLayout::count() const +{ + return list.size(); +} + +QLayoutItem *BorderLayout::itemAt(int index) const +{ + ItemWrapper *wrapper = list.value(index); + if (wrapper) + return wrapper->item; + else + return 0; +} + +QSize BorderLayout::minimumSize() const +{ + return calculateSize(MinimumSize); +} + +void BorderLayout::setGeometry(const QRect &rect) +{ + ItemWrapper *center = 0; + int eastWidth = 0; + int westWidth = 0; + int northHeight = 0; + int southHeight = 0; + int centerHeight = 0; + int i; + + QLayout::setGeometry(rect); + + for (i = 0; i < list.size(); ++i) { + ItemWrapper *wrapper = list.at(i); + QLayoutItem *item = wrapper->item; + Position position = wrapper->position; + + if (position == North) { + item->setGeometry(QRect(rect.x(), northHeight, rect.width(), + item->sizeHint().height())); + + northHeight += item->geometry().height() + spacing(); + } else if (position == South) { + item->setGeometry(QRect(item->geometry().x(), + item->geometry().y(), rect.width(), + item->sizeHint().height())); + + southHeight += item->geometry().height() + spacing(); + + item->setGeometry(QRect(rect.x(), + rect.y() + rect.height() - southHeight + spacing(), + item->geometry().width(), + item->geometry().height())); + } else if (position == Center) { + center = wrapper; + } + } + + centerHeight = rect.height() - northHeight - southHeight; + + for (i = 0; i < list.size(); ++i) { + ItemWrapper *wrapper = list.at(i); + QLayoutItem *item = wrapper->item; + Position position = wrapper->position; + + if (position == West) { + item->setGeometry(QRect(rect.x() + westWidth, northHeight, + item->sizeHint().width(), centerHeight)); + + westWidth += item->geometry().width() + spacing(); + } else if (position == East) { + item->setGeometry(QRect(item->geometry().x(), item->geometry().y(), + item->sizeHint().width(), centerHeight)); + + eastWidth += item->geometry().width() + spacing(); + + item->setGeometry(QRect( + rect.x() + rect.width() - eastWidth + spacing(), + northHeight, item->geometry().width(), + item->geometry().height())); + } + } + + if (center) + center->item->setGeometry(QRect(westWidth, northHeight, + rect.width() - eastWidth - westWidth, + centerHeight)); +} + +QSize BorderLayout::sizeHint() const +{ + return calculateSize(SizeHint); +} + +QLayoutItem *BorderLayout::takeAt(int index) +{ + if (index >= 0 && index < list.size()) { + ItemWrapper *layoutStruct = list.takeAt(index); + return layoutStruct->item; + } + return 0; +} + +void BorderLayout::add(QLayoutItem *item, Position position) +{ + list.append(new ItemWrapper(item, position)); +} + +QSize BorderLayout::calculateSize(SizeType sizeType) const +{ + QSize totalSize; + + for (int i = 0; i < list.size(); ++i) { + ItemWrapper *wrapper = list.at(i); + Position position = wrapper->position; + QSize itemSize; + + if (sizeType == MinimumSize) + itemSize = wrapper->item->minimumSize(); + else // (sizeType == SizeHint) + itemSize = wrapper->item->sizeHint(); + + if (position == North || position == South || position == Center) + totalSize.rheight() += itemSize.height(); + + if (position == West || position == East || position == Center) + totalSize.rwidth() += itemSize.width(); + } + return totalSize; +} diff --git a/examples/widgets/layouts/borderlayout/borderlayout.desktop b/examples/widgets/layouts/borderlayout/borderlayout.desktop new file mode 100644 index 0000000000..3fd0641f1c --- /dev/null +++ b/examples/widgets/layouts/borderlayout/borderlayout.desktop @@ -0,0 +1,11 @@ +[Desktop Entry] +Encoding=UTF-8 +Version=1.0 +Type=Application +Terminal=false +Name=Border Layout +Exec=/opt/usr/bin/borderlayout +Icon=borderlayout +X-Window-Icon= +X-HildonDesk-ShowInToolbar=true +X-Osso-Type=application/x-executable diff --git a/examples/widgets/layouts/borderlayout/borderlayout.h b/examples/widgets/layouts/borderlayout/borderlayout.h new file mode 100644 index 0000000000..937517dc17 --- /dev/null +++ b/examples/widgets/layouts/borderlayout/borderlayout.h @@ -0,0 +1,88 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/ +** +** This file is part of the examples of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:BSD$ +** You may use this file under the terms of the BSD license as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * Redistributions in binary form must reproduce the above copyright +** notice, this list of conditions and the following disclaimer in +** the documentation and/or other materials provided with the +** distribution. +** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor +** the names of its contributors may be used to endorse or promote +** products derived from this software without specific prior written +** permission. +** +** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#ifndef BORDERLAYOUT_H +#define BORDERLAYOUT_H + +#include <QLayout> +#include <QRect> +#include <QWidgetItem> + +class BorderLayout : public QLayout +{ +public: + enum Position { West, North, South, East, Center }; + + BorderLayout(QWidget *parent, int margin = 0, int spacing = -1); + BorderLayout(int spacing = -1); + ~BorderLayout(); + + void addItem(QLayoutItem *item); + void addWidget(QWidget *widget, Position position); + Qt::Orientations expandingDirections() const; + bool hasHeightForWidth() const; + int count() const; + QLayoutItem *itemAt(int index) const; + QSize minimumSize() const; + void setGeometry(const QRect &rect); + QSize sizeHint() const; + QLayoutItem *takeAt(int index); + + void add(QLayoutItem *item, Position position); + +private: + struct ItemWrapper + { + ItemWrapper(QLayoutItem *i, Position p) { + item = i; + position = p; + } + + QLayoutItem *item; + Position position; + }; + + enum SizeType { MinimumSize, SizeHint }; + QSize calculateSize(SizeType sizeType) const; + + QList<ItemWrapper *> list; +}; + +#endif diff --git a/examples/widgets/layouts/borderlayout/borderlayout.pro b/examples/widgets/layouts/borderlayout/borderlayout.pro new file mode 100644 index 0000000000..6727af60d7 --- /dev/null +++ b/examples/widgets/layouts/borderlayout/borderlayout.pro @@ -0,0 +1,13 @@ +HEADERS = borderlayout.h \ + window.h +SOURCES = borderlayout.cpp \ + main.cpp \ + window.cpp + +# install +target.path = $$[QT_INSTALL_EXAMPLES]/qtbase/layouts/borderlayout +sources.files = $$SOURCES $$HEADERS *.pro +sources.path = $$[QT_INSTALL_EXAMPLES]/qtbase/layouts/borderlayout +INSTALLS += target sources + +QT += widgets diff --git a/examples/widgets/layouts/borderlayout/main.cpp b/examples/widgets/layouts/borderlayout/main.cpp new file mode 100644 index 0000000000..dcbf1c0449 --- /dev/null +++ b/examples/widgets/layouts/borderlayout/main.cpp @@ -0,0 +1,51 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/ +** +** This file is part of the examples of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:BSD$ +** You may use this file under the terms of the BSD license as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * Redistributions in binary form must reproduce the above copyright +** notice, this list of conditions and the following disclaimer in +** the documentation and/or other materials provided with the +** distribution. +** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor +** the names of its contributors may be used to endorse or promote +** products derived from this software without specific prior written +** permission. +** +** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include <QApplication> + +#include "window.h" + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + Window window; + window.show(); + return app.exec(); +} diff --git a/examples/widgets/layouts/borderlayout/window.cpp b/examples/widgets/layouts/borderlayout/window.cpp new file mode 100644 index 0000000000..73ad86a826 --- /dev/null +++ b/examples/widgets/layouts/borderlayout/window.cpp @@ -0,0 +1,68 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/ +** +** This file is part of the examples of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:BSD$ +** You may use this file under the terms of the BSD license as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * Redistributions in binary form must reproduce the above copyright +** notice, this list of conditions and the following disclaimer in +** the documentation and/or other materials provided with the +** distribution. +** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor +** the names of its contributors may be used to endorse or promote +** products derived from this software without specific prior written +** permission. +** +** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include <QtWidgets> + +#include "borderlayout.h" +#include "window.h" + +Window::Window() +{ + QTextBrowser *centralWidget = new QTextBrowser; + centralWidget->setPlainText(tr("Central widget")); + + BorderLayout *layout = new BorderLayout; + layout->addWidget(centralWidget, BorderLayout::Center); + layout->addWidget(createLabel("North"), BorderLayout::North); + layout->addWidget(createLabel("West"), BorderLayout::West); + layout->addWidget(createLabel("East 1"), BorderLayout::East); + layout->addWidget(createLabel("East 2") , BorderLayout::East); + layout->addWidget(createLabel("South"), BorderLayout::South); + setLayout(layout); + + setWindowTitle(tr("Border Layout")); +} + +QLabel *Window::createLabel(const QString &text) +{ + QLabel *label = new QLabel(text); + label->setFrameStyle(QFrame::Box | QFrame::Raised); + return label; +} diff --git a/examples/widgets/layouts/borderlayout/window.h b/examples/widgets/layouts/borderlayout/window.h new file mode 100644 index 0000000000..3db08e1ab3 --- /dev/null +++ b/examples/widgets/layouts/borderlayout/window.h @@ -0,0 +1,61 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/ +** +** This file is part of the examples of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:BSD$ +** You may use this file under the terms of the BSD license as follows: +** +** "Redistribution and use in source and binary forms, with or without +** modification, are permitted provided that the following conditions are +** met: +** * Redistributions of source code must retain the above copyright +** notice, this list of conditions and the following disclaimer. +** * Redistributions in binary form must reproduce the above copyright +** notice, this list of conditions and the following disclaimer in +** the documentation and/or other materials provided with the +** distribution. +** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor +** the names of its contributors may be used to endorse or promote +** products derived from this software without specific prior written +** permission. +** +** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#ifndef WINDOW_H +#define WINDOW_H + +#include <QWidget> + +QT_BEGIN_NAMESPACE +class QLabel; +QT_END_NAMESPACE + +class Window : public QWidget +{ + Q_OBJECT + +public: + Window(); + +private: + QLabel *createLabel(const QString &text); +}; + +#endif |