From b1e739b52416852014ee7a933aac81a28a9ac71f Mon Sep 17 00:00:00 2001 From: Jerome Pasion Date: Wed, 24 Oct 2012 15:51:15 +0200 Subject: [PATCH] Qt GUI: Adding Rich Text Processing documentation from qtdoc -included the snippets -editing for technical accuracy still to be done. -ported missing files from Qt 4 Change-Id: I0b2d27630b762c6518c08973a40b476d7852001d Reviewed-by: Eskil Abrahamsen Blomfeldt --- src/gui/doc/images/plaintext-layout.png | Bin 0 -> 46384 bytes src/gui/doc/images/richtext-document.png | Bin 0 -> 8126 bytes src/gui/doc/snippets/code/doc_src_richtext.cpp | 85 ++ src/gui/doc/snippets/code/doc_src_richtext.qdoc | 43 + src/gui/doc/snippets/plaintextlayout/main.cpp | 52 + .../snippets/plaintextlayout/plaintextlayout.pro | 3 + src/gui/doc/snippets/plaintextlayout/window.cpp | 108 ++ src/gui/doc/snippets/plaintextlayout/window.h | 61 + src/gui/doc/snippets/scribe-overview/main.cpp | 73 ++ .../snippets/scribe-overview/scribe-overview.pro | 1 + src/gui/doc/snippets/textblock-formats/main.cpp | 118 ++ .../textblock-formats/textblock-formats.pro | 2 + src/gui/doc/snippets/textblock-fragments/main.cpp | 52 + .../snippets/textblock-fragments/mainwindow.cpp | 148 +++ .../doc/snippets/textblock-fragments/mainwindow.h | 65 ++ .../textblock-fragments/textblock-fragments.pro | 6 + .../doc/snippets/textblock-fragments/xmlwriter.h | 64 ++ src/gui/doc/snippets/textdocument-blocks/main.cpp | 52 + .../snippets/textdocument-blocks/mainwindow.cpp | 156 +++ .../doc/snippets/textdocument-blocks/mainwindow.h | 65 ++ .../textdocument-blocks/textdocument-blocks.pro | 6 + .../doc/snippets/textdocument-blocks/xmlwriter.cpp | 84 ++ .../doc/snippets/textdocument-blocks/xmlwriter.h | 61 + .../doc/snippets/textdocument-charformats/main.cpp | 92 ++ .../textdocument-charformats.pro | 1 + src/gui/doc/snippets/textdocument-cursors/main.cpp | 79 ++ .../textdocument-cursors/textdocument-cursors.pro | 1 + src/gui/doc/snippets/textdocument-find/main.cpp | 91 ++ .../textdocument-find/textdocument-find.pro | 1 + src/gui/doc/snippets/textdocument-frames/main.cpp | 53 + .../snippets/textdocument-frames/mainwindow.cpp | 161 +++ .../doc/snippets/textdocument-frames/mainwindow.h | 64 ++ .../textdocument-frames/textdocument-frames.pro | 6 + .../doc/snippets/textdocument-frames/xmlwriter.cpp | 118 ++ .../doc/snippets/textdocument-frames/xmlwriter.h | 64 ++ .../doc/snippets/textdocument-imagedrop/main.cpp | 52 + .../textdocument-imagedrop.pro | 2 + .../doc/snippets/textdocument-imagedrop/textedit.h | 56 + .../snippets/textdocument-imageformat/images.qrc | 6 + .../textdocument-imageformat/images/advert.png | Bin 0 -> 16291 bytes .../textdocument-imageformat/images/newimage.png | Bin 0 -> 5490 bytes .../doc/snippets/textdocument-imageformat/main.cpp | 98 ++ .../textdocument-imageformat.pro | 2 + .../doc/snippets/textdocument-images/images.qrc | 5 + .../snippets/textdocument-images/images/advert.png | Bin 0 -> 16291 bytes src/gui/doc/snippets/textdocument-images/main.cpp | 72 ++ .../textdocument-images/textdocument-images.pro | 2 + .../doc/snippets/textdocument-listitems/main.cpp | 52 + .../snippets/textdocument-listitems/mainwindow.cpp | 197 ++++ .../snippets/textdocument-listitems/mainwindow.h | 75 ++ .../textdocument-listitems.pro | 3 + .../doc/snippets/textdocument-printing/main.cpp | 52 + .../snippets/textdocument-printing/mainwindow.cpp | 124 ++ .../snippets/textdocument-printing/mainwindow.h | 72 ++ .../textdocument-printing.pro | 3 + .../doc/snippets/textdocument-selections/main.cpp | 52 + .../textdocument-selections/mainwindow.cpp | 203 ++++ .../snippets/textdocument-selections/mainwindow.h | 79 ++ .../textdocument-selections.pro | 4 + src/gui/doc/snippets/textdocument-tables/main.cpp | 52 + .../doc/snippets/textdocument-tables/mainwindow.h | 65 ++ .../textdocument-tables/textdocument-tables.pro | 6 + .../doc/snippets/textdocument-tables/xmlwriter.cpp | 155 +++ .../doc/snippets/textdocument-tables/xmlwriter.h | 64 ++ src/gui/doc/src/richtext.qdoc | 1214 ++++++++++++++++++++ 65 files changed, 4803 insertions(+) create mode 100644 src/gui/doc/images/plaintext-layout.png create mode 100644 src/gui/doc/images/richtext-document.png create mode 100644 src/gui/doc/snippets/code/doc_src_richtext.cpp create mode 100644 src/gui/doc/snippets/code/doc_src_richtext.qdoc create mode 100644 src/gui/doc/snippets/plaintextlayout/main.cpp create mode 100644 src/gui/doc/snippets/plaintextlayout/plaintextlayout.pro create mode 100644 src/gui/doc/snippets/plaintextlayout/window.cpp create mode 100644 src/gui/doc/snippets/plaintextlayout/window.h create mode 100644 src/gui/doc/snippets/scribe-overview/main.cpp create mode 100644 src/gui/doc/snippets/scribe-overview/scribe-overview.pro create mode 100644 src/gui/doc/snippets/textblock-formats/main.cpp create mode 100644 src/gui/doc/snippets/textblock-formats/textblock-formats.pro create mode 100644 src/gui/doc/snippets/textblock-fragments/main.cpp create mode 100644 src/gui/doc/snippets/textblock-fragments/mainwindow.cpp create mode 100644 src/gui/doc/snippets/textblock-fragments/mainwindow.h create mode 100644 src/gui/doc/snippets/textblock-fragments/textblock-fragments.pro create mode 100644 src/gui/doc/snippets/textblock-fragments/xmlwriter.h create mode 100644 src/gui/doc/snippets/textdocument-blocks/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-blocks/mainwindow.cpp create mode 100644 src/gui/doc/snippets/textdocument-blocks/mainwindow.h create mode 100644 src/gui/doc/snippets/textdocument-blocks/textdocument-blocks.pro create mode 100644 src/gui/doc/snippets/textdocument-blocks/xmlwriter.cpp create mode 100644 src/gui/doc/snippets/textdocument-blocks/xmlwriter.h create mode 100644 src/gui/doc/snippets/textdocument-charformats/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-charformats/textdocument-charformats.pro create mode 100644 src/gui/doc/snippets/textdocument-cursors/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-cursors/textdocument-cursors.pro create mode 100644 src/gui/doc/snippets/textdocument-find/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-find/textdocument-find.pro create mode 100644 src/gui/doc/snippets/textdocument-frames/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-frames/mainwindow.cpp create mode 100644 src/gui/doc/snippets/textdocument-frames/mainwindow.h create mode 100644 src/gui/doc/snippets/textdocument-frames/textdocument-frames.pro create mode 100644 src/gui/doc/snippets/textdocument-frames/xmlwriter.cpp create mode 100644 src/gui/doc/snippets/textdocument-frames/xmlwriter.h create mode 100644 src/gui/doc/snippets/textdocument-imagedrop/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-imagedrop/textdocument-imagedrop.pro create mode 100644 src/gui/doc/snippets/textdocument-imagedrop/textedit.h create mode 100644 src/gui/doc/snippets/textdocument-imageformat/images.qrc create mode 100644 src/gui/doc/snippets/textdocument-imageformat/images/advert.png create mode 100644 src/gui/doc/snippets/textdocument-imageformat/images/newimage.png create mode 100644 src/gui/doc/snippets/textdocument-imageformat/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-imageformat/textdocument-imageformat.pro create mode 100644 src/gui/doc/snippets/textdocument-images/images.qrc create mode 100644 src/gui/doc/snippets/textdocument-images/images/advert.png create mode 100644 src/gui/doc/snippets/textdocument-images/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-images/textdocument-images.pro create mode 100644 src/gui/doc/snippets/textdocument-listitems/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-listitems/mainwindow.cpp create mode 100644 src/gui/doc/snippets/textdocument-listitems/mainwindow.h create mode 100644 src/gui/doc/snippets/textdocument-listitems/textdocument-listitems.pro create mode 100644 src/gui/doc/snippets/textdocument-printing/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-printing/mainwindow.cpp create mode 100644 src/gui/doc/snippets/textdocument-printing/mainwindow.h create mode 100644 src/gui/doc/snippets/textdocument-printing/textdocument-printing.pro create mode 100644 src/gui/doc/snippets/textdocument-selections/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-selections/mainwindow.cpp create mode 100644 src/gui/doc/snippets/textdocument-selections/mainwindow.h create mode 100644 src/gui/doc/snippets/textdocument-selections/textdocument-selections.pro create mode 100644 src/gui/doc/snippets/textdocument-tables/main.cpp create mode 100644 src/gui/doc/snippets/textdocument-tables/mainwindow.h create mode 100644 src/gui/doc/snippets/textdocument-tables/textdocument-tables.pro create mode 100644 src/gui/doc/snippets/textdocument-tables/xmlwriter.cpp create mode 100644 src/gui/doc/snippets/textdocument-tables/xmlwriter.h create mode 100644 src/gui/doc/src/richtext.qdoc diff --git a/src/gui/doc/images/plaintext-layout.png b/src/gui/doc/images/plaintext-layout.png new file mode 100644 index 0000000000000000000000000000000000000000..9172d7a044d5828fc755bf9e126d089b8ef57dde GIT binary patch literal 46384 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 UXymz)BLDyZ07*qoM6N<$g8${GF#rGn literal 0 HcmV?d00001 diff --git a/src/gui/doc/images/richtext-document.png b/src/gui/doc/images/richtext-document.png new file mode 100644 index 0000000000000000000000000000000000000000..4ae5d16b610a675f334e597959e5f92c5c63197e GIT binary patch literal 8126 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 Y4@b3#=KW(SRR91007*qoM6N<$g1r2tp8x;= literal 0 HcmV?d00001 diff --git a/src/gui/doc/snippets/code/doc_src_richtext.cpp b/src/gui/doc/snippets/code/doc_src_richtext.cpp new file mode 100644 index 0000000..37d4171 --- /dev/null +++ b/src/gui/doc/snippets/code/doc_src_richtext.cpp @@ -0,0 +1,85 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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$ +** +****************************************************************************/ + +//! [0] +QTextDocument *newDocument = new QTextDocument; +//! [0] + + +//! [1] +QTextEdit *editor = new QTextEdit; +QTextDocument *editorDocument = editor->document(); +//! [1] + + +//! [2] +QTextEdit *editor = new QTextEdit(parent); +editor->setHtml(aStringContainingHTMLtext); +editor->show(); +//! [2] + + +//! [3] +QTextDocument *document = editor->document(); +//! [3] + + +//! [4] +QTextCursor cursor = editor->textCursor(); +//! [4] + + +//! [5] +editor->setTextCursor(cursor); +//! [5] + + +//! [6] +textEdit.show(); + +textCursor.beginEditBlock(); + +for (int i = 0; i < 1000; ++i) { + textCursor.insertBlock(); + textCursor.insertText(paragraphText.at(i)); +} + +textCursor.endEditBlock(); +//! [6] diff --git a/src/gui/doc/snippets/code/doc_src_richtext.qdoc b/src/gui/doc/snippets/code/doc_src_richtext.qdoc new file mode 100644 index 0000000..4cc947b --- /dev/null +++ b/src/gui/doc/snippets/code/doc_src_richtext.qdoc @@ -0,0 +1,43 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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$ +** +****************************************************************************/ + +//! [7] + +//! [7] diff --git a/src/gui/doc/snippets/plaintextlayout/main.cpp b/src/gui/doc/snippets/plaintextlayout/main.cpp new file mode 100644 index 0000000..3b10af4 --- /dev/null +++ b/src/gui/doc/snippets/plaintextlayout/main.cpp @@ -0,0 +1,52 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 "window.h" + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + Window *window = new Window; + window->resize(337, 343); + window->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/plaintextlayout/plaintextlayout.pro b/src/gui/doc/snippets/plaintextlayout/plaintextlayout.pro new file mode 100644 index 0000000..6283406 --- /dev/null +++ b/src/gui/doc/snippets/plaintextlayout/plaintextlayout.pro @@ -0,0 +1,3 @@ +HEADERS = window.h +SOURCES = main.cpp \ + window.cpp diff --git a/src/gui/doc/snippets/plaintextlayout/window.cpp b/src/gui/doc/snippets/plaintextlayout/window.cpp new file mode 100644 index 0000000..901cfb4 --- /dev/null +++ b/src/gui/doc/snippets/plaintextlayout/window.cpp @@ -0,0 +1,108 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +#include "window.h" + +Window::Window(QWidget *parent) + : QWidget(parent) +{ + text = QString("Support for text rendering and layout in Qt 4 has been " + "redesigned around a system that allows textual content to " + "be represented in a more flexible way than was possible " + "with Qt 3. Qt 4 also provides a more convenient " + "programming interface for editing documents. These " + "improvements are made available through a reimplementation " + "of the existing text rendering engine, and the " + "introduction of several new classes. " + "See the relevant module overview for a detailed discussion " + "of this framework. The following sections provide a brief " + "overview of the main concepts behind Scribe."); + + setWindowTitle(tr("Plain Text Layout")); +} + +void Window::paintEvent(QPaintEvent *event) +{ +//! [0] + QTextLayout textLayout(text, font); + qreal margin = 10; + qreal radius = qMin(width()/2.0, height()/2.0) - margin; + QFontMetrics fm(font); + + qreal lineHeight = fm.height(); + qreal y = 0; + + textLayout.beginLayout(); + + while (1) { + // create a new line + QTextLine line = textLayout.createLine(); + if (!line.isValid()) + break; + + qreal x1 = qMax(0.0, pow(pow(radius,2)-pow(radius-y,2), 0.5)); + qreal x2 = qMax(0.0, pow(pow(radius,2)-pow(radius-(y+lineHeight),2), 0.5)); + qreal x = qMax(x1, x2) + margin; + qreal lineWidth = (width() - margin) - x; + + line.setLineWidth(lineWidth); + line.setPosition(QPointF(x, margin+y)); + y += line.height(); + } + + textLayout.endLayout(); + + QPainter painter; + painter.begin(this); + painter.setRenderHint(QPainter::Antialiasing); + painter.fillRect(rect(), Qt::white); + painter.setBrush(QBrush(Qt::black)); + painter.setPen(QPen(Qt::black)); + textLayout.draw(&painter, QPoint(0,0)); + + painter.setBrush(QBrush(QColor("#a6ce39"))); + painter.setPen(QPen(Qt::black)); + painter.drawEllipse(QRectF(-radius, margin, 2*radius, 2*radius)); + painter.end(); +//! [0] +} diff --git a/src/gui/doc/snippets/plaintextlayout/window.h b/src/gui/doc/snippets/plaintextlayout/window.h new file mode 100644 index 0000000..d6292de --- /dev/null +++ b/src/gui/doc/snippets/plaintextlayout/window.h @@ -0,0 +1,61 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +class Window : public QWidget +{ + Q_OBJECT + +public: + Window(QWidget *parent = 0); + +protected: + void paintEvent(QPaintEvent *event); + +private: + QFont font; + QString text; +}; + +#endif diff --git a/src/gui/doc/snippets/scribe-overview/main.cpp b/src/gui/doc/snippets/scribe-overview/main.cpp new file mode 100644 index 0000000..96d1b7a --- /dev/null +++ b/src/gui/doc/snippets/scribe-overview/main.cpp @@ -0,0 +1,73 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +void mergeFormat(QTextEdit *edit) +{ +//! [0] + QTextDocument *document = edit->document(); + QTextCursor cursor(document); + + cursor.movePosition(QTextCursor::Start); + cursor.movePosition(QTextCursor::EndOfLine, QTextCursor::KeepAnchor); + + QTextCharFormat format; + format.setFontWeight(QFont::Bold); + + cursor.mergeCharFormat(format); +//! [0] +} + +int main(int argc, char *argv[]) +{ + QWidget *parent = 0; + QString aStringContainingHTMLtext("

Scribe Overview

"); + + QApplication app(argc, argv); + +//! [1] + QTextEdit *editor = new QTextEdit(parent); + editor->setHtml(aStringContainingHTMLtext); + editor->show(); +//! [1] + + return app.exec(); +} diff --git a/src/gui/doc/snippets/scribe-overview/scribe-overview.pro b/src/gui/doc/snippets/scribe-overview/scribe-overview.pro new file mode 100644 index 0000000..16181f2 --- /dev/null +++ b/src/gui/doc/snippets/scribe-overview/scribe-overview.pro @@ -0,0 +1 @@ +SOURCES = main.cpp diff --git a/src/gui/doc/snippets/textblock-formats/main.cpp b/src/gui/doc/snippets/textblock-formats/main.cpp new file mode 100644 index 0000000..2f87341 --- /dev/null +++ b/src/gui/doc/snippets/textblock-formats/main.cpp @@ -0,0 +1,118 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +QString tr(const char *text) +{ + return QApplication::translate(text, text); +} + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + +//! [0] + QTextEdit *editor = new QTextEdit(); + QTextCursor cursor(editor->textCursor()); +//! [0] + cursor.movePosition(QTextCursor::Start); + + QTextBlockFormat blockFormat = cursor.blockFormat(); + blockFormat.setTopMargin(4); + blockFormat.setLeftMargin(4); + blockFormat.setRightMargin(4); + blockFormat.setBottomMargin(4); + + cursor.setBlockFormat(blockFormat); + cursor.insertText(tr("This contains plain text inside a " + "text block with margins to keep it separate " + "from other parts of the document.")); + + cursor.insertBlock(); + +//! [1] + QTextBlockFormat backgroundFormat = blockFormat; + backgroundFormat.setBackground(QColor("lightGray")); + + cursor.setBlockFormat(backgroundFormat); +//! [1] + cursor.insertText(tr("The background color of a text block can be " + "changed to highlight text.")); + + cursor.insertBlock(); + + QTextBlockFormat rightAlignedFormat = blockFormat; + rightAlignedFormat.setAlignment(Qt::AlignRight); + + cursor.setBlockFormat(rightAlignedFormat); + cursor.insertText(tr("The alignment of the text within a block is " + "controlled by the alignment properties of " + "the block itself. This text block is " + "right-aligned.")); + + cursor.insertBlock(); + + QTextBlockFormat paragraphFormat = blockFormat; + paragraphFormat.setAlignment(Qt::AlignJustify); + paragraphFormat.setTextIndent(32); + + cursor.setBlockFormat(paragraphFormat); + cursor.insertText(tr("Text can be formatted so that the first " + "line in a paragraph has its own margin. " + "This makes the text more readable.")); + + cursor.insertBlock(); + + QTextBlockFormat reverseFormat = blockFormat; + reverseFormat.setAlignment(Qt::AlignJustify); + reverseFormat.setTextIndent(32); + + cursor.setBlockFormat(reverseFormat); + cursor.insertText(tr("The direction of the text can be reversed. " + "This is useful for right-to-left " + "languages.")); + + editor->setWindowTitle(tr("Text Block Formats")); + editor->resize(480, 480); + editor->show(); + + return app.exec(); +} diff --git a/src/gui/doc/snippets/textblock-formats/textblock-formats.pro b/src/gui/doc/snippets/textblock-formats/textblock-formats.pro new file mode 100644 index 0000000..d664835 --- /dev/null +++ b/src/gui/doc/snippets/textblock-formats/textblock-formats.pro @@ -0,0 +1,2 @@ +QT += xml +SOURCES = main.cpp diff --git a/src/gui/doc/snippets/textblock-fragments/main.cpp b/src/gui/doc/snippets/textblock-fragments/main.cpp new file mode 100644 index 0000000..bc9eb83 --- /dev/null +++ b/src/gui/doc/snippets/textblock-fragments/main.cpp @@ -0,0 +1,52 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 = new MainWindow; + window->resize(640, 480); + window->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textblock-fragments/mainwindow.cpp b/src/gui/doc/snippets/textblock-fragments/mainwindow.cpp new file mode 100644 index 0000000..0771359 --- /dev/null +++ b/src/gui/doc/snippets/textblock-fragments/mainwindow.cpp @@ -0,0 +1,148 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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" +#include "xmlwriter.h" + +MainWindow::MainWindow() +{ + QMenu *fileMenu = new QMenu(tr("&File")); + + QAction *saveAction = fileMenu->addAction(tr("&Save...")); + saveAction->setShortcut(tr("Ctrl+S")); + + QAction *quitAction = fileMenu->addAction(tr("E&xit")); + quitAction->setShortcut(tr("Ctrl+Q")); + + QMenu *insertMenu = new QMenu(tr("&Insert")); + + QAction *calendarAction = insertMenu->addAction(tr("&Calendar")); + calendarAction->setShortcut(tr("Ctrl+I")); + + menuBar()->addMenu(fileMenu); + menuBar()->addMenu(insertMenu); + + editor = new QTextEdit(this); + + connect(saveAction, SIGNAL(triggered()), this, SLOT(saveFile())); + connect(quitAction, SIGNAL(triggered()), this, SLOT(close())); + connect(calendarAction, SIGNAL(triggered()), this, SLOT(insertCalendar())); + + setCentralWidget(editor); + setWindowTitle(tr("Text Document Writer")); +} + +void MainWindow::saveFile() +{ + QString fileName = QFileDialog::getSaveFileName(this, + tr("Save document as:"), "", tr("XML (*.xml)")); + + if (!fileName.isEmpty()) { + if (writeXml(fileName)) + setWindowTitle(fileName); + else + QMessageBox::warning(this, tr("Warning"), + tr("Failed to save the document."), QMessageBox::Cancel, + QMessageBox::NoButton); + } +} + +void MainWindow::insertCalendar() +{ + QTextCursor cursor(editor->textCursor()); + cursor.movePosition(QTextCursor::Start); + + QTextCharFormat format(cursor.charFormat()); + format.setFontFamily("Courier"); + + QTextCharFormat boldFormat = format; + boldFormat.setFontWeight(QFont::Bold); + + cursor.insertBlock(); + cursor.insertText(" ", boldFormat); + + QDate date = QDate::currentDate(); + int year = date.year(), month = date.month(); + + for (int weekDay = 1; weekDay <= 7; ++weekDay) { + cursor.insertText(QString("%1 ").arg(QDate::shortDayName(weekDay), 3), + boldFormat); + } + + cursor.insertBlock(); + cursor.insertText(" ", format); + + for (int column = 1; column < QDate(year, month, 1).dayOfWeek(); ++column) { + cursor.insertText(" ", format); + } + + for (int day = 1; day <= date.daysInMonth(); ++day) { + int weekDay = QDate(year, month, day).dayOfWeek(); + + if (QDate(year, month, day) == date) + cursor.insertText(QString("%1 ").arg(day, 3), boldFormat); + else + cursor.insertText(QString("%1 ").arg(day, 3), format); + + if (weekDay == 7) { + cursor.insertBlock(); + cursor.insertText(" ", format); + } + } +} + +bool MainWindow::writeXml(const QString &fileName) +{ + XmlWriter documentWriter(editor->document()); + + QDomDocument *domDocument = documentWriter.toXml(); + QFile file(fileName); + + if (file.open(QFile::WriteOnly)) { + QTextStream textStream(&file); + + textStream << domDocument->toByteArray(1); + return true; + } + else + return false; +} diff --git a/src/gui/doc/snippets/textblock-fragments/mainwindow.h b/src/gui/doc/snippets/textblock-fragments/mainwindow.h new file mode 100644 index 0000000..cfe504a --- /dev/null +++ b/src/gui/doc/snippets/textblock-fragments/mainwindow.h @@ -0,0 +1,65 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +class QTextEdit; + +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(); + +public slots: + void insertCalendar(); + void saveFile(); + +private: + bool writeXml(const QString &fileName); + + QTextEdit *editor; +}; + +#endif diff --git a/src/gui/doc/snippets/textblock-fragments/textblock-fragments.pro b/src/gui/doc/snippets/textblock-fragments/textblock-fragments.pro new file mode 100644 index 0000000..83ed78e --- /dev/null +++ b/src/gui/doc/snippets/textblock-fragments/textblock-fragments.pro @@ -0,0 +1,6 @@ +QT += xml +HEADERS = mainwindow.h \ + xmlwriter.h +SOURCES = main.cpp \ + mainwindow.cpp \ + xmlwriter.cpp diff --git a/src/gui/doc/snippets/textblock-fragments/xmlwriter.h b/src/gui/doc/snippets/textblock-fragments/xmlwriter.h new file mode 100644 index 0000000..23bda6b --- /dev/null +++ b/src/gui/doc/snippets/textblock-fragments/xmlwriter.h @@ -0,0 +1,64 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 XMLWRITER_H +#define XMLWRITER_H + +#include + +class QTextDocument; + +class XmlWriter +{ +public: + XmlWriter(QTextDocument *document) : textDocument(document) {} + QDomDocument *toXml(); + +private: + void readFragment(const QTextBlock ¤tBlock, QDomElement blockElement, + QDomDocument *document); + void processBlock(const QTextBlock ¤tBlock); + void processFragment(const QTextFragment ¤tFragment); + + QDomDocument *document; + QTextDocument *textDocument; +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-blocks/main.cpp b/src/gui/doc/snippets/textdocument-blocks/main.cpp new file mode 100644 index 0000000..bc9eb83 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-blocks/main.cpp @@ -0,0 +1,52 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 = new MainWindow; + window->resize(640, 480); + window->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-blocks/mainwindow.cpp b/src/gui/doc/snippets/textdocument-blocks/mainwindow.cpp new file mode 100644 index 0000000..aca4406 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-blocks/mainwindow.cpp @@ -0,0 +1,156 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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" +#include "xmlwriter.h" + +MainWindow::MainWindow() +{ + QMenu *fileMenu = new QMenu(tr("&File")); + + QAction *saveAction = fileMenu->addAction(tr("&Save...")); + saveAction->setShortcut(tr("Ctrl+S")); + + QAction *quitAction = fileMenu->addAction(tr("E&xit")); + quitAction->setShortcut(tr("Ctrl+Q")); + + QMenu *insertMenu = new QMenu(tr("&Insert")); + + QAction *calendarAction = insertMenu->addAction(tr("&Calendar")); + calendarAction->setShortcut(tr("Ctrl+I")); + + menuBar()->addMenu(fileMenu); + menuBar()->addMenu(insertMenu); + +//! [0] + editor = new QTextEdit(this); +//! [0] + + connect(saveAction, SIGNAL(triggered()), this, SLOT(saveFile())); + connect(quitAction, SIGNAL(triggered()), this, SLOT(close())); + connect(calendarAction, SIGNAL(triggered()), this, SLOT(insertCalendar())); + + setCentralWidget(editor); + setWindowTitle(tr("Text Document Writer")); +} + +void MainWindow::saveFile() +{ + QString fileName = QFileDialog::getSaveFileName(this, + tr("Save document as:"), "", tr("XML (*.xml)")); + + if (!fileName.isEmpty()) { + if (writeXml(fileName)) + setWindowTitle(fileName); + else + QMessageBox::warning(this, tr("Warning"), + tr("Failed to save the document."), QMessageBox::Cancel, + QMessageBox::NoButton); + } +} + +void MainWindow::insertCalendar() +{ +//! [1] + QTextCursor cursor(editor->textCursor()); + cursor.movePosition(QTextCursor::Start); + + QTextCharFormat format(cursor.charFormat()); + format.setFontFamily("Courier"); + + QTextCharFormat boldFormat = format; + boldFormat.setFontWeight(QFont::Bold); + + cursor.insertBlock(); + cursor.insertText(" ", boldFormat); + + QDate date = QDate::currentDate(); + int year = date.year(), month = date.month(); + + for (int weekDay = 1; weekDay <= 7; ++weekDay) { + cursor.insertText(QString("%1 ").arg(QDate::shortDayName(weekDay), 3), + boldFormat); + } + + cursor.insertBlock(); + cursor.insertText(" ", format); + + for (int column = 1; column < QDate(year, month, 1).dayOfWeek(); ++column) { + cursor.insertText(" ", format); + } + + for (int day = 1; day <= date.daysInMonth(); ++day) { +//! [1] //! [2] + int weekDay = QDate(year, month, day).dayOfWeek(); + + if (QDate(year, month, day) == date) + cursor.insertText(QString("%1 ").arg(day, 3), boldFormat); + else + cursor.insertText(QString("%1 ").arg(day, 3), format); + + if (weekDay == 7) { + cursor.insertBlock(); + cursor.insertText(" ", format); + } +//! [2] //! [3] + } +//! [3] +} + +bool MainWindow::writeXml(const QString &fileName) +{ + XmlWriter documentWriter(editor->document()); + + QDomDocument *domDocument = documentWriter.toXml(); + QFile file(fileName); + + if (file.open(QFile::WriteOnly)) { + QTextStream textStream(&file); + textStream.setCodec(QTextCodec::codecForName("UTF-8")); + + textStream << domDocument->toString(1).toUtf8(); + file.close(); + return true; + } + else + return false; +} diff --git a/src/gui/doc/snippets/textdocument-blocks/mainwindow.h b/src/gui/doc/snippets/textdocument-blocks/mainwindow.h new file mode 100644 index 0000000..cfe504a --- /dev/null +++ b/src/gui/doc/snippets/textdocument-blocks/mainwindow.h @@ -0,0 +1,65 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +class QTextEdit; + +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(); + +public slots: + void insertCalendar(); + void saveFile(); + +private: + bool writeXml(const QString &fileName); + + QTextEdit *editor; +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-blocks/textdocument-blocks.pro b/src/gui/doc/snippets/textdocument-blocks/textdocument-blocks.pro new file mode 100644 index 0000000..83ed78e --- /dev/null +++ b/src/gui/doc/snippets/textdocument-blocks/textdocument-blocks.pro @@ -0,0 +1,6 @@ +QT += xml +HEADERS = mainwindow.h \ + xmlwriter.h +SOURCES = main.cpp \ + mainwindow.cpp \ + xmlwriter.cpp diff --git a/src/gui/doc/snippets/textdocument-blocks/xmlwriter.cpp b/src/gui/doc/snippets/textdocument-blocks/xmlwriter.cpp new file mode 100644 index 0000000..2c691f8 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-blocks/xmlwriter.cpp @@ -0,0 +1,84 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 "xmlwriter.h" + +QDomDocument *XmlWriter::toXml() +{ + QDomImplementation implementation; + QDomDocumentType docType = implementation.createDocumentType( + "scribe-document", "scribe", "qt.nokia.com/scribe"); + + document = new QDomDocument(docType); + + // ### This processing instruction is required to ensure that any kind + // of encoding is given when the document is written. + QDomProcessingInstruction process = document->createProcessingInstruction( + "xml", "version=\"1.0\" encoding=\"utf-8\""); + document->appendChild(process); + + QDomElement documentElement = document->createElement("document"); + document->appendChild(documentElement); + + QTextBlock firstBlock = textDocument->begin(); + createItems(documentElement, firstBlock); + + return document; +} + +void XmlWriter::createItems(QDomElement &parent, const QTextBlock &block) +{ + QTextBlock currentBlock = block; + + while (currentBlock.isValid()) { + QDomElement blockElement = document->createElement("block"); + blockElement.setAttribute("length", currentBlock.length()); + parent.appendChild(blockElement); + + if (!(currentBlock.text().isNull())) { + QDomText textNode = document->createTextNode(currentBlock.text()); + blockElement.appendChild(textNode); + } + + currentBlock = currentBlock.next(); + } +} diff --git a/src/gui/doc/snippets/textdocument-blocks/xmlwriter.h b/src/gui/doc/snippets/textdocument-blocks/xmlwriter.h new file mode 100644 index 0000000..e0afaf5 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-blocks/xmlwriter.h @@ -0,0 +1,61 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 XMLWRITER_H +#define XMLWRITER_H + +#include + +class QTextDocument; + +class XmlWriter +{ +public: + XmlWriter(QTextDocument *document) : textDocument(document) {} + QDomDocument *toXml(); + +private: + void createItems(QDomElement &parent, const QTextBlock &block); + + QDomDocument *document; + QTextDocument *textDocument; +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-charformats/main.cpp b/src/gui/doc/snippets/textdocument-charformats/main.cpp new file mode 100644 index 0000000..cedb090 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-charformats/main.cpp @@ -0,0 +1,92 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +QString tr(const char *text) +{ + return QApplication::translate(text, text); +} + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + QTextEdit *editor = new QTextEdit(); + + QTextCursor cursor(editor->textCursor()); + cursor.movePosition(QTextCursor::Start); + + QTextCharFormat plainFormat(cursor.charFormat()); + + QTextCharFormat headingFormat = plainFormat; + headingFormat.setFontWeight(QFont::Bold); + headingFormat.setFontPointSize(16); + + QTextCharFormat emphasisFormat = plainFormat; + emphasisFormat.setFontItalic(true); + + QTextCharFormat qtFormat = plainFormat; + qtFormat.setForeground(QColor("#990000")); + + QTextCharFormat underlineFormat = plainFormat; + underlineFormat.setFontUnderline(true); + +//! [0] + cursor.insertText(tr("Character formats"), + headingFormat); + + cursor.insertBlock(); + + cursor.insertText(tr("Text can be displayed in a variety of " + "different character formats. "), plainFormat); + cursor.insertText(tr("We can emphasize text by ")); + cursor.insertText(tr("making it italic"), emphasisFormat); +//! [0] + cursor.insertText(tr(", give it a "), plainFormat); + cursor.insertText(tr("different color "), qtFormat); + cursor.insertText(tr("to the default text color, "), plainFormat); + cursor.insertText(tr("underline it"), underlineFormat); + cursor.insertText(tr(", and use many other effects."), plainFormat); + + editor->setWindowTitle(tr("Text Document Character Formats")); + editor->resize(320, 480); + editor->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-charformats/textdocument-charformats.pro b/src/gui/doc/snippets/textdocument-charformats/textdocument-charformats.pro new file mode 100644 index 0000000..16181f2 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-charformats/textdocument-charformats.pro @@ -0,0 +1 @@ +SOURCES = main.cpp diff --git a/src/gui/doc/snippets/textdocument-cursors/main.cpp b/src/gui/doc/snippets/textdocument-cursors/main.cpp new file mode 100644 index 0000000..f6afae5 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-cursors/main.cpp @@ -0,0 +1,79 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +QString tr(const char *text) +{ + return QApplication::translate(text, text); +} + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + QTextEdit *editor = new QTextEdit; + +//! [0] + QTextDocument *document = editor->document(); + QTextCursor redCursor(document); +//! [0] //! [1] + QTextCursor blueCursor(document); +//! [1] + + QTextCharFormat redFormat(redCursor.charFormat()); + redFormat.setForeground(Qt::red); + QTextCharFormat blueFormat(blueCursor.charFormat()); + blueFormat.setForeground(Qt::blue); + + redCursor.setCharFormat(redFormat); + blueCursor.setCharFormat(blueFormat); + + for (int i = 0; i < 20; ++i) { + if (i % 2 == 0) + redCursor.insertText(tr("%1 ").arg(i), redFormat); + if (i % 5 == 0) + blueCursor.insertText(tr("%1 ").arg(i), blueFormat); + } + + editor->setWindowTitle(tr("Text Document Cursors")); + editor->resize(320, 480); + editor->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-cursors/textdocument-cursors.pro b/src/gui/doc/snippets/textdocument-cursors/textdocument-cursors.pro new file mode 100644 index 0000000..16181f2 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-cursors/textdocument-cursors.pro @@ -0,0 +1 @@ +SOURCES = main.cpp diff --git a/src/gui/doc/snippets/textdocument-find/main.cpp b/src/gui/doc/snippets/textdocument-find/main.cpp new file mode 100644 index 0000000..44c26a8 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-find/main.cpp @@ -0,0 +1,91 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +QString tr(const char *text) +{ + return QApplication::translate(text, text); +} + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + QTextEdit *editor = new QTextEdit(); + + QTextCursor cursor(editor->textCursor()); + cursor.movePosition(QTextCursor::Start); + + QTextCharFormat plainFormat(cursor.charFormat()); + QTextCharFormat colorFormat = plainFormat; + colorFormat.setForeground(Qt::red); + + cursor.insertText(tr("Text can be displayed in a variety of " + "different character " + "formats. "), plainFormat); + cursor.insertText(tr("We can emphasize text by making it ")); + cursor.insertText(tr("italic, give it a different color ")); + cursor.insertText(tr("to the default text color, underline it, ")); + cursor.insertText(tr("and use many other effects.")); + + QString searchString = tr("text"); + + QTextDocument *document = editor->document(); +//! [0] + QTextCursor newCursor(document); + + while (!newCursor.isNull() && !newCursor.atEnd()) { + newCursor = document->find(searchString, newCursor); + + if (!newCursor.isNull()) { + newCursor.movePosition(QTextCursor::WordRight, + QTextCursor::KeepAnchor); + + newCursor.mergeCharFormat(colorFormat); + } +//! [0] //! [1] + } +//! [1] + + editor->setWindowTitle(tr("Text Document Find")); + editor->resize(320, 480); + editor->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-find/textdocument-find.pro b/src/gui/doc/snippets/textdocument-find/textdocument-find.pro new file mode 100644 index 0000000..16181f2 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-find/textdocument-find.pro @@ -0,0 +1 @@ +SOURCES = main.cpp diff --git a/src/gui/doc/snippets/textdocument-frames/main.cpp b/src/gui/doc/snippets/textdocument-frames/main.cpp new file mode 100644 index 0000000..3c065cd --- /dev/null +++ b/src/gui/doc/snippets/textdocument-frames/main.cpp @@ -0,0 +1,53 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 = new MainWindow; + window->resize(480, 480); + window->show(); + return app.exec(); +} + diff --git a/src/gui/doc/snippets/textdocument-frames/mainwindow.cpp b/src/gui/doc/snippets/textdocument-frames/mainwindow.cpp new file mode 100644 index 0000000..4fca7d0 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-frames/mainwindow.cpp @@ -0,0 +1,161 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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" +#include "xmlwriter.h" + +MainWindow::MainWindow() +{ + QMenu *fileMenu = new QMenu(tr("&File")); + + QAction *saveAction = fileMenu->addAction(tr("&Save...")); + saveAction->setShortcut(tr("Ctrl+S")); + + QAction *quitAction = fileMenu->addAction(tr("E&xit")); + quitAction->setShortcut(tr("Ctrl+Q")); + + menuBar()->addMenu(fileMenu); + editor = new QTextEdit(); + + QTextCursor cursor(editor->textCursor()); + cursor.movePosition(QTextCursor::Start); + + QTextFrame *mainFrame = cursor.currentFrame(); + + QTextCharFormat plainCharFormat; + QTextCharFormat boldCharFormat; + boldCharFormat.setFontWeight(QFont::Bold); +/* main frame +//! [0] + QTextFrame *mainFrame = cursor.currentFrame(); + cursor.insertText(...); +//! [0] +*/ + cursor.insertText("Text documents are represented by the " + "QTextDocument class, rather than by QString objects. " + "Each QTextDocument object contains information about " + "the document's internal representation, its structure, " + "and keeps track of modifications to provide undo/redo " + "facilities. This approach allows features such as the " + "layout management to be delegated to specialized " + "classes, but also provides a focus for the framework.", + plainCharFormat); + +//! [1] + QTextFrameFormat frameFormat; + frameFormat.setMargin(32); + frameFormat.setPadding(8); + frameFormat.setBorder(4); +//! [1] + cursor.insertFrame(frameFormat); + +/* insert frame +//! [2] + cursor.insertFrame(frameFormat); + cursor.insertText(...); +//! [2] +*/ + cursor.insertText("Documents are either converted from external sources " + "or created from scratch using Qt. The creation process " + "can done by an editor widget, such as QTextEdit, or by " + "explicit calls to the Scribe API.", boldCharFormat); + + cursor = mainFrame->lastCursorPosition(); +/* last cursor +//! [3] + cursor = mainFrame->lastCursorPosition(); + cursor.insertText(...); +//! [3] +*/ + cursor.insertText("There are two complementary ways to visualize the " + "contents of a document: as a linear buffer that is " + "used by editors to modify the contents, and as an " + "object hierarchy containing structural information " + "that is useful to layout engines. In the hierarchical " + "model, the objects generally correspond to visual " + "elements such as frames, tables, and lists. At a lower " + "level, these elements describe properties such as the " + "style of text used and its alignment. The linear " + "representation of the document is used for editing and " + "manipulation of the document's contents.", + plainCharFormat); + + + connect(saveAction, SIGNAL(triggered()), this, SLOT(saveFile())); + connect(quitAction, SIGNAL(triggered()), this, SLOT(close())); + + setCentralWidget(editor); + setWindowTitle(tr("Text Document Frames")); +} + +void MainWindow::saveFile() +{ + QString fileName = QFileDialog::getSaveFileName(this, + tr("Save document as:"), "", tr("XML (*.xml)")); + + if (!fileName.isEmpty()) { + if (writeXml(fileName)) + setWindowTitle(fileName); + else + QMessageBox::warning(this, tr("Warning"), + tr("Failed to save the document."), QMessageBox::Cancel, + QMessageBox::NoButton); + } +} +bool MainWindow::writeXml(const QString &fileName) +{ + XmlWriter documentWriter(editor->document()); + + QDomDocument *domDocument = documentWriter.toXml(); + QFile file(fileName); + + if (file.open(QFile::WriteOnly)) { + QTextStream textStream(&file); + textStream.setCodec(QTextCodec::codecForName("UTF-8")); + + textStream << domDocument->toString(1).toUtf8(); + file.close(); + return true; + } + else + return false; +} diff --git a/src/gui/doc/snippets/textdocument-frames/mainwindow.h b/src/gui/doc/snippets/textdocument-frames/mainwindow.h new file mode 100644 index 0000000..4f25902 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-frames/mainwindow.h @@ -0,0 +1,64 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +class QTextEdit; + +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(); + +public slots: + void saveFile(); + +private: + bool writeXml(const QString &fileName); + + QTextEdit *editor; +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-frames/textdocument-frames.pro b/src/gui/doc/snippets/textdocument-frames/textdocument-frames.pro new file mode 100644 index 0000000..91ae50f --- /dev/null +++ b/src/gui/doc/snippets/textdocument-frames/textdocument-frames.pro @@ -0,0 +1,6 @@ +SOURCES = main.cpp \ + mainwindow.cpp \ + xmlwriter.cpp +HEADERS = mainwindow.h \ + xmlwriter.h +QT += xml diff --git a/src/gui/doc/snippets/textdocument-frames/xmlwriter.cpp b/src/gui/doc/snippets/textdocument-frames/xmlwriter.cpp new file mode 100644 index 0000000..d4d8d83 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-frames/xmlwriter.cpp @@ -0,0 +1,118 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 "xmlwriter.h" + +QDomDocument *XmlWriter::toXml() +{ + QDomImplementation implementation; + QDomDocumentType docType = implementation.createDocumentType( + "scribe-document", "scribe", "qt.nokia.com/scribe"); + + document = new QDomDocument(docType); + + // ### This processing instruction is required to ensure that any kind + // of encoding is given when the document is written. + QDomProcessingInstruction process = document->createProcessingInstruction( + "xml", "version=\"1.0\" encoding=\"utf-8\""); + document->appendChild(process); + + QDomElement documentElement = document->createElement("document"); + document->appendChild(documentElement); + +//! [0] + QTextFrame *root = textDocument->rootFrame(); +//! [0] + + if (root) + processFrame(documentElement, root); + + return document; +} + +void XmlWriter::processBlock(QDomElement &parent, const QTextBlock &block) +{ + QDomElement blockElement = document->createElement("block"); + blockElement.setAttribute("position", block.position()); + blockElement.setAttribute("length", block.length()); + parent.appendChild(blockElement); + + QTextBlock::iterator it; + for (it = block.begin(); !(it.atEnd()); ++it) { + QTextFragment fragment = it.fragment(); + + if (fragment.isValid()) { + QDomElement fragmentElement = document->createElement("fragment"); + blockElement.appendChild(fragmentElement); + + fragmentElement.setAttribute("length", fragment.length()); + QDomText fragmentText = document->createTextNode(fragment.text()); + + fragmentElement.appendChild(fragmentText); + } + } +} + +void XmlWriter::processFrame(QDomElement &parent, QTextFrame *frame) +{ + QDomElement frameElement = document->createElement("frame"); + frameElement.setAttribute("begin", frame->firstPosition()); + frameElement.setAttribute("end", frame->lastPosition()); + parent.appendChild(frameElement); + +//! [1] + QDomElement frameElement = ... + + QTextFrame::iterator it; + for (it = frame->begin(); !(it.atEnd()); ++it) { + + QTextFrame *childFrame = it.currentFrame(); + QTextBlock childBlock = it.currentBlock(); + + if (childFrame) +//! [1] //! [2] + processFrame(frameElement, childFrame); + else if (childBlock.isValid()) + processBlock(frameElement, childBlock); + } +//! [2] +} diff --git a/src/gui/doc/snippets/textdocument-frames/xmlwriter.h b/src/gui/doc/snippets/textdocument-frames/xmlwriter.h new file mode 100644 index 0000000..5953d93 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-frames/xmlwriter.h @@ -0,0 +1,64 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 XMLWRITER_H +#define XMLWRITER_H + +#include + +class QTextDocument; + +class XmlWriter +{ +public: + XmlWriter(QTextDocument *document) : textDocument(document) {} + QDomDocument *toXml(); + +private: + void processBlock(QDomElement &parent, const QTextBlock &block); + void processFrame(QDomElement &parent, QTextFrame *frame); + + QDomDocument *document; +//! [0] + QTextDocument *textDocument; +//! [0] +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-imagedrop/main.cpp b/src/gui/doc/snippets/textdocument-imagedrop/main.cpp new file mode 100644 index 0000000..771d9cf --- /dev/null +++ b/src/gui/doc/snippets/textdocument-imagedrop/main.cpp @@ -0,0 +1,52 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 "textedit.h" + +int main(int argc, char * argv[]) +{ + QApplication app(argc, argv); + + TextEdit *textEdit = new TextEdit; + textEdit->show(); + + return app.exec(); +} \ No newline at end of file diff --git a/src/gui/doc/snippets/textdocument-imagedrop/textdocument-imagedrop.pro b/src/gui/doc/snippets/textdocument-imagedrop/textdocument-imagedrop.pro new file mode 100644 index 0000000..96d3038 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-imagedrop/textdocument-imagedrop.pro @@ -0,0 +1,2 @@ +SOURCES = textedit.cpp main.cpp +HEADERS = textedit.h \ No newline at end of file diff --git a/src/gui/doc/snippets/textdocument-imagedrop/textedit.h b/src/gui/doc/snippets/textdocument-imagedrop/textedit.h new file mode 100644 index 0000000..cfa7033 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-imagedrop/textedit.h @@ -0,0 +1,56 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 TEXTEDIT_H +#define TEXTEDIT_H + +#include + +class TextEdit : public QTextEdit +{ + Q_OBJECT + +public: + TextEdit(QWidget *parent=0); + bool canInsertFromMimeData( const QMimeData *source ) const; + void insertFromMimeData( const QMimeData *source ); +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-imageformat/images.qrc b/src/gui/doc/snippets/textdocument-imageformat/images.qrc new file mode 100644 index 0000000..6473daf --- /dev/null +++ b/src/gui/doc/snippets/textdocument-imageformat/images.qrc @@ -0,0 +1,6 @@ + + + images/advert.png + images/newimage.png + + diff --git a/src/gui/doc/snippets/textdocument-imageformat/images/advert.png b/src/gui/doc/snippets/textdocument-imageformat/images/advert.png new file mode 100644 index 0000000000000000000000000000000000000000..40e10d5225dc1bdb09932ea11ba2eca3d0dd72a8 GIT binary patch literal 16291 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 literal 0 HcmV?d00001 diff --git a/src/gui/doc/snippets/textdocument-imageformat/main.cpp b/src/gui/doc/snippets/textdocument-imageformat/main.cpp new file mode 100644 index 0000000..923549f --- /dev/null +++ b/src/gui/doc/snippets/textdocument-imageformat/main.cpp @@ -0,0 +1,98 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +QString tr(const char *text) +{ + return QApplication::translate(text, text); +} + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + QTextEdit *editor = new QTextEdit; + + QTextDocument *document = new QTextDocument(editor); + QTextCursor cursor(document); + + QTextImageFormat imageFormat; + imageFormat.setName(":/images/advert.png"); + cursor.insertImage(imageFormat); + + QTextBlock block = cursor.block(); + QTextFragment fragment; + QTextBlock::iterator it; + + for (it = block.begin(); !(it.atEnd()); ++it) { + fragment = it.fragment(); + + if (fragment.contains(cursor.position())) + break; + } + +//! [0] + if (fragment.isValid()) { + QTextImageFormat newImageFormat = fragment.charFormat().toImageFormat(); + + if (newImageFormat.isValid()) { + newImageFormat.setName(":/images/newimage.png"); + QTextCursor helper = cursor; + + helper.setPosition(fragment.position()); + helper.setPosition(fragment.position() + fragment.length(), + QTextCursor::KeepAnchor); + helper.setCharFormat(newImageFormat); +//! [0] //! [1] + } +//! [1] //! [2] + } +//! [2] + + cursor.insertBlock(); + cursor.insertText("Code less. Create more."); + + editor->setDocument(document); + editor->setWindowTitle(tr("Text Document Image Format")); + editor->resize(320, 480); + editor->show(); + + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-imageformat/textdocument-imageformat.pro b/src/gui/doc/snippets/textdocument-imageformat/textdocument-imageformat.pro new file mode 100644 index 0000000..1c64370 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-imageformat/textdocument-imageformat.pro @@ -0,0 +1,2 @@ +SOURCES = main.cpp +RESOURCES += images.qrc diff --git a/src/gui/doc/snippets/textdocument-images/images.qrc b/src/gui/doc/snippets/textdocument-images/images.qrc new file mode 100644 index 0000000..09e305e --- /dev/null +++ b/src/gui/doc/snippets/textdocument-images/images.qrc @@ -0,0 +1,5 @@ + + + images/advert.png + + diff --git a/src/gui/doc/snippets/textdocument-images/images/advert.png b/src/gui/doc/snippets/textdocument-images/images/advert.png new file mode 100644 index 0000000000000000000000000000000000000000..40e10d5225dc1bdb09932ea11ba2eca3d0dd72a8 GIT binary patch literal 16291 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 + +QString tr(const char *text) +{ + return QApplication::translate(text, text); +} + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + QTextEdit *editor = new QTextEdit; + +//! [0] + QTextDocument *document = new QTextDocument(editor); + QTextCursor cursor(document); +//! [0] + +//! [1] + QTextImageFormat imageFormat; + imageFormat.setName(":/images/advert.png"); + cursor.insertImage(imageFormat); +//! [1] + + cursor.insertBlock(); + cursor.insertText("Code less. Create more."); + + editor->setDocument(document); + editor->setWindowTitle(tr("Text Document Images")); + editor->resize(320, 480); + editor->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-images/textdocument-images.pro b/src/gui/doc/snippets/textdocument-images/textdocument-images.pro new file mode 100644 index 0000000..1c64370 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-images/textdocument-images.pro @@ -0,0 +1,2 @@ +SOURCES = main.cpp +RESOURCES += images.qrc diff --git a/src/gui/doc/snippets/textdocument-listitems/main.cpp b/src/gui/doc/snippets/textdocument-listitems/main.cpp new file mode 100644 index 0000000..bc9eb83 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-listitems/main.cpp @@ -0,0 +1,52 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 = new MainWindow; + window->resize(640, 480); + window->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-listitems/mainwindow.cpp b/src/gui/doc/snippets/textdocument-listitems/mainwindow.cpp new file mode 100644 index 0000000..1089a04 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-listitems/mainwindow.cpp @@ -0,0 +1,197 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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" + +MainWindow::MainWindow() +{ + QMenu *fileMenu = new QMenu(tr("&File")); + + fileMenu->addAction(tr("E&xit"), this, SLOT(close()), + QKeySequence(tr("Ctrl+Q", "File|Exit"))); + + QMenu *actionsMenu = new QMenu(tr("&Actions")); + actionsMenu->addAction(tr("&Highlight List Items"), + this, SLOT(highlightListItems())); + actionsMenu->addAction(tr("&Show Current List"), this, SLOT(showList())); + + QMenu *insertMenu = new QMenu(tr("&Insert")); + + insertMenu->addAction(tr("&List"), this, SLOT(insertList()), + QKeySequence(tr("Ctrl+L", "Insert|List"))); + + menuBar()->addMenu(fileMenu); + menuBar()->addMenu(insertMenu); + menuBar()->addMenu(actionsMenu); + + editor = new QTextEdit(this); + document = new QTextDocument(this); + editor->setDocument(document); + + setCentralWidget(editor); + setWindowTitle(tr("Text Document List Items")); +} + +void MainWindow::highlightListItems() +{ + QTextCursor cursor = editor->textCursor(); + QTextList *list = cursor.currentList(); + + if (!list) + return; + + cursor.beginEditBlock(); +//! [0] + for (int index = 0; index < list->count(); ++index) { + QTextBlock listItem = list->item(index); +//! [0] + QTextBlockFormat newBlockFormat = listItem.blockFormat(); + newBlockFormat.setBackground(Qt::lightGray); + QTextCursor itemCursor = cursor; + itemCursor.setPosition(listItem.position()); + //itemCursor.movePosition(QTextCursor::StartOfBlock); + itemCursor.movePosition(QTextCursor::EndOfBlock, + QTextCursor::KeepAnchor); + itemCursor.setBlockFormat(newBlockFormat); + /* +//! [1] + processListItem(listItem); +//! [1] + */ +//! [2] + } +//! [2] + cursor.endEditBlock(); +} + +void MainWindow::showList() +{ + QTextCursor cursor = editor->textCursor(); + QTextFrame *frame = cursor.currentFrame(); + + if (!frame) + return; + + QTreeWidget *treeWidget = new QTreeWidget; + treeWidget->setColumnCount(1); + QStringList headerLabels; + headerLabels << tr("Lists"); + treeWidget->setHeaderLabels(headerLabels); + + QTreeWidgetItem *parentItem = 0; + QTreeWidgetItem *item; + QTreeWidgetItem *lastItem = 0; + parentItems.clear(); + previousItems.clear(); + +//! [3] + QTextFrame::iterator it; + for (it = frame->begin(); !(it.atEnd()); ++it) { + + QTextBlock block = it.currentBlock(); + + if (block.isValid()) { + + QTextList *list = block.textList(); + + if (list) { + int index = list->itemNumber(block); +//! [3] + if (index == 0) { + parentItems.append(parentItem); + previousItems.append(lastItem); + listStructures.append(list); + parentItem = lastItem; + lastItem = 0; + + if (parentItem != 0) + item = new QTreeWidgetItem(parentItem, lastItem); + else + item = new QTreeWidgetItem(treeWidget, lastItem); + + } else { + + while (parentItem != 0 && listStructures.last() != list) { + listStructures.pop_back(); + parentItem = parentItems.takeLast(); + lastItem = previousItems.takeLast(); + } + if (parentItem != 0) + item = new QTreeWidgetItem(parentItem, lastItem); + else + item = new QTreeWidgetItem(treeWidget, lastItem); + } + item->setText(0, block.text()); + lastItem = item; + /* +//! [4] + processListItem(list, index); +//! [4] + */ +//! [5] + } +//! [5] //! [6] + } +//! [6] //! [7] + } +//! [7] + + treeWidget->setWindowTitle(tr("List Contents")); + treeWidget->show(); +} + +void MainWindow::insertList() +{ + QTextCursor cursor = editor->textCursor(); + cursor.beginEditBlock(); + + QTextList *list = cursor.currentList(); + QTextListFormat listFormat; + if (list) + listFormat = list->format(); + + listFormat.setStyle(QTextListFormat::ListDisc); + listFormat.setIndent(listFormat.indent() + 1); + cursor.insertList(listFormat); + + cursor.endEditBlock(); +} diff --git a/src/gui/doc/snippets/textdocument-listitems/mainwindow.h b/src/gui/doc/snippets/textdocument-listitems/mainwindow.h new file mode 100644 index 0000000..b71cfea --- /dev/null +++ b/src/gui/doc/snippets/textdocument-listitems/mainwindow.h @@ -0,0 +1,75 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 +#include +#include + +class QAction; +class QTextDocument; +class QTextEdit; +class QTextList; +class QTreeWidgetItem; + +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(); + +public slots: + void insertList(); + void highlightListItems(); + void showList(); + +private: + QString currentFile; + QTextEdit *editor; + QTextDocument *document; + QList listStructures; + QList previousItems; + QList parentItems; +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-listitems/textdocument-listitems.pro b/src/gui/doc/snippets/textdocument-listitems/textdocument-listitems.pro new file mode 100644 index 0000000..5da8d6e --- /dev/null +++ b/src/gui/doc/snippets/textdocument-listitems/textdocument-listitems.pro @@ -0,0 +1,3 @@ +HEADERS = mainwindow.h +SOURCES = main.cpp \ + mainwindow.cpp diff --git a/src/gui/doc/snippets/textdocument-printing/main.cpp b/src/gui/doc/snippets/textdocument-printing/main.cpp new file mode 100644 index 0000000..bc9eb83 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-printing/main.cpp @@ -0,0 +1,52 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 = new MainWindow; + window->resize(640, 480); + window->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-printing/mainwindow.cpp b/src/gui/doc/snippets/textdocument-printing/mainwindow.cpp new file mode 100644 index 0000000..6abe90a --- /dev/null +++ b/src/gui/doc/snippets/textdocument-printing/mainwindow.cpp @@ -0,0 +1,124 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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" + +MainWindow::MainWindow() +{ + QMenu *fileMenu = new QMenu(tr("&File")); + + fileMenu->addAction(tr("&Open..."), this, SLOT(openFile()), + QKeySequence(tr("Ctrl+O", "File|Open"))); + + printAction = fileMenu->addAction(tr("&Print..."), this, SLOT(printFile())); + printAction->setEnabled(false); + + pdfPrintAction = fileMenu->addAction(tr("Print as P&DF..."), this, SLOT(printPdf())); + pdfPrintAction->setEnabled(false); + + fileMenu->addAction(tr("E&xit"), this, SLOT(close()), + QKeySequence(tr("Ctrl+Q", "File|Exit"))); + + menuBar()->addMenu(fileMenu); + + editor = new QTextEdit(this); + document = new QTextDocument(this); + editor->setDocument(document); + + connect(editor, SIGNAL(selectionChanged()), this, SLOT(updateMenus())); + + setCentralWidget(editor); + setWindowTitle(tr("Text Document Writer")); +} + +void MainWindow::openFile() +{ + QString fileName = QFileDialog::getOpenFileName(this, + tr("Open file"), currentFile, "HTML files (*.html);;Text files (*.txt)"); + + if (!fileName.isEmpty()) { + QFileInfo info(fileName); + if (info.completeSuffix() == "html") { + QFile file(fileName); + + if (file.open(QIODevice::ReadOnly)) { + editor->setHtml(file.readAll()); + file.close(); + currentFile = fileName; + } + } else if (info.completeSuffix() == "txt") { + QFile file(fileName); + + if (file.open(QIODevice::ReadOnly)) { + editor->setPlainText(file.readAll()); + file.close(); + currentFile = fileName; + } + } + printAction->setEnabled(true); + pdfPrintAction->setEnabled(true); + } +} + +void MainWindow::printFile() +{ +//! [0] + QTextDocument *document = editor->document(); + QPrinter printer; + + QPrintDialog *dlg = new QPrintDialog(&printer, this); + if (dlg->exec() != QDialog::Accepted) + return; + + document->print(&printer); +//! [0] +} + +void MainWindow::printPdf() +{ + QPrinter printer(QPrinter::HighResolution); + printer.setOutputFormat(QPrinter::PdfFormat); + + QPrintDialog *printDialog = new QPrintDialog(&printer, this); + if (printDialog->exec() == QDialog::Accepted) + editor->document()->print(&printer); +} diff --git a/src/gui/doc/snippets/textdocument-printing/mainwindow.h b/src/gui/doc/snippets/textdocument-printing/mainwindow.h new file mode 100644 index 0000000..cce30a9 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-printing/mainwindow.h @@ -0,0 +1,72 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 +#include +#include + +class QAction; +class QTextDocument; +class QTextEdit; + +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(); + +public slots: + void openFile(); + void printFile(); + void printPdf(); + +private: + QAction *printAction; + QAction *pdfPrintAction; + QString currentFile; + QTextEdit *editor; + QTextDocument *document; +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-printing/textdocument-printing.pro b/src/gui/doc/snippets/textdocument-printing/textdocument-printing.pro new file mode 100644 index 0000000..5da8d6e --- /dev/null +++ b/src/gui/doc/snippets/textdocument-printing/textdocument-printing.pro @@ -0,0 +1,3 @@ +HEADERS = mainwindow.h +SOURCES = main.cpp \ + mainwindow.cpp diff --git a/src/gui/doc/snippets/textdocument-selections/main.cpp b/src/gui/doc/snippets/textdocument-selections/main.cpp new file mode 100644 index 0000000..bc9eb83 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-selections/main.cpp @@ -0,0 +1,52 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 = new MainWindow; + window->resize(640, 480); + window->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-selections/mainwindow.cpp b/src/gui/doc/snippets/textdocument-selections/mainwindow.cpp new file mode 100644 index 0000000..a776a92 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-selections/mainwindow.cpp @@ -0,0 +1,203 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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" + +MainWindow::MainWindow() +{ + QMenu *fileMenu = new QMenu(tr("&File")); + + fileMenu->addAction(tr("&Open..."), this, SLOT(openFile()), + QKeySequence(tr("Ctrl+O", "File|Open"))); + + QAction *quitAction = fileMenu->addAction(tr("E&xit"), this, SLOT(close())); + quitAction->setShortcut(tr("Ctrl+Q")); + + QMenu *editMenu = new QMenu(tr("&Edit")); + + cutAction = editMenu->addAction(tr("Cu&t"), this, SLOT(cutSelection())); + cutAction->setShortcut(tr("Ctrl+X")); + cutAction->setEnabled(false); + + copyAction = editMenu->addAction(tr("&Copy"), this, SLOT(copySelection())); + copyAction->setShortcut(tr("Ctrl+C")); + copyAction->setEnabled(false); + + pasteAction = editMenu->addAction(tr("&Paste"), this, SLOT(pasteSelection())); + pasteAction->setShortcut(tr("Ctrl+V")); + pasteAction->setEnabled(false); + + QMenu *selectMenu = new QMenu(tr("&Select")); + selectMenu->addAction(tr("&Word"), this, SLOT(selectWord())); + selectMenu->addAction(tr("&Line"), this, SLOT(selectLine())); + selectMenu->addAction(tr("&Block"), this, SLOT(selectBlock())); + selectMenu->addAction(tr("&Frame"), this, SLOT(selectFrame())); + + menuBar()->addMenu(fileMenu); + menuBar()->addMenu(editMenu); + menuBar()->addMenu(selectMenu); + + editor = new QTextEdit(this); + document = new QTextDocument(this); + editor->setDocument(document); + + connect(editor, SIGNAL(selectionChanged()), this, SLOT(updateMenus())); + + setCentralWidget(editor); + setWindowTitle(tr("Text Document Writer")); +} + +void MainWindow::openFile() +{ + QString fileName = QFileDialog::getOpenFileName(this, + tr("Open file"), currentFile, "HTML files (*.html);;Text files (*.txt)"); + + if (!fileName.isEmpty()) { + QFileInfo info(fileName); + if (info.completeSuffix() == "html") { + QFile file(fileName); + + if (file.open(QFile::ReadOnly)) { + editor->setHtml(QString(file.readAll())); + file.close(); + currentFile = fileName; + } + } else if (info.completeSuffix() == "txt") { + QFile file(fileName); + + if (file.open(QFile::ReadOnly)) { + editor->setPlainText(file.readAll()); + file.close(); + currentFile = fileName; + } + } + } +} + +void MainWindow::cutSelection() +{ + QTextCursor cursor = editor->textCursor(); + if (cursor.hasSelection()) { + selection = cursor.selection(); + cursor.removeSelectedText(); + } +} + +void MainWindow::copySelection() +{ + QTextCursor cursor = editor->textCursor(); + if (cursor.hasSelection()) { + selection = cursor.selection(); + cursor.clearSelection(); + } +} + +void MainWindow::pasteSelection() +{ + QTextCursor cursor = editor->textCursor(); + cursor.insertFragment(selection); +} + +void MainWindow::selectWord() +{ + QTextCursor cursor = editor->textCursor(); + QTextBlock block = cursor.block(); + +//! [0] + cursor.beginEditBlock(); +//! [1] + cursor.movePosition(QTextCursor::StartOfWord); + cursor.movePosition(QTextCursor::EndOfWord, QTextCursor::KeepAnchor); +//! [1] + cursor.endEditBlock(); +//! [0] + + editor->setTextCursor(cursor); +} + +void MainWindow::selectLine() +{ + QTextCursor cursor = editor->textCursor(); + QTextBlock block = cursor.block(); + + cursor.beginEditBlock(); + cursor.movePosition(QTextCursor::StartOfLine); + cursor.movePosition(QTextCursor::EndOfLine, QTextCursor::KeepAnchor); + cursor.endEditBlock(); + + editor->setTextCursor(cursor); +} + +void MainWindow::selectBlock() +{ + QTextCursor cursor = editor->textCursor(); + QTextBlock block = cursor.block(); + + cursor.beginEditBlock(); + cursor.movePosition(QTextCursor::StartOfBlock); + cursor.movePosition(QTextCursor::EndOfBlock, QTextCursor::KeepAnchor); + cursor.endEditBlock(); + + editor->setTextCursor(cursor); +} + +void MainWindow::selectFrame() +{ + QTextCursor cursor = editor->textCursor(); + QTextFrame *frame = cursor.currentFrame(); + + cursor.beginEditBlock(); + cursor.setPosition(frame->firstPosition()); + cursor.setPosition(frame->lastPosition(), QTextCursor::KeepAnchor); + cursor.endEditBlock(); + + editor->setTextCursor(cursor); +} + +void MainWindow::updateMenus() +{ + QTextCursor cursor = editor->textCursor(); + cutAction->setEnabled(cursor.hasSelection()); + copyAction->setEnabled(cursor.hasSelection()); + + pasteAction->setEnabled(!selection.isEmpty()); +} diff --git a/src/gui/doc/snippets/textdocument-selections/mainwindow.h b/src/gui/doc/snippets/textdocument-selections/mainwindow.h new file mode 100644 index 0000000..9e512f9 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-selections/mainwindow.h @@ -0,0 +1,79 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 +#include + +class QAction; +class QTextDocument; +class QTextEdit; + +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(); + +public slots: + void cutSelection(); + void copySelection(); + void openFile(); + void pasteSelection(); + void selectWord(); + void selectLine(); + void selectBlock(); + void selectFrame(); + void updateMenus(); + +private: + QAction *cutAction; + QAction *copyAction; + QAction *pasteAction; + QString currentFile; + QTextEdit *editor; + QTextDocument *document; + QTextDocumentFragment selection; +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-selections/textdocument-selections.pro b/src/gui/doc/snippets/textdocument-selections/textdocument-selections.pro new file mode 100644 index 0000000..253c452 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-selections/textdocument-selections.pro @@ -0,0 +1,4 @@ +QT += xml +HEADERS = mainwindow.h +SOURCES = main.cpp \ + mainwindow.cpp diff --git a/src/gui/doc/snippets/textdocument-tables/main.cpp b/src/gui/doc/snippets/textdocument-tables/main.cpp new file mode 100644 index 0000000..e3ba2ba --- /dev/null +++ b/src/gui/doc/snippets/textdocument-tables/main.cpp @@ -0,0 +1,52 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 = new MainWindow; + window->resize(480, 480); + window->show(); + return app.exec(); +} diff --git a/src/gui/doc/snippets/textdocument-tables/mainwindow.h b/src/gui/doc/snippets/textdocument-tables/mainwindow.h new file mode 100644 index 0000000..6a93293 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-tables/mainwindow.h @@ -0,0 +1,65 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 + +class QTextEdit; + +class MainWindow : public QMainWindow +{ + Q_OBJECT + +public: + MainWindow(); + +public slots: + void saveFile(); + void showTable(); + +private: + bool writeXml(const QString &fileName); + + QTextEdit *editor; +}; + +#endif diff --git a/src/gui/doc/snippets/textdocument-tables/textdocument-tables.pro b/src/gui/doc/snippets/textdocument-tables/textdocument-tables.pro new file mode 100644 index 0000000..91ae50f --- /dev/null +++ b/src/gui/doc/snippets/textdocument-tables/textdocument-tables.pro @@ -0,0 +1,6 @@ +SOURCES = main.cpp \ + mainwindow.cpp \ + xmlwriter.cpp +HEADERS = mainwindow.h \ + xmlwriter.h +QT += xml diff --git a/src/gui/doc/snippets/textdocument-tables/xmlwriter.cpp b/src/gui/doc/snippets/textdocument-tables/xmlwriter.cpp new file mode 100644 index 0000000..73d0f17 --- /dev/null +++ b/src/gui/doc/snippets/textdocument-tables/xmlwriter.cpp @@ -0,0 +1,155 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 "xmlwriter.h" + +QDomDocument *XmlWriter::toXml() +{ + QDomImplementation implementation; + QDomDocumentType docType = implementation.createDocumentType( + "scribe-document", "scribe", "qt.nokia.com/scribe"); + + document = new QDomDocument(docType); + + // ### This processing instruction is required to ensure that any kind + // of encoding is given when the document is written. + QDomProcessingInstruction process = document->createProcessingInstruction( + "xml", "version=\"1.0\" encoding=\"utf-8\""); + document->appendChild(process); + + QDomElement documentElement = document->createElement("document"); + document->appendChild(documentElement); + + QTextFrame *root = textDocument->rootFrame(); + + if (root) + processFrame(documentElement, root); + + return document; +} + +void XmlWriter::processBlock(QDomElement &parent, const QTextBlock &block) +{ + QDomElement blockElement = document->createElement("block"); + blockElement.setAttribute("position", block.position()); + blockElement.setAttribute("length", block.length()); + parent.appendChild(blockElement); + + QTextBlock::iterator it; + for (it = block.begin(); !(it.atEnd()); ++it) { + QTextFragment fragment = it.fragment(); + + if (fragment.isValid()) { + QDomElement fragmentElement = document->createElement("fragment"); + blockElement.appendChild(fragmentElement); + + fragmentElement.setAttribute("length", fragment.length()); + QDomText fragmentText = document->createTextNode(fragment.text()); + + fragmentElement.appendChild(fragmentText); + } + } +} + +void XmlWriter::processFrame(QDomElement &parent, QTextFrame *frame) +{ + QDomElement frameElement = document->createElement("frame"); + frameElement.setAttribute("begin", frame->firstPosition()); + frameElement.setAttribute("end", frame->lastPosition()); + parent.appendChild(frameElement); + +//! [0] + QDomElement frameElement = ... + + QTextFrame::iterator it; + for (it = frame->begin(); !(it.atEnd()); ++it) { + + QTextFrame *childFrame = it.currentFrame(); + QTextBlock childBlock = it.currentBlock(); + + if (childFrame) { + QTextTable *childTable = qobject_cast(childFrame); + + if (childTable) + processTable(frameElement, childTable); + else + processFrame(frameElement, childFrame); + + } else if (childBlock.isValid()) +//! [0] //! [1] + processBlock(frameElement, childBlock); + } +//! [1] +} + +void XmlWriter::processTable(QDomElement &parent, QTextTable *table) +{ + QDomElement element = document->createElement("table"); + + for (int row = 0; row < table->rows(); ++row) { + for (int column = 0; column < table->columns(); ++column) { + QTextTableCell cell = table->cellAt(row, column); + processTableCell(element, cell); + } + } + parent.appendChild(element); +} + +void XmlWriter::processTableCell(QDomElement &parent, const QTextTableCell &cell) +{ + QDomElement element = document->createElement("cell"); + element.setAttribute("row", cell.row()); + element.setAttribute("column", cell.column()); + + QTextFrame::iterator it; + for (it = cell.begin(); !(it.atEnd()); ++it) { + + QTextFrame *childFrame = it.currentFrame(); + QTextBlock childBlock = it.currentBlock(); + + if (childFrame) + processFrame(element, childFrame); + else if (childBlock.isValid()) + processBlock(element, childBlock); + } + parent.appendChild(element); +} diff --git a/src/gui/doc/snippets/textdocument-tables/xmlwriter.h b/src/gui/doc/snippets/textdocument-tables/xmlwriter.h new file mode 100644 index 0000000..33bd83d --- /dev/null +++ b/src/gui/doc/snippets/textdocument-tables/xmlwriter.h @@ -0,0 +1,64 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation 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 Digia Plc 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 XMLWRITER_H +#define XMLWRITER_H + +#include + +class QTextDocument; + +class XmlWriter +{ +public: + XmlWriter(QTextDocument *document) : textDocument(document) {} + QDomDocument *toXml(); + +private: + void processBlock(QDomElement &parent, const QTextBlock &block); + void processFrame(QDomElement &parent, QTextFrame *frame); + void processTable(QDomElement &parent, QTextTable *table); + void processTableCell(QDomElement &parent, const QTextTableCell &cell); + + QDomDocument *document; + QTextDocument *textDocument; +}; + +#endif diff --git a/src/gui/doc/src/richtext.qdoc b/src/gui/doc/src/richtext.qdoc new file mode 100644 index 0000000..b4ba4ba --- /dev/null +++ b/src/gui/doc/src/richtext.qdoc @@ -0,0 +1,1214 @@ +/**************************************************************************** +** +** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies). +** Contact: http://www.qt-project.org/legal +** +** This file is part of the documentation of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:FDL$ +** Commercial License Usage +** Licensees holding valid commercial Qt licenses may use this file in +** accordance with the commercial license agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. For licensing terms and +** conditions see http://qt.digia.com/licensing. For further information +** use the contact form at http://qt.digia.com/contact-us. +** +** GNU Free Documentation License Usage +** Alternatively, this file may be used under the terms of the GNU Free +** Documentation License version 1.3 as published by the Free Software +** Foundation and appearing in the file included in the packaging of +** this file. Please review the following information to ensure +** the GNU Free Documentation License version 1.3 requirements +** will be met: http://www.gnu.org/copyleft/fdl.html. +** $QT_END_LICENSE$ +** +****************************************************************************/ + +/*! + \group richtext-processing + \title Rich Text Processing APIs +*/ + +/*! + \page richtext.html + \title Rich Text Processing + \brief An overview of Qt's rich text processing, editing and display features. + + \ingroup frameworks-technologies + \ingroup qt-basic-concepts + \ingroup best-practices + + \nextpage Rich Text Document Structure + + The Scribe framework provides a set of classes for reading and manipulating + structured rich text documents. Unlike previous rich text support in Qt, the + new classes are centered around the QTextDocument class rather than raw + textual information. This enables the developer to create and modify + structured rich text documents without having to prepare content in an + intermediate markup format. + + The information within a document can be accessed via two complementary + interfaces: A cursor-based interface is used for editing, and a read-only + hierarchical interface provides a high level overview of the document + structure. The main advantage of the cursor-based interface is that the + text can be edited using operations that mimic a user's interaction with + an editor, without losing the underlying structure of the document. The + read-only hierarchical interface is most useful when performing operations + such as searching and document export. + + This document is divided up into chapters for convenient reference: + + \list + \li \l{Rich Text Document Structure} outlines + the different kinds of elements in a QTextDocument, and describes how + they are arranged in a document structure. + \li \l{The QTextCursor Interface} explains how rich + text documents can be edited using the cursor-based interface. + \li \l{Document Layouts} briefly explains the role of document layouts. + \li \l{Common Rich Text Editing Tasks} examines some + common tasks that involve reading or manipulating rich text documents. + \li \l{Advanced Rich Text Processing} examines advanced rich text editing tasks. + \li \l{Supported HTML Subset} lists the HTML tags supported by QTextDocument. + \endlist + + \section1 Rich Text Processing APIs + + Qt provides an extensive collection of classes for parsing, rendering + manipulating and editing rich text. + + \annotatedlist richtext-processing +*/ + +/*! + \page richtext-structure.html + \contentspage richtext.html Contents + \previouspage Rich Text Processing + \nextpage The QTextCursor Interface + + \title Rich Text Document Structure + + \tableofcontents + + Text documents are represented by the QTextDocument class, which + contains information about the document's internal representation, its + structure, and keeps track of modifications to provide undo/redo + facilities. + + The structured representation of a text document presents its contents as + a hierarchy of text blocks, frames, tables, and other objects. These provide + a logical structure to the document and describe how their contents will be + displayed. Generally, frames and tables are used to group other + structures while text blocks contain the actual textual information. + + New elements are created and inserted into the document programmatically + \l{richtext-cursor.html}{with a QTextCursor} or by using an editor + widget, such as QTextEdit. Elements can be given a particular format when + they are created; otherwise they take the cursor's current format for the + element. + + \table + \row + \li \inlineimage richtext-document.png + \li \b{Basic structure} + + The "top level" of a document might be populated in the way shown. + Each document always contains a root frame, and this always contains + at least one text block. + + For documents with some textual content, the root + frame usually contains a sequence of blocks and other elements. + + Sequences of frames and tables are always separated by text blocks in a + document, even if the text blocks contain no information. This ensures that + new elements can always be inserted between existing structures. + \endtable + + In this chapter, we look at each of the structural elements + used in a rich text document, outline their features and uses, and show + how to examine their contents. Document editing is described in + \l{richtext-cursor.html}{The QTextCursor Interface}. + + \section1 Rich Text Documents + + QTextDocument objects contain all the information required to construct + rich text documents. + Text documents can be accessed in two complementary ways: as a linear + buffer for editors to use, and as an object hierarchy that is useful to + layout engines. + In the hierarchical document model, objects generally correspond to + visual elements such as frames, tables, and lists. At a lower level, + these elements describe properties such as the text style and alignment. + The linear representation of the document is used for editing and + manipulation of the document's contents. + + Although QTextEdit makes it easy to display and edit rich text, documents + can also be used independently of any editor widget, for example: + + \snippet code/doc_src_richtext.cpp 0 + + Alternatively, they can be extracted from an existing editor: + + \snippet code/doc_src_richtext.cpp 1 + + This flexibility enables applications to handle multiple rich text + documents without the overhead of multiple editor widgets, or requiring + documents to be stored in some intermediate format. + + An empty document contains a root frame which itself contains a single + empty text block. Frames provide logical separation between parts of the document, but + also have properties that determine how they will appear when rendered. + A table is a specialized type of frame that consists of a number of + cells, arranged into rows and columns, each of which can contain + further structure and text. Tables provide management and layout + features that allow flexible configurations of cells to be created. + + Text blocks contain text fragments, each of which specifies text and + character format information. Textual properties are defined both at + the character level and at the block level. At the character level, + properties such as font family, text color, and font weight can be + specified. The block level properties control the higher level + appearance and behavior of the text, such as the direction of text + flow, alignment, and background color. + + The document structure is not manipulated directly. Editing is + performed through a cursor-based interface. + The \l{richtext-cursor.html}{text cursor interface} + automatically inserts new document elements into the root frame, and + ensures that it is padded with empty blocks where necessary. + + We obtain the root frame in the following manner: + + \snippet textdocument-frames/xmlwriter.h 0 + \snippet textdocument-frames/xmlwriter.cpp 0 + + When navigating the document structure, it is useful to begin at the + root frame because it provides access to the entire document structure. + + + \section1 Document Elements + + Rich text documents usually consist of common elements such as paragraphs, + frames, tables, and lists. These are represented in a QTextDocument + by the QTextBlock, QTextFrame, QTextTable, and QTextList classes. + Unlike the other elements in a document, images are represented by + specially formatted text fragments. This enables them to be placed + formatted inline with the surrounding text. + + The basic structural building blocks in documents are QTextBlock and + QTextFrame. Blocks themselves contain fragments of rich text + (QTextFragment), but these do not directly influence the high level + structure of a document. + + Elements which can group together other document elements are typically + subclasses of QTextObject, and fall into two categories: Elements that + group together text blocks are subclasses of QTextBlockGroup, and those + that group together frames and other elements are subclasses of QTextFrame. + + \section2 Text Blocks + + Text blocks are provided by the QTextBlock class. + + Text blocks group together fragments of text with different character formats, + and are used to represent paragraphs in the document. Each block + typically contains a number of text fragments with different styles. + Fragments are created when text is inserted into the document, and more + of them are added when the document is edited. The document splits, merges, + and removes fragments to efficiently represent the different styles + of text in the block. + + The fragments within a given block can be examined by using a + QTextBlock::iterator to traverse the block's internal structure: + + \snippet textblock-fragments/xmlwriter.cpp 3 + \snippet textblock-fragments/xmlwriter.cpp 5 + \snippet textblock-fragments/xmlwriter.cpp 6 + + Blocks are also used to represent list items. As a result, blocks can + define their own character formats which contain information about + block-level decoration, such as the type of bullet points used for + list items. The formatting for the block itself is described by the + QTextBlockFormat class, and describes properties such as text alignment, + indentation, and background color. + + Although a given document may contain complex structures, once we have a + reference to a valid block in the document, we can navigate between each + of the text blocks in the order in which they were written: + + \snippet textblock-fragments/xmlwriter.cpp 0 + \snippet textblock-fragments/xmlwriter.cpp 1 + \snippet textblock-fragments/xmlwriter.cpp 2 + + This method is useful for when you want to extract just the rich text from a + document because it ignores frames, tables, and other types of structure. + + QTextBlock provides comparison operators that make it easier to manipulate + blocks: \l{QTextBlock::operator==()}{operator==()} and + \l{QTextBlock::operator!=()}{operator!=()} are used to test whether two + blocks are the same, and \l{QTextBlock::operator<()}{operator<()} is used + to determine which one occurs first in a document. + + \section2 Frames + + Frames are provided by the QTextFrame class. + + Text frames group together blocks of text and child frames, creating + document structures that are larger than paragraphs. The format of a frame + specifies how it is rendered and positioned on the page. Frames are + either inserted into the text flow, or they float on the left or right + hand side of the page. + Each document contains a root frame that contains all the other document + elements. As a result, all frames except the root frame have a parent + frame. + + Since text blocks are used to separate other document elements, each + frame will always contain at least one text block, and zero or more + child frames. We can inspect the contents of a frame by using a + QTextFrame::iterator to traverse the frame's child elements: + + \snippet textdocument-frames/xmlwriter.cpp 1 + \snippet textdocument-frames/xmlwriter.cpp 2 + + Note that the iterator selects both frames and blocks, so it is necessary + to check which it is referring to. This allows us to navigate the document + structure on a frame-by-frame basis yet still access text blocks if + required. Both the QTextBlock::iterator and QTextFrame::iterator classes + can be used in complementary ways to extract the required structure from + a document. + + \section2 Tables + + Tables are provided by the QTextTable class. + + Tables are collections of cells that are arranged in rows and columns. + Each table cell is a document element with its own character format, but it + can also contain other elements, such as frames and text blocks. Table cells + are automatically created when the table is constructed, or when extra rows + or columns are added. They can also be moved between tables. + + QTextTable is a subclass of QTextFrame, so tables are treated like frames + in the document structure. For each frame that we encounter in the + document, we can test whether it represents a table, and deal with it in a + different way: + + \snippet textdocument-tables/xmlwriter.cpp 0 + \snippet textdocument-tables/xmlwriter.cpp 1 + + The cells within an existing table can be examined by iterating through + the rows and columns. + + \snippet textdocument-tables/mainwindow.cpp 9 + \snippet textdocument-tables/mainwindow.cpp 10 + \snippet textdocument-tables/mainwindow.cpp 11 + \snippet textdocument-tables/mainwindow.cpp 12 + + + \section2 Lists + + Lists are provided by the QTextList class. + + Lists are sequences of text blocks that are formatted in the usual way, but + which also provide the standard list decorations such as bullet points and + enumerated items. Lists can be nested, and will be indented if the list's + format specifies a non-zero indentation. + + We can refer to each list item by its index in the list: + + \snippet textdocument-listitems/mainwindow.cpp 0 + \snippet textdocument-listitems/mainwindow.cpp 1 + \snippet textdocument-listitems/mainwindow.cpp 2 + + Since QTextList is a subclass of QTextBlockGroup, it does not group the + list items as child elements, but instead provides various functions for + managing them. This means that any text block we find when traversing a + document may actually be a list item. We can ensure that list items are + correctly identified by using the following code: + + \snippet textdocument-listitems/mainwindow.cpp 3 + \snippet textdocument-listitems/mainwindow.cpp 4 + \snippet textdocument-listitems/mainwindow.cpp 5 + \snippet textdocument-listitems/mainwindow.cpp 6 + \snippet textdocument-listitems/mainwindow.cpp 7 + + + \section2 Images + + Images in QTextDocument are represented by text fragments that reference + external images via the resource mechanism. Images are created using the + cursor interface, and can be modified later by changing the character + format of the image's text fragment: + + \snippet textdocument-imageformat/main.cpp 0 + \snippet textdocument-imageformat/main.cpp 1 + \snippet textdocument-imageformat/main.cpp 2 + + The fragment that represents the image can be found by iterating over + the fragments in the text block that contains the image. +*/ + +/*! + \page richtext-cursor.html + \contentspage richtext.html Contents + \previouspage Rich Text Document Structure + \nextpage Document Layouts + + \title The QTextCursor Interface + + \tableofcontents + + Documents can be edited via the interface provided by the QTextCursor + class; cursors are either created using a constructor or obtained from + an editor widget. The cursor is used to perform editing operations that + correspond exactly to those the user is able to make themselves in an + editor. As a result, information about the document structure is also + available through the cursor, and this allows the structure to be + modified. The use of a cursor-oriented interface for editing makes the + process of writing a custom editor simpler for developers, since the + editing operations can be easily visualized. + + The QTextCursor class also maintains information about any text it + has selected in the document, again following a model that is + conceptually similar to the actions made by the user to select text + in an editor. + + Rich text documents can have multiple cursors + associated with them, and each of these contains information about their + position in the document and any selections that they may hold. This + cursor-based paradigm makes common operations, such as cutting and pasting + text, simple to implement programmatically, yet it also allows more complex + editing operations to be performed on the document. + + This chapter describes most of the common editing operations that you + will need to perform using a cursor, from basic insertion of text and + document elements to more complex manipulation of document structures. + + \section1 Cursor-Based Editing + + At the simplest level, text documents are made up of a string of characters, + marked up in some way to represent the block structure of the text within the + document. QTextCursor provides a cursor-based interface that allows the + contents of a QTextDocument to be manipulated at the character level. Since + the elements (blocks, frames, tables, etc.) are also encoded in the character + stream, the document structure can itself be changed by the cursor. + + The cursor keeps track of its location within its parent document, and can + report information about the surrounding structure, such as the enclosing + text block, frame, table, or list. The formats of the enclosing structures + can also be directly obtained through the cursor. + + \section2 Using a Cursor + + The main use of a cursor is to insert or modify text within a block. + We can use a text editor's cursor to do this: + + \snippet textblock-formats/main.cpp 0 + + Alternatively, we can obtain a cursor directly from a document: + + \snippet textdocument-images/main.cpp 0 + + The cursor is positioned at the start of the document so that we can write + into the first (empty) block in the document. + + \section2 Grouping Cursor Operations + + A series of editing operations can be packaged together so that they can + be replayed, or undone together in a single action. This is achieved by + using the \c beginEditBlock() and \c endEditBlock() functions in the + following way, as in the following example where we select the word that + contains the cursor: + + \snippet textdocument-selections/mainwindow.cpp 0 + + If editing operations are not grouped, the document automatically records + the individual operations so that they can be undone later. Grouping + operations into larger packages can make editing more efficient both for + the user and for the application, but care has to be taken not to group too + many operations together as the user may want find-grained control over the + undo process. + + \section2 Multiple Cursors + + Multiple cursors can be used to simultaneously edit the same document, + although only one will be visible to the user in a QTextEdit widget. + The QTextDocument ensures that each cursor writes text correctly and + does not interfere with any of the others. + + \omit + \snippet textdocument-cursors/main.cpp 0 + \snippet textdocument-cursors/main.cpp 1 + \endomit + + \section1 Inserting Document Elements + + QTextCursor provides several functions that can be used to change the + structure of a rich text document. Generally, these functions allow + document elements to be created with relevant formatting information, + and they are inserted into the document at the cursor's position. + + The first group of functions insert block-level elements, and update the + cursor position, but they do not return the element that was inserted: + + \list + \li \l{QTextCursor::insertBlock()}{insertBlock()} inserts a new text block + (paragraph) into a document at the cursor's position, and moves the + cursor to the start of the new block. + \li \l{QTextCursor::insertFragment()}{insertFragment()} inserts an existing + text fragment into a document at the cursor's position. + \li \l{QTextCursor::insertImage()}{insertImage()} inserts an image into a + document at the cursor's position. + \li \l{QTextCursor::insertText()}{insertText()} inserts text into the + document at the cursor's position. + \endlist + + You can examine the contents of the element that was inserted through the + cursor interface. + + The second group of functions insert elements that provide structure to + the document, and return the structure that was inserted: + + \list + \li \l{QTextCursor::insertFrame()}{insertFrame()} inserts a frame into the + document \e after the cursor's current block, and moves the cursor to + the start of the empty block in the new frame. + \li \l{QTextCursor::insertList()}{insertList()} inserts a list into the + document at the cursor's position, and moves the cursor to the start + of the first item in the list. + \li \l{QTextCursor::insertTable()}{insertTable()} inserts a table into + the document \e after the cursor's current block, and moves the cursor + to the start of the block following the table. + \endlist + + These elements either contain or group together other elements in the + document. + + \section2 Text and Text Fragments + + Text can be inserted into the current block in the current character + format, or in a custom format that is specified with the text: + + \snippet textdocument-charformats/main.cpp 0 + + Once the character format has been used with a cursor, that format becomes + the default format for any text inserted with that cursor until another + character format is specified. + + If a cursor is used to insert text without specifying a character format, + the text will be given the character format used at that position in the + document. + + \section2 Blocks + + Text blocks are inserted into the document with the + \l{QTextCursor::insertBlock()}{insertBlock()} function. + + \snippet textblock-formats/main.cpp 1 + + The cursor is positioned at the start of the new block. + + \section2 Frames + + Frames are inserted into a document using the cursor, and will be placed + within the cursor's current frame \e after the current block. + The following code shows how a frame can be inserted between two text + blocks in a document's root frame. We begin by finding the cursor's + current frame: + + \snippet textdocument-frames/mainwindow.cpp 0 + + We insert some text in this frame then set up a frame format for the + child frame: + + \snippet textdocument-frames/mainwindow.cpp 1 + + The frame format will give the frame an external margin of 32 pixels, + internal padding of 8 pixels, and a border that is 4 pixels wide. + See the QTextFrameFormat documentation for more information about + frame formats. + + The frame is inserted into the document after the preceding text: + + \snippet textdocument-frames/mainwindow.cpp 2 + + We add some text to the document immediately after we insert the frame. + Since the text cursor is positioned \e{inside the frame} when it is inserted + into the document, this text will also be inserted inside the frame. + + Finally, we position the cursor outside the frame by taking the last + available cursor position inside the frame we recorded earlier: + + \snippet textdocument-frames/mainwindow.cpp 3 + + The text that we add last is inserted after the child frame in the + document. Since each frame is padded with text blocks, this ensures that + more elements can always be inserted with a cursor. + + \section2 Tables + + Tables are inserted into the document using the cursor, and will be + placed within the cursor's current frame \e after the current block: + + \snippet textdocument-tables/mainwindow.cpp 0 + \snippet textdocument-tables/mainwindow.cpp 3 + + Tables can be created with a specific format that defines the overall + properties of the table, such as its alignment, background color, and + the cell spacing used. It can also determine the constraints on each + column, allowing each of them to have a fixed width, or resize according + to the available space. + + \snippet textdocument-tables/mainwindow.cpp 2 + + The columns in the table created above will each take up a certain + percentage of the available width. Note that the table format is + optional; if you insert a table without a format, some sensible + default values will be used for the table's properties. + + Since cells can contain other document elements, they too can be + formatted and styled as necessary. + + Text can be added to the table by navigating to each cell with the cursor + and inserting text. + + \snippet textdocument-tables/mainwindow.cpp 4 + + We can create a simple timetable by following this approach: + + \snippet textdocument-tables/mainwindow.cpp 5 + \snippet textdocument-tables/mainwindow.cpp 6 + \snippet textdocument-tables/mainwindow.cpp 7 + \snippet textdocument-tables/mainwindow.cpp 8 + + \section2 Lists + + Lists of block elements can be automatically created and inserted into the + document at the current cursor position. Each list that is created in this + way requires a list format to be specified: + + \snippet textdocument-lists/mainwindow.cpp 0 + + The above code first checks whether the cursor is within an existing list + and, if so, gives the list format for the new list a suitable level of + indentation. This allows nested lists to be created with increasing + levels of indentation. A more sophisticated implementation would also use + different kinds of symbol for the bullet points in each level of the list. + + \section2 Images + + Inline images are added to documents through the cursor in the usual manner. + Unlike many other elements, all of the image properties are specified by the + image's format. This means that a QTextImageFormat object has to be + created before an image can be inserted: + + \snippet textdocument-images/main.cpp 1 + + The image name refers to an entry in the application's resource file. + The method used to derive this name is described in + \l{resources.html}{The Qt Resource System}. + + \section1 Examples + + Rich text is stored in text documents that can either be created by + importing HTML from an external source, or generated using a QTextCursor. + + \section2 Manipulating Rich Text + + The easiest way to use a rich text document is through + the QTextEdit class, providing an editable view onto a document. The code + below imports HTML into a document, and displays the document using a + text edit widget. + + \snippet scribe-overview/main.cpp 1 + + You can retrieve the document from the text edit using the + document() function. The document can then be edited programmatically + using the QTextCursor class. This class is modeled after a screen + cursor, and editing operations follow the same semantics. The following + code changes the first line of the document to a bold font, leaving all + other font properties untouched. The editor will be automatically + updated to reflect the changes made to the underlying document data. + + \snippet scribe-overview/main.cpp 0 + + Note that the cursor was moved from the start of the first line to the + end, but that it retained an anchor at the start of the line. This + demonstrates the cursor-based selection facilities of the + QTextCursor class. + + \section2 Generating a Calendar + + Rich text can be generated very quickly using the cursor-based + approach. The following example shows a simple calendar in a + QTextEdit widget with bold headers for the days of the week: + + \snippet textdocument-blocks/mainwindow.cpp 0 + \codeline + \snippet textdocument-blocks/mainwindow.cpp 1 + \snippet textdocument-blocks/mainwindow.cpp 2 + \snippet textdocument-blocks/mainwindow.cpp 3 + + The above example demonstrates how simple it is to quickly generate new + rich text documents using a minimum amount of code. Although we have + generated a crude fixed-pitch calendar to avoid quoting too much code, + Scribe provides much more sophisticated layout and formatting features. +*/ + +/*! + \page richtext-layouts.html + \contentspage richtext.html Contents + \previouspage The QTextCursor Interface + \nextpage Common Rich Text Editing Tasks + + \title Document Layouts + + \tableofcontents + + The layout of a document is only relevant when it is to be displayed on + a device, or when some information is requested that requires a visual + representation of the document. Until this occurs, the document does + not need to be formatted and prepared for a device. + + \section1 Overview + + Each document's layout is managed by a subclass of the + QAbstractTextDocumentLayout class. This class provides a common + interface for layout and rendering engines. The default rendering + behavior is currently implemented in a private class. This approach + makes it possible to create custom layouts, and provides the + mechanism used when preparing pages for printing or exporting to + Portable Document Format (PDF) files. + + \section1 Example - Shaped Text Layout + + Sometimes it is important to be able to format plain text within an + irregularly-shaped region, perhaps when rendering a custom widget, for + example. Scribe provides generic features, such as those provided by + the QTextLayout class, to help developers perform word-wrapping and + layout tasks without the need to create a document first. + + \image plaintext-layout.png + + Formatting and drawing a paragraph of plain text is straightforward. + The example below will lay out a paragraph of text, using a single + font, around the right hand edge of a circle. + + \snippet plaintextlayout/window.cpp 0 + + We create a text layout, specifying the text string we want to display + and the font to use. We ensure that the text we supplied is formatted + correctly by obtaining text lines from the text format, and wrapping + the remaining text using the available space. The lines are positioned + as we move down the page. + + The formatted text can be drawn onto a paint device; in the above code, + the text is drawn directly onto a widget. + */ + + /*! + \page richtext-common-tasks.html + \contentspage richtext.html Contents + \previouspage Document Layouts + \nextpage Advanced Rich Text Processing + + \title Common Rich Text Editing Tasks + + \tableofcontents + + There are a number of tasks that are often performed by developers + when editing and processing text documents using Qt. These include the use + of display widgets such as QTextBrowser and QTextEdit, creation of + documents with QTextDocument, editing using a QTextCursor, and + exporting the document structure. + This document outlines some of the more common ways of using the rich + text classes to perform these tasks, showing convenient patterns that can + be reused in your own applications. + + \section1 Using QTextEdit + + A text editor widget can be constructed and used to display HTML in the + following way: + + \snippet code/doc_src_richtext.cpp 2 + + By default, the text editor contains a document with a root frame, inside + which is an empty text block. This document can be obtained so that it can + be modified directly by the application: + + \snippet code/doc_src_richtext.cpp 3 + + The text editor's cursor may also be used to edit a document: + + \snippet code/doc_src_richtext.cpp 4 + + Although a document can be edited using many cursors at once, a QTextEdit + only displays a single cursor at a time. Therefore, if we want to update the + editor to display a particular cursor or its selection, we need to set the + editor's cursor after we have modified the document: + + \snippet code/doc_src_richtext.cpp 5 + + \section1 Selecting Text + + Text is selected by moving the cursor using operations that are similar to + those performed by a user in a text editor. To select text between two + points in the document, we need to position the cursor at the first point + then move it using a special mode (\l{QTextCursor::MoveMode}) with a + move operation (\l{QTextCursor::MoveOperation}). + When we select the text, we leave the selection anchor at the old cursor + position just as the user might do by holding down the Shift key when + selecting text: + + \snippet textdocument-selections/mainwindow.cpp 1 + + In the above code, a whole word is selected using this method. QTextCursor + provides a number of common move operations for selecting individual + characters, words, lines, and whole blocks. + + \section1 Finding Text + + QTextDocument provides a cursor-based interface for searching, making + it easy to find and modify text in the style of a text editor. The following + code finds all the instances of a particular word in a document, and changes + the color of each: + + \snippet textdocument-find/main.cpp 0 + \snippet textdocument-find/main.cpp 1 + + Note that the cursor does not have to be moved after each search and replace + operation; it is always positioned at the end of the word that was just + replaced. + + \section1 Printing Documents + + QTextEdit is designed for the display of large rich text documents that are + read on screen, rendering them in the same way as a web browser. As a result, + it does not automatically break the contents of the document into page-sized + pieces that are suitable for printing. + + QTextDocument provides a \l{QTextDocument::print()}{print()} function to + allow documents to be printed using the QPrinter class. The following code + shows how to prepare a document in a QTextEdit for printing with a QPrinter: + + \snippet textdocument-printing/mainwindow.cpp 0 + + The document is obtained from the text editor, and a QPrinter is constructed + then configured using a QPrintDialog. If the user accepts the printer's + configuration then the document is formatted and printed using the + \l{QTextDocument::print()}{print()} function. +*/ + +/*! + \page richtext-advanced-processing.html + \contentspage richtext.html Contents + \previouspage Common Rich Text Editing Tasks + \nextpage Supported HTML Subset + + \title Advanced Rich Text Processing + + \section1 Handling Large Files + + Qt does not limit the size of files that are used for text + processing. In most cases, this will not present a problem. For + especially large files, however, you might experience that your + application will become unresponsive or that you will run out of + memory. The size of the files you can load depends on your + hardware and on Qt's and your own application's implementation. + + If you are faced with this problem, we recommend that you address the + following issues: + + \list + \li You should consider breaking up large paragraphs into smaller + ones as Qt handles small paragraphs better. You could also + insert line breaks at regular intervals, which will look the + same as one large paragraph in a QTextEdit. + \li You can reduce the amount of blocks in a QTextDocument with + \l{QTextDocument::}{maximumBlockCount()}. The document is only + as large as the number of blocks as far as QTextEdit is concerned. + \li When adding text to a text edit, it is an advantage to add it + in an edit block (see example below). The result is that the + text edit does not need to build the entire document structure at once. + \endlist + + We give an example of the latter technique from the list. We assume that + the text edit is visible. + + \snippet code/doc_src_richtext.cpp 6 + + \omit + Ideas for other sections: + + * Hiding QTextBlock elements. + * Changing the word wrapping mode in QTextEdit. Custom word wrapping? + \endomit +*/ + +/*! + \page richtext-html-subset.html + \title Supported HTML Subset + \brief Describes the support for HTML markup in text widgets. + + \contentspage richtext.html Contents + \previouspage Common Rich Text Editing Tasks + + Qt's text widgets are able to display rich text, specified using a subset of \l{HTML 4} + markup. Widgets that use QTextDocument, such as QLabel and QTextEdit, are able to display + rich text specified in this way. + + \tableofcontents + + \section1 Using HTML Markup in Text Widgets + + Widgets automatically detect HTML markup and display rich text accordingly. For example, + setting a label's \l{QLabel::}{text} property with the string \c{"Hello Qt!"} + will result in the label displaying text like this: \b{Hello} \e{Qt!} + + When HTML markup is used for text, Qt follows the rules defined by the \l{HTML 4} + specification. This includes default properties for text layout, such as the + direction of the text flow (left-to-right) which can be changed by applying the + \l{#Block Attributes}{\c dir} attribute to blocks of text. + + \section1 Supported Tags + + The following table lists the HTML tags supported by Qt's + \l{Rich Text Processing}{rich text} engine: + + \table + \header \li Tag + \li Description + \li Comment + \row \li \c a + \li Anchor or link + \li Supports the \c href and \c name attributes. + \row \li \c address + \li Address + \li + \row \li \c b + \li Bold + \li + \row \li \c big + \li Larger font + \li + \row \li \c blockquote + \li Indented paragraph + \li + \row \li \c body + \li Document body + \li Supports the \c bgcolor attribute, which + can be a Qt \l{QColor::setNamedColor()}{color name} + or a \c #RRGGBB color specification. + \row \li \c br + \li Line break + \li + \row \li \c center + \li Centered paragraph + \li + \row \li \c cite + \li Inline citation + \li Same as \c i. + \row \li \c code + \li Code + \li Same as \c tt. + \row \li \c dd + \li Definition data + \li + \row \li \c dfn + \li Definition + \li Same as \c i. + \row \li \c div + \li Document division + \li Supports the standard \l{block attributes}. + \row \li \c dl + \li Definition list + \li Supports the standard \l{block attributes}. + \row \li \c dt + \li Definition term + \li Supports the standard \l{block attributes}. + \row \li \c em + \li Emphasized + \li Same as \c i. + \row \li \c font + \li Font size, family, and/or color + \li Supports the following attributes: + \c size, \c face, and \c color (Qt + \l{QColor::setNamedColor()}{color names} or + \c #RRGGBB). + \row \li \c h1 + \li Level 1 heading + \li Supports the standard \l{block attributes}. + \row \li \c h2 + \li Level 2 heading + \li Supports the standard \l{block attributes}. + \row \li \c h3 + \li Level 3 heading + \li Supports the standard \l{block attributes}. + \row \li \c h4 + \li Level 4 heading + \li Supports the standard \l{block attributes}. + \row \li \c h5 + \li Level 5 heading + \li Supports the standard \l{block attributes}. + \row \li \c h6 + \li Level 6 heading + \li Supports the standard \l{block attributes}. + \row \li \c head + \li Document header + \li + \row \li \c hr + \li Horizontal line + \li Supports the \c width attribute, which can + be specified as an absolute or relative (\c %) value. + \row \li \c html + \li HTML document + \li + \row \li \c i + \li Italic + \li + \row \li \c img + \li Image + \li Supports the \c src, \c source + (for Qt 3 compatibility), \c width, and \c height + attributes. + \row \li \c kbd + \li User-entered text + \li + \row \li \c meta + \li Meta-information + \li If a text encoding is specified using the \c{meta} tag, + it is picked up by Qt::codecForHtml(). + Likewise, if an encoding is specified to + QTextDocument::toHtml(), the encoding is stored using + a \c meta tag, for example: + + \snippet code/doc_src_richtext.qdoc 7 + + \row \li \c li + \li List item + \li + \row \li \c nobr + \li Non-breakable text + \li + \row \li \c ol + \li Ordered list + \li Supports the standard \l{list attributes}. + \row \li \c p + \li Paragraph + \li Left-aligned by default. Supports the standard + \l{block attributes}. + \row \li \c pre + \li Preformated text + \li + \row \li \c qt + \li Qt rich-text document + \li Synonym for \c html. Provided for compatibility with + earlier versions of Qt. + \row \li \c s + \li Strikethrough + \li + \row \li \c samp + \li Sample code + \li Same as \c tt. + \row \li \c small + \li Small font + \li + \row \li \c span + \li Grouped elements + \li + \row \li \c strong + \li Strong + \li Same as \c b. + \row \li \c sub + \li Subscript + \li + \row \li \c sup + \li Superscript + \li + \row \li \c table + \li Table + \li Supports the following attributes: \c border, + \c bgcolor (Qt \l{QColor::setNamedColor()}{color names} + or \c #RRGGBB), \c cellspacing, \c cellpadding, + \c width (absolute or relative), and \c height. + \row \li \c tbody + \li Table body + \li Does nothing. + \row \li \c td + \li Table data cell + \li Supports the standard \l{table cell attributes}. + \row \li \c tfoot + \li Table footer + \li Does nothing. + \row \li \c th + \li Table header cell + \li Supports the standard \l{table cell attributes}. + \row \li \c thead + \li Table header + \li If the \c thead tag is specified, it is used when printing tables + that span multiple pages. + \row \li \c title + \li Document title + \li The value specified using the \c + title tag is available through + QTextDocument::metaInformation(). + \row \li \c tr + \li Table row + \li Supports the \c bgcolor attribute, which + can be a Qt \l{QColor::setNamedColor()}{color name} + or a \c #RRGGBB color specification. + \row \li \c tt + \li Typewrite font + \li + \row \li \c u + \li Underlined + \li + \row \li \c ul + \li Unordered list + \li Supports the standard \l{list attributes}. + \row \li \c var + \li Variable + \li Same as \c i. + \endtable + + \section1 Block Attributes + + The following attributes are supported by the \c div, \c dl, \c + dt, \c h1, \c h2, \c h3, \c h4, \c h5, \c h6, \c p tags: + + \list + \li \c align (\c left, \c right, \c center, \c justify) + \li \c dir (\c ltr, \c rtl) + \endlist + + \section1 List Attributes + + The following attribute is supported by the \c ol and \c ul tags: + + \list + \li \c type (\c 1, \c a, \c A, \c square, \c disc, \c circle) + \endlist + + \section1 Table Cell Attributes + + The following attributes are supported by the \c td and \c th + tags: + + \list + \li \c width (absolute, relative, or no-value) + \li \c bgcolor (Qt \l{QColor::setNamedColor()}{color names} or \c #RRGGBB) + \li \c colspan + \li \c rowspan + \li \c align (\c left, \c right, \c center, \c justify) + \li \c valign (\c top, \c middle, \c bottom) + \endlist + + \section1 CSS Properties + The following table lists the CSS properties supported by Qt's + \l{Rich Text Processing}{rich text} engine: + + \table + \header \li Property + \li Values + \li Description + \row + \li \c background-color + \li + \li Background color for elements + \row + \li \c background-image + \li + \li Background image for elements + \row \li \c color + \li + \li Text foreground color + \row \li \c font-family + \li + \li Font family name + \row \li \c font-size + \li [ small | medium | large | x-large | xx-large ] | pt | px + \li Font size relative to the document font, or specified in points or pixels + \row \li \c font-style + \li [ normal | italic | oblique ] + \li + \row \li \c font-weight + \li [ normal | bold | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 ] + \li Specifies the font weight used for text, where \c normal and \c bold + are mapped to the corresponding QFont weights. Numeric values are + 8 times the equivalent QFont weight values. + \row \li \c text-decoration + \li none | [ underline || overline || line-through ] + \li Additional text effects + \row \li \c font + \li [ [ <'font-style'> || <'font-weight'> ]? <'font-size'> <'font-family'> ] + \li Font shorthand property + \row \li \c text-indent + \li px + \li First line text indentation in pixels + \row \li \c white-space + \li normal | pre | nowrap | pre-wrap + \li Declares how whitespace in HTML is handled. + \row \li \c margin-top + \li px + \li Top paragraph margin in pixels + \row \li \c margin-bottom + \li px + \li Bottom paragraph margin in pixels + \row \li \c margin-left + \li px + \li Left paragraph margin in pixels + \row \li \c margin-right + \li px + \li Right paragraph margin in pixels + \row \li \c padding-top + \li px + \li Top table cell padding in pixels + \row \li \c padding-bottom + \li px + \li Bottom table cell padding in pixels + \row \li \c padding-left + \li px + \li Left table cell padding in pixels + \row \li \c padding-right + \li px + \li Right table cell padding in pixels + \row \li \c padding + \li px + \li Shorthand for setting all the padding properties at once. + \row \li \c vertical-align + \li baseline | sub | super | middle | top | bottom + \li Vertical text alignment. For vertical alignment in text table cells only middle, top, and bottom apply. + \row \li \c border-color + \li + \li Border color for text tables. + \row \li \c border-style + \li none | dotted | dashed | dot-dash | dot-dot-dash | solid | double | groove | ridge | inset | outset + \li Border style for text tables. + \row \li \c background + \li [ <'background-color'> || <'background-image'> ] + \li Background shorthand property + \row \li \c page-break-before + \li [ auto | always ] + \li Make it possible to enforce a page break before the paragraph/table + \row \li \c page-break-after + \li [ auto | always ] + \li Make it possible to enforce a page break after the paragraph/table + \row \li float + \li [ left | right | none ] + \li Specifies where an image or a text will be placed in another element. Note that the \c float property is + only supported for tables and images. + \row \li \c text-transform + \li [ uppercase | lowercase ] + \li Select the transformation that will be performed on the text prior to displaying it. + \row \li \c font-variant + \li small-caps + \li Perform the smallcaps transformation on the text prior to displaying it. + \row \li \c word-spacing + \li px + \li Specifies an alternate spacing between each word. + \endtable + + \section1 Supported CSS Selectors + + All CSS 2.1 selector classes are supported except pseudo-class selectors such + as \c{:first-child}, \c{:visited} and \c{:hover}. + +*/ -- 2.7.4