From 806dda08d685bc5f9ed71dfe8b61f21848d48066 Mon Sep 17 00:00:00 2001 From: Gabriel de Dietrich Date: Fri, 17 Aug 2012 13:23:19 +0200 Subject: 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 --- examples/widgets/mainwindows/menus/main.cpp | 51 +++ examples/widgets/mainwindows/menus/mainwindow.cpp | 370 ++++++++++++++++++++++ examples/widgets/mainwindows/menus/mainwindow.h | 124 ++++++++ examples/widgets/mainwindows/menus/menus.desktop | 11 + examples/widgets/mainwindows/menus/menus.pro | 11 + 5 files changed, 567 insertions(+) create mode 100644 examples/widgets/mainwindows/menus/main.cpp create mode 100644 examples/widgets/mainwindows/menus/mainwindow.cpp create mode 100644 examples/widgets/mainwindows/menus/mainwindow.h create mode 100644 examples/widgets/mainwindows/menus/menus.desktop create mode 100644 examples/widgets/mainwindows/menus/menus.pro (limited to 'examples/widgets/mainwindows/menus') diff --git a/examples/widgets/mainwindows/menus/main.cpp b/examples/widgets/mainwindows/menus/main.cpp new file mode 100644 index 0000000000..09a923477c --- /dev/null +++ b/examples/widgets/mainwindows/menus/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 + +#include "mainwindow.h" + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + MainWindow window; + window.show(); + return app.exec(); +} diff --git a/examples/widgets/mainwindows/menus/mainwindow.cpp b/examples/widgets/mainwindows/menus/mainwindow.cpp new file mode 100644 index 0000000000..e1f3a0c099 --- /dev/null +++ b/examples/widgets/mainwindows/menus/mainwindow.cpp @@ -0,0 +1,370 @@ +/**************************************************************************** +** +** 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 + +#include "mainwindow.h" + +//! [0] +MainWindow::MainWindow() +{ + QWidget *widget = new QWidget; + setCentralWidget(widget); +//! [0] + +//! [1] + QWidget *topFiller = new QWidget; + topFiller->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding); + + infoLabel = new QLabel(tr("Choose a menu option, or right-click to " + "invoke a context menu")); + infoLabel->setFrameStyle(QFrame::StyledPanel | QFrame::Sunken); + infoLabel->setAlignment(Qt::AlignCenter); + + QWidget *bottomFiller = new QWidget; + bottomFiller->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding); + + QVBoxLayout *layout = new QVBoxLayout; + layout->setMargin(5); + layout->addWidget(topFiller); + layout->addWidget(infoLabel); + layout->addWidget(bottomFiller); + widget->setLayout(layout); +//! [1] + +//! [2] + createActions(); + createMenus(); + + QString message = tr("A context menu is available by right-clicking"); + statusBar()->showMessage(message); + + setWindowTitle(tr("Menus")); + setMinimumSize(160, 160); + resize(480, 320); +} +//! [2] + +//! [3] +void MainWindow::contextMenuEvent(QContextMenuEvent *event) +{ + QMenu menu(this); + menu.addAction(cutAct); + menu.addAction(copyAct); + menu.addAction(pasteAct); + menu.exec(event->globalPos()); +} +//! [3] + +void MainWindow::newFile() +{ + infoLabel->setText(tr("Invoked File|New")); +} + +void MainWindow::open() +{ + infoLabel->setText(tr("Invoked File|Open")); +} + +void MainWindow::save() +{ + infoLabel->setText(tr("Invoked File|Save")); +} + +void MainWindow::print() +{ + infoLabel->setText(tr("Invoked File|Print")); +} + +void MainWindow::undo() +{ + infoLabel->setText(tr("Invoked Edit|Undo")); +} + +void MainWindow::redo() +{ + infoLabel->setText(tr("Invoked Edit|Redo")); +} + +void MainWindow::cut() +{ + infoLabel->setText(tr("Invoked Edit|Cut")); +} + +void MainWindow::copy() +{ + infoLabel->setText(tr("Invoked Edit|Copy")); +} + +void MainWindow::paste() +{ + infoLabel->setText(tr("Invoked Edit|Paste")); +} + +void MainWindow::bold() +{ + infoLabel->setText(tr("Invoked Edit|Format|Bold")); +} + +void MainWindow::italic() +{ + infoLabel->setText(tr("Invoked Edit|Format|Italic")); +} + +void MainWindow::leftAlign() +{ + infoLabel->setText(tr("Invoked Edit|Format|Left Align")); +} + +void MainWindow::rightAlign() +{ + infoLabel->setText(tr("Invoked Edit|Format|Right Align")); +} + +void MainWindow::justify() +{ + infoLabel->setText(tr("Invoked Edit|Format|Justify")); +} + +void MainWindow::center() +{ + infoLabel->setText(tr("Invoked Edit|Format|Center")); +} + +void MainWindow::setLineSpacing() +{ + infoLabel->setText(tr("Invoked Edit|Format|Set Line Spacing")); +} + +void MainWindow::setParagraphSpacing() +{ + infoLabel->setText(tr("Invoked Edit|Format|Set Paragraph Spacing")); +} + +void MainWindow::about() +{ + infoLabel->setText(tr("Invoked Help|About")); + QMessageBox::about(this, tr("About Menu"), + tr("The Menu example shows how to create " + "menu-bar menus and context menus.")); +} + +void MainWindow::aboutQt() +{ + infoLabel->setText(tr("Invoked Help|About Qt")); +} + +//! [4] +void MainWindow::createActions() +{ +//! [5] + newAct = new QAction(tr("&New"), this); + newAct->setShortcuts(QKeySequence::New); + newAct->setStatusTip(tr("Create a new file")); + connect(newAct, SIGNAL(triggered()), this, SLOT(newFile())); +//! [4] + + openAct = new QAction(tr("&Open..."), this); + openAct->setShortcuts(QKeySequence::Open); + openAct->setStatusTip(tr("Open an existing file")); + connect(openAct, SIGNAL(triggered()), this, SLOT(open())); +//! [5] + + saveAct = new QAction(tr("&Save"), this); + saveAct->setShortcuts(QKeySequence::Save); + saveAct->setStatusTip(tr("Save the document to disk")); + connect(saveAct, SIGNAL(triggered()), this, SLOT(save())); + + printAct = new QAction(tr("&Print..."), this); + printAct->setShortcuts(QKeySequence::Print); + printAct->setStatusTip(tr("Print the document")); + connect(printAct, SIGNAL(triggered()), this, SLOT(print())); + + exitAct = new QAction(tr("E&xit"), this); + exitAct->setShortcuts(QKeySequence::Quit); + exitAct->setStatusTip(tr("Exit the application")); + connect(exitAct, SIGNAL(triggered()), this, SLOT(close())); + + undoAct = new QAction(tr("&Undo"), this); + undoAct->setShortcuts(QKeySequence::Undo); + undoAct->setStatusTip(tr("Undo the last operation")); + connect(undoAct, SIGNAL(triggered()), this, SLOT(undo())); + + redoAct = new QAction(tr("&Redo"), this); + redoAct->setShortcuts(QKeySequence::Redo); + redoAct->setStatusTip(tr("Redo the last operation")); + connect(redoAct, SIGNAL(triggered()), this, SLOT(redo())); + + cutAct = new QAction(tr("Cu&t"), this); + cutAct->setShortcuts(QKeySequence::Cut); + cutAct->setStatusTip(tr("Cut the current selection's contents to the " + "clipboard")); + connect(cutAct, SIGNAL(triggered()), this, SLOT(cut())); + + copyAct = new QAction(tr("&Copy"), this); + copyAct->setShortcuts(QKeySequence::Copy); + copyAct->setStatusTip(tr("Copy the current selection's contents to the " + "clipboard")); + connect(copyAct, SIGNAL(triggered()), this, SLOT(copy())); + + pasteAct = new QAction(tr("&Paste"), this); + pasteAct->setShortcuts(QKeySequence::Paste); + pasteAct->setStatusTip(tr("Paste the clipboard's contents into the current " + "selection")); + connect(pasteAct, SIGNAL(triggered()), this, SLOT(paste())); + + boldAct = new QAction(tr("&Bold"), this); + boldAct->setCheckable(true); + boldAct->setShortcut(QKeySequence::Bold); + boldAct->setStatusTip(tr("Make the text bold")); + connect(boldAct, SIGNAL(triggered()), this, SLOT(bold())); + + QFont boldFont = boldAct->font(); + boldFont.setBold(true); + boldAct->setFont(boldFont); + + italicAct = new QAction(tr("&Italic"), this); + italicAct->setCheckable(true); + italicAct->setShortcut(QKeySequence::Italic); + italicAct->setStatusTip(tr("Make the text italic")); + connect(italicAct, SIGNAL(triggered()), this, SLOT(italic())); + + QFont italicFont = italicAct->font(); + italicFont.setItalic(true); + italicAct->setFont(italicFont); + + setLineSpacingAct = new QAction(tr("Set &Line Spacing..."), this); + setLineSpacingAct->setStatusTip(tr("Change the gap between the lines of a " + "paragraph")); + connect(setLineSpacingAct, SIGNAL(triggered()), this, SLOT(setLineSpacing())); + + setParagraphSpacingAct = new QAction(tr("Set &Paragraph Spacing..."), this); + setParagraphSpacingAct->setStatusTip(tr("Change the gap between paragraphs")); + connect(setParagraphSpacingAct, SIGNAL(triggered()), + this, SLOT(setParagraphSpacing())); + + aboutAct = new QAction(tr("&About"), this); + aboutAct->setStatusTip(tr("Show the application's About box")); + connect(aboutAct, SIGNAL(triggered()), this, SLOT(about())); + + aboutQtAct = new QAction(tr("About &Qt"), this); + aboutQtAct->setStatusTip(tr("Show the Qt library's About box")); + connect(aboutQtAct, SIGNAL(triggered()), qApp, SLOT(aboutQt())); + connect(aboutQtAct, SIGNAL(triggered()), this, SLOT(aboutQt())); + + leftAlignAct = new QAction(tr("&Left Align"), this); + leftAlignAct->setCheckable(true); + leftAlignAct->setShortcut(tr("Ctrl+L")); + leftAlignAct->setStatusTip(tr("Left align the selected text")); + connect(leftAlignAct, SIGNAL(triggered()), this, SLOT(leftAlign())); + + rightAlignAct = new QAction(tr("&Right Align"), this); + rightAlignAct->setCheckable(true); + rightAlignAct->setShortcut(tr("Ctrl+R")); + rightAlignAct->setStatusTip(tr("Right align the selected text")); + connect(rightAlignAct, SIGNAL(triggered()), this, SLOT(rightAlign())); + + justifyAct = new QAction(tr("&Justify"), this); + justifyAct->setCheckable(true); + justifyAct->setShortcut(tr("Ctrl+J")); + justifyAct->setStatusTip(tr("Justify the selected text")); + connect(justifyAct, SIGNAL(triggered()), this, SLOT(justify())); + + centerAct = new QAction(tr("&Center"), this); + centerAct->setCheckable(true); + centerAct->setShortcut(tr("Ctrl+E")); + centerAct->setStatusTip(tr("Center the selected text")); + connect(centerAct, SIGNAL(triggered()), this, SLOT(center())); + +//! [6] //! [7] + alignmentGroup = new QActionGroup(this); + alignmentGroup->addAction(leftAlignAct); + alignmentGroup->addAction(rightAlignAct); + alignmentGroup->addAction(justifyAct); + alignmentGroup->addAction(centerAct); + leftAlignAct->setChecked(true); +//! [6] +} +//! [7] + +//! [8] +void MainWindow::createMenus() +{ +//! [9] //! [10] + fileMenu = menuBar()->addMenu(tr("&File")); + fileMenu->addAction(newAct); +//! [9] + fileMenu->addAction(openAct); +//! [10] + fileMenu->addAction(saveAct); + fileMenu->addAction(printAct); +//! [11] + fileMenu->addSeparator(); +//! [11] + fileMenu->addAction(exitAct); + + editMenu = menuBar()->addMenu(tr("&Edit")); + editMenu->addAction(undoAct); + editMenu->addAction(redoAct); + editMenu->addSeparator(); + editMenu->addAction(cutAct); + editMenu->addAction(copyAct); + editMenu->addAction(pasteAct); + editMenu->addSeparator(); + + helpMenu = menuBar()->addMenu(tr("&Help")); + helpMenu->addAction(aboutAct); + helpMenu->addAction(aboutQtAct); +//! [8] + +//! [12] + formatMenu = editMenu->addMenu(tr("&Format")); + formatMenu->addAction(boldAct); + formatMenu->addAction(italicAct); + formatMenu->addSeparator()->setText(tr("Alignment")); + formatMenu->addAction(leftAlignAct); + formatMenu->addAction(rightAlignAct); + formatMenu->addAction(justifyAct); + formatMenu->addAction(centerAct); + formatMenu->addSeparator(); + formatMenu->addAction(setLineSpacingAct); + formatMenu->addAction(setParagraphSpacingAct); +} +//! [12] diff --git a/examples/widgets/mainwindows/menus/mainwindow.h b/examples/widgets/mainwindows/menus/mainwindow.h new file mode 100644 index 0000000000..ebafb529eb --- /dev/null +++ b/examples/widgets/mainwindows/menus/mainwindow.h @@ -0,0 +1,124 @@ +/**************************************************************************** +** +** 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 MAINWINDOW_H +#define MAINWINDOW_H + +#include + +QT_BEGIN_NAMESPACE +class QAction; +class QActionGroup; +class QLabel; +class QMenu; +QT_END_NAMESPACE + +//! [0] +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(); + +protected: + void contextMenuEvent(QContextMenuEvent *event); +//! [0] + +//! [1] +private slots: + void newFile(); + void open(); + void save(); + void print(); + void undo(); + void redo(); + void cut(); + void copy(); + void paste(); + void bold(); + void italic(); + void leftAlign(); + void rightAlign(); + void justify(); + void center(); + void setLineSpacing(); + void setParagraphSpacing(); + void about(); + void aboutQt(); +//! [1] + +//! [2] +private: + void createActions(); + void createMenus(); +//! [2] + +//! [3] + QMenu *fileMenu; + QMenu *editMenu; + QMenu *formatMenu; + QMenu *helpMenu; + QActionGroup *alignmentGroup; + QAction *newAct; + QAction *openAct; + QAction *saveAct; + QAction *printAct; + QAction *exitAct; + QAction *undoAct; + QAction *redoAct; + QAction *cutAct; + QAction *copyAct; + QAction *pasteAct; + QAction *boldAct; + QAction *italicAct; + QAction *leftAlignAct; + QAction *rightAlignAct; + QAction *justifyAct; + QAction *centerAct; + QAction *setLineSpacingAct; + QAction *setParagraphSpacingAct; + QAction *aboutAct; + QAction *aboutQtAct; + QLabel *infoLabel; +}; +//! [3] + +#endif diff --git a/examples/widgets/mainwindows/menus/menus.desktop b/examples/widgets/mainwindows/menus/menus.desktop new file mode 100644 index 0000000000..dc2bda92af --- /dev/null +++ b/examples/widgets/mainwindows/menus/menus.desktop @@ -0,0 +1,11 @@ +[Desktop Entry] +Encoding=UTF-8 +Version=1.0 +Type=Application +Terminal=false +Name=Menus +Exec=/opt/usr/bin/menus +Icon=menus +X-Window-Icon= +X-HildonDesk-ShowInToolbar=true +X-Osso-Type=application/x-executable diff --git a/examples/widgets/mainwindows/menus/menus.pro b/examples/widgets/mainwindows/menus/menus.pro new file mode 100644 index 0000000000..5ed1e0dae5 --- /dev/null +++ b/examples/widgets/mainwindows/menus/menus.pro @@ -0,0 +1,11 @@ +HEADERS = mainwindow.h +SOURCES = mainwindow.cpp \ + main.cpp + +# install +target.path = $$[QT_INSTALL_EXAMPLES]/qtbase/mainwindows/menus +sources.files = $$SOURCES $$HEADERS $$RESOURCES $$FORMS menus.pro +sources.path = $$[QT_INSTALL_EXAMPLES]/qtbase/mainwindows/menus +INSTALLS += target sources + +QT += widgets -- cgit v1.2.3